ButtonBase.ImageIndex Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit la valeur d'index de liste de l'image affichée sur le contrôle bouton.

public:
 property int ImageIndex { int get(); void set(int value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int ImageIndex { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))>]
member this.ImageIndex : int with get, set

Public Property ImageIndex As Integer

Valeur de propriété

Int32

Index de base zéro représentant la position de l'image dans ImageList. La valeur par défaut est -1.

Attributs

TypeConverterAttribute

Exceptions

ArgumentOutOfRangeException

value est inférieur à -1.

Exemples

L’exemple de code suivant utilise la classe Button dérivée et définit les ImageList propriétés et ImageIndex . Ce code nécessite qu’un ImageList ait été créé et qu’un minimum d’un Image lui ait été affecté. Ce code nécessite également qu’une image bitmap nommée MyBitMap.bmp soit stockée dans le C:\Graphics répertoire.

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 les ImageIndex propriétés ou ImageList sont définies, la Image propriété est définie sur sa valeur par défaut, null.

ImageKey et ImageIndex s’excluent mutuellement, ce qui signifie que si l’un est défini, l’autre est défini sur une valeur non valide et ignoré. Si vous définissez la ImageKey propriété, la ImageIndex propriété est automatiquement définie sur -1. Sinon, si vous définissez la ImageIndex propriété, le ImageKey est automatiquement défini sur une chaîne vide («  »).

Si la valeur de la ImageList propriété est remplacée par null, la ImageIndex propriété retourne sa valeur par défaut, -1. Toutefois, la valeur affectée ImageIndex est conservée en interne et utilisée lorsqu’un autre ImageList objet est affecté à la ImageList propriété . Si le nouveau ImageList affecté à la ImageList propriété a une ImageList.ImageCollection.Count valeur de propriété inférieure ou égale à la valeur affectée à la ImageIndex propriété moins un (pour tenir compte de la collection étant un index de base zéro), la valeur de la ImageIndex propriété est ajustée à un de moins que la valeur de la Count propriété. Prenons l’exemple d’un contrôle de bouton dont ImageList la propriété a trois images et dont ImageIndex la propriété a la valeur 2. Si un nouveau ImageList qui n’a que deux images est affecté au bouton, la ImageIndex valeur passe à 1.

Voir aussi

• ImageList