ListViewItem.StateImageIndex Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Index der Zustandsgrafik (ein Bild, z. B. ein aktiviertes oder deaktiviertes Kontrollkästchen, das den Zustand eines Elements darstellt) ab, die für das Element angezeigt wird, oder legt diesen fest.

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

Eigenschaftswert

Int32

Der nullbasierte Index der Zustandsgrafik in der ImageList, der für das Element angezeigt wird.

Attribute: TypeConverterAttribute RelatedImageListAttribute

Ausnahmen

ArgumentOutOfRangeException

Der für diese Eigenschaft angegebene Wert ist kleiner als -1.

- oder -

Der für diese Eigenschaft angegebene Wert ist größer als 14.

Hinweise

Mit dieser Eigenschaft können Sie den Index in der ImageList der -Eigenschaft des zugeordneten ListView Steuerelements zugewiesenen StateImageList angeben, in der die statusbilder gespeichert werden, die links neben dem Element angezeigt werden. In der Regel ist das Zustandsbild ein ausgewähltes oder deaktiviertes Kontrollkästchen oder ein Bild, das ausgewählte oder gelöschte Zustände für das Element darstellen soll. Wenn für die StateImageList -Eigenschaft kein Wert angegeben ist, zeigt das ListView Steuerelement ein standardmäßig ausgewähltes oder deaktiviertes Kontrollkästchen an, wenn die CheckBoxes -Eigenschaft des Steuerelements auf truefestgelegt ist.

Hinweis

Obwohl das ImageList in der StateImageList -Eigenschaft angegebene eine beliebige Anzahl von Bildern enthalten kann und die StateImageIndex Eigenschaft auf einen beliebigen Wert gleich oder niedriger als 14 festgelegt werden kann, werden nur die Bilder an den Indexpositionen 0 und 1 als Zustandsbilder angezeigt.

Gilt für:

Weitere Informationen

StateImageList