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

Статья
11/05/2008

Обновлен: Ноябрь 2007

Компонент 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
```

Чтобы удалить все изображения с помощью программных средств

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

-либо-

Используйте метод 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")
```

См. также

Ссылки

Общие сведения о компоненте ImageList (Windows Forms)

Другие ресурсы

Компонент ImageList (Windows Forms)

Работа с растровыми и векторными изображениями с использованием классов Image, Bitmap и Metafile

Поделиться через