ColumnHeader.ImageIndex Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

ColumnHeader.cs

Obtient ou définit l’index de l’image affichée dans le ColumnHeader.

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 l’image affichée dans le ColumnHeader.

Attributs

TypeConverterAttribute

Exceptions

ArgumentOutOfRangeException

value est inférieur à -1.

Remarques

La ImageIndex propriété fait référence à l’index d’une image spécifiée par la SmallImageList propriété du ListView fichier qui contient le ColumnHeader. La ImageIndex propriété retourne -1 s’il n’existe aucun SmallImageList jeu sur le conteneur ListView. L’image affichée dans une colonne est généralement utilisée pour indiquer l’état des éléments de la colonne.

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é, la ImageKey valeur est automatiquement définie sur une chaîne vide («  »).

Si la ImageList valeur de la propriété est modifiée 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 la nouvelle ImageList propriété affectée à 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 une (pour tenir compte de la collection étant un index de base zéro), la ImageIndex valeur de la propriété est ajustée à une valeur inférieure à celle de la Count propriété. Par exemple, considérez un contrôle bouton dont trois ImageList images sont définies et dont ImageIndex la propriété est définie sur 2. Si une nouvelle ImageList image n’a que deux images sont affectées au bouton, la ImageIndex valeur passe à 1.