ColumnHeader.ImageIndex Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit l'index de l'image affichée dans 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, setPublic Property ImageIndex As IntegerValeur de propriété
Index de l'image affichée dans ColumnHeader.
- Attributs
Exceptions
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é de qui ListView contient le ColumnHeader. La ImageIndex propriété retourne -1 si aucun paramètre n’est SmallImageList défini sur le contenant ListView. L’image affichée dans une colonne est généralement utilisée pour indiquer l’état des éléments dans 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. Si vous définissez la propriété, ImageKey le ImageIndex est automatiquement défini sur une chaîne vide (« »).
Si la valeur de la ImageList propriété est modifiée en 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 attribuée à la ImageIndex propriété moins un (pour tenir compte du fait que 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é.
Par exemple, considérez un contrôle 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.
