Практическое руководство. Добавление или удаление изображений с помощью компонента ImageList в Windows Forms

Компонент Windows Forms ImageList обычно заполняется изображениями, прежде чем он связан с элементом управления. Однако можно добавлять и удалять изображения после связывания списка изображений с элементом управления.

Замечание

При удалении изображений убедитесь, что ImageIndex свойство любых связанных элементов управления по-прежнему допустимо.

Добавление изображений программным способом

  • Add Используйте метод свойства списка Images изображений.

    В следующем примере кода путь, заданный для расположения изображения, — это папка "Мои документы". Это расположение используется, так как можно предположить, что большинство компьютеров под управлением операционной системы Windows будут включать эту папку. Выбор этого расположения также позволяет пользователям с минимальным уровнем доступа к системе безопасно запускать приложение. В следующем примере кода требуется, чтобы у вас была форма с уже добавленным элементом ImageList управления.

    Public Sub LoadImage()
       Dim myImage As System.Drawing.Image = _
         Image.FromFile _
       (System.Environment.GetFolderPath _
       (System.Environment.SpecialFolder.Personal) _
       & "\Image.gif")
       ImageList1.Images.Add(myImage)
    End Sub
    
    public void addImage()
    {
    // Be sure that you use an appropriate escape sequence (such as the
    // @) when specifying the location of the file.
       System.Drawing.Image myImage =
         Image.FromFile
       (System.Environment.GetFolderPath
       (System.Environment.SpecialFolder.Personal)
       + @"\Image.gif");
       imageList1.Images.Add(myImage);
    }
    
    public:
       void addImage()
       {
       // Replace the bold image in the following sample
       // with your own icon.
       // Be sure that you use an appropriate escape sequence (such as
       // \\) when specifying the location of the file.
          System::Drawing::Image ^ myImage =
             Image::FromFile(String::Concat(
             System::Environment::GetFolderPath(
             System::Environment::SpecialFolder::Personal),
             "\\Image.gif"));
          imageList1->Images->Add(myImage);
       }
    

Добавление изображений со значением ключа.

  • Используйте один из Add методов свойства списка Images изображений, которое принимает ключевое значение.

    В следующем примере кода путь, заданный для расположения изображения, — это папка "Мои документы". Это расположение используется, так как можно предположить, что большинство компьютеров под управлением операционной системы Windows будут включать эту папку. Выбор этого расположения также позволяет пользователям с минимальным уровнем доступа к системе безопасно запускать приложение. В следующем примере кода требуется, чтобы у вас была форма с уже добавленным элементом ImageList управления.

    Public Sub LoadImage()
       Dim myImage As System.Drawing.Image = _
         Image.FromFile _
       (System.Environment.GetFolderPath _
       (System.Environment.SpecialFolder.Personal) _
       & "\Image.gif")
       ImageList1.Images.Add("myPhoto", myImage)
    End Sub
    
public void addImage()
{
// Be sure that you use an appropriate escape sequence (such as the
// @) when specifying the location of the file.
   System.Drawing.Image myImage =
     Image.FromFile
   (System.Environment.GetFolderPath
   (System.Environment.SpecialFolder.Personal)
   + @"\Image.gif");
   imageList1.Images.Add("myPhoto", myImage);
}

Удаление всех образов программным способом

  • Используйте метод Remove для удаления изображения.

    -или-

    Clear Используйте метод для очистки всех изображений в списке изображений.

    ' Removes the first image in the image list
    ImageList1.Images.Remove(myImage)
    ' Clears all images in the image list
    ImageList1.Images.Clear()
    
// Removes the first image in the image list.
imageList1.Images.Remove(myImage);
// Clears all images in the image list.
imageList1.Images.Clear();

Удаление изображений по ключу

  • Используйте метод RemoveByKey для удаления одного изображения по его ключу.

    ' Removes the image named "myPhoto" from the list.
    ImageList1.Images.RemoveByKey("myPhoto")
    
// Removes the image named "myPhoto" from the list.
imageList1.Images.RemoveByKey("myPhoto");

См. также