ListViewItem.StateImageIndex Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit l'index de l'image d'état (par exemple, l'image d'une case à cocher activée ou désactivée indiquant l'état de l'élément) qui s'affiche avec l'élément.

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

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

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))]
[System.Windows.Forms.RelatedImageList("ListView.StateImageList")]
public int StateImageIndex { get; set; }

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

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
[<System.Windows.Forms.RelatedImageList("ListView.StateImageList")>]
member this.StateImageIndex : int with get, set

Public Property StateImageIndex As Integer

Valeur de propriété

Int32

Index de base zéro de l'image d'état du ImageList qui s'affiche pour l'élément.

Attributs

TypeConverterAttribute RelatedImageListAttribute

Exceptions

ArgumentOutOfRangeException

La valeur spécifiée pour cette propriété est inférieure à -1.

• ou -

La valeur spécifiée pour cette propriété est supérieure à 14.

Remarques

Cette propriété vous permet de spécifier l’index dans la ImageList StateImageList propriété affectée au contrôle associé ListView , où les images d’état à afficher à gauche de l’élément sont stockées. En règle générale, l’image d’état est une case à cocher sélectionnée ou désactivée ou une image destinée à représenter les états sélectionnés ou effacés de l’élément. Si aucune valeur n’est spécifiée pour la StateImageList propriété, le ListView contrôle affiche une case à cocher activée ou désactivée par défaut lorsque la CheckBoxes propriété du contrôle est définie truesur .

Notes

Bien que la ImageList propriété spécifiée StateImageList puisse contenir n’importe quel nombre d’images et que la StateImageIndex propriété peut être définie sur n’importe quelle valeur égale ou inférieure à 14, seules les images aux positions d’index 0 et 1 sont affichées en tant qu’images d’état.

Voir aussi

• StateImageList