ListViewItem.StateImageIndex-Eigenschaft

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.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Property StateImageIndex As Integer
'Usage
Dim instance As ListViewItem
Dim value As Integer

value = instance.StateImageIndex

instance.StateImageIndex = value

[LocalizableAttribute(true)] 
public int StateImageIndex { get; set; }

[LocalizableAttribute(true)] 
public:
property int StateImageIndex {
    int get ();
    void set (int value);
}

/** @property */
public int get_StateImageIndex ()

/** @property */
public void set_StateImageIndex (int value)

public function get StateImageIndex () : int

public function set StateImageIndex (value : int)

Eigenschaftenwert

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

Ausnahmen

Ausnahmetyp	Bedingung
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

Mithilfe dieser Eigenschaft können Sie den Index in der ImageList festlegen, die der StateImageList-Eigenschaft des zugeordneten ListView-Steuerelements zugewiesen ist, an dem die links vom Element anzuzeigenden Zustandsgrafiken gespeichert werden sollen. Die Zustandsgrafik ist normalerweise ein aktiviertes bzw. deaktiviertes Kontrollkästchen oder ein Bild, das den aktivierten bzw. deaktivierten Zustand eines Elements darstellen soll. Wenn für die StateImageList-Eigenschaft kein Wert angegeben ist, zeigt das ListView-Steuerelement in der Standardeinstellung ein aktiviertes bzw. deaktiviertes Kontrollkästchen an, sofern die CheckBoxes-Eigenschaft des Steuerelements auf true festgelegt ist.

Hinweis

Obwohl die in der StateImageList-Eigenschaft angegebene ImageList eine beliebige Anzahl von Bildern enthalten kann und die StateImageIndex-Eigenschaft auf einen beliebigen Wert kleiner oder gleich 14 festgelegt werden kann, werden lediglich die Bilder an der Indexposition 0 und 1 als Zustandsgrafiken angezeigt.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ListViewItem-Klasse
ListViewItem-Member
System.Windows.Forms-Namespace
ListView.StateImageList-Eigenschaft