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

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

Note

При удалении образов, убедитесь, что 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");