ListViewItem.StateImageIndex Eigenschaft
Definition
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, setPublic Property StateImageIndex As IntegerEigenschaftswert
Der nullbasierte Index der Zustandsgrafik in der ImageList, der für das Element angezeigt wird.
- Attribute
Ausnahmen
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.
