Partager via


ListViewItem.ImageIndex Propriété

Définition

Obtient ou définit l'index de l'image qui s'affiche pour l'élément.

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.NoneExcludedImageIndexConverter))]
public int ImageIndex { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))>]
member this.ImageIndex : int with get, set
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
member this.ImageIndex : int with get, set
Public Property ImageIndex As Integer

Valeur de propriété

Int32

Index de base zéro de l'image dans ImageList affiché pour l'élément. La valeur par défaut est -1.

Attributs

Exceptions

value est inférieur à -1.

Remarques

La valeur de cette propriété dépend de la valeur de la ImageList propriété. Selon la valeur actuelle de la View ListView propriété du contrôle associée à l’élément, l’élément ImageList utilisé peut être un spécifié dans la LargeImageList propriété ou la SmallImageList propriété du ListView contrôle. Si la View propriété est définie LargeIconsur , la ImageList propriété spécifiée dans la LargeImageList propriété est utilisée ; sinon, celle ImageList spécifiée dans la SmallImageList propriété est utilisée. Les images définies dans la ImageList propriété doivent SmallImageList avoir les mêmes positions d’index que celles de la ImageList LargeImageList propriété spécifiées. Si les positions d’index sont identiques pour les deux ImageList contrôles, vous pouvez définir une valeur d’index unique pour la ImageIndex propriété et l’image appropriée s’affiche quelle que soit la valeur de la View propriété du ListView contrôle.

ImageKey et ImageIndex sont mutuellement exclusifs, 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é, celle-ci ImageKey est automatiquement définie sur une chaîne vide («  »).

Si la valeur de la ImageList 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 valeur de ImageList.ImageCollection.Count 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 à la valeur de propriété Count . Par exemple, considérez un contrôle bouton dont ImageList trois images et dont ImageIndex la propriété est définie sur 2. Si une nouvelle ImageList image qui n’a que deux images est affectée au bouton, la ImageIndex valeur passe à 1.

S’applique à

Voir aussi