ButtonBase.ImageList Propriété

Définition

Obtient ou définit le ImageList qui contient le Image affiché sur un contrôle bouton.Gets or sets the ImageList that contains the Image displayed on a button control.

public:
 property System::Windows::Forms::ImageList ^ ImageList { System::Windows::Forms::ImageList ^ get(); void set(System::Windows::Forms::ImageList ^ value); };
public System.Windows.Forms.ImageList ImageList { get; set; }
member this.ImageList : System.Windows.Forms.ImageList with get, set
Public Property ImageList As ImageList

Valeur de propriété

ImageList

Élément ImageList.An ImageList. La valeur par défaut est null.The default value is null.

Exemples

L’exemple de code suivant utilise la classe dérivée Button et définit ImageList les ImageIndex Propriétés et.The following code example uses the derived class, Button and sets the ImageList and ImageIndex properties. Ce code requiert qu’un ImageList ait été créé et au moins un des deux Image a été assigné.This code requires that an ImageList has been created and a minimum of one Image has been assigned to it. Ce code requiert également que vous disposiez d’une image bitmap nommée MyBitMap.bmp stockée dans le C:\Graphics répertoire.This code also requires that you have a bitmap image named MyBitMap.bmp stored in the C:\Graphics directory.

private:
   void AddMyImage()
   {
      // Assign an image to the imageList.
      imageList1->Images->Add( Image::FromFile( "C:\\Graphics\\MyBitmap.bmp" ) );
      // Assign the imageList to the button control.
      button1->ImageList = imageList1;
      // Select the image from the ImageList (using the ImageIndex property).
      button1->ImageIndex = 0;
   }
private void AddMyImage()
 {
    // Assign an image to the ImageList.
    ImageList1.Images.Add(Image.FromFile("C:\\Graphics\\MyBitmap.bmp"));
    // Assign the ImageList to the button control.   
    button1.ImageList = ImageList1;
    // Select the image from the ImageList (using the ImageIndex property).    
    button1.ImageIndex = 0;
 }
 
Private Sub AddMyImage()
    ' Assign an image to the ImageList.
    ImageList1.Images.Add(Image.FromFile("C:\Graphics\MyBitmap.bmp"))
    ' Assign the ImageList to the button control.   
    button1.ImageList = ImageList1
    ' Select the image from the ImageList (using the ImageIndex property).    
    button1.ImageIndex = 0
End Sub

Remarques

Lorsque la ImageList ImageIndex propriété ou est définie, la Image propriété est définie null , qui est sa valeur par défaut.When the ImageList or ImageIndex property is set, the Image property is set null, which is its default value.

Notes

Si la ImageList valeur de la propriété est remplacée par null , la ImageIndex propriété retourne sa valeur par défaut,-1.If the ImageList property value is changed to null, the ImageIndex property returns its default value, -1. Toutefois, la valeur assignée ImageIndex est conservée en interne et utilisée quand une autre ImageList est assignée à la ImageList propriété.However, the assigned ImageIndex value is retained internally and used when another ImageList is assigned to the ImageList property. Si la nouvelle propriété ImageList assignée à la ImageList propriété a une ImageList.ImageCollection.Count valeur de propriété inférieure ou égale à la valeur assignée à la ImageIndex propriété moins un (car la collection est un index de base zéro), la valeur de la ImageIndex propriété est ajustée à une valeur inférieure à la valeur de la Count propriété.If the new ImageList assigned to the ImageList property has an ImageList.ImageCollection.Count property value that is less than or equal to the value assigned to the ImageIndex property minus one (because the collection is a zero-based index), the ImageIndex property value is adjusted to one less than the Count property value. Par exemple, considérez un contrôle Button dont ImageList les ont trois images et dont la ImageIndex propriété a la valeur 2.For example, consider a button control whose ImageList has three images and whose ImageIndex property is set to 2. Si une nouvelle ImageList qui n’a que deux images est assignée au bouton, la ImageIndex valeur est remplacée par 1.If a new ImageList that has only two images is assigned to the button, the ImageIndex value changes to 1.

S’applique à

Voir aussi