ListViewItem.StateImageIndex Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

ListViewItem.cs

Obtient ou définit l’index de l’image d’état (image telle qu’une case à cocher sélectionnée ou désactivée qui indique l’état de l’élément) affichée pour l’élément.

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

[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.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 dans l’élément ImageList affiché.

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 ImageListStateImageList 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 .

Note

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