ListViewItem.ImageIndex-Eigenschaft

Artikel
08/20/2007

Ruft den Index des Bilds ab, das 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 ImageIndex As Integer
'Usage
Dim instance As ListViewItem
Dim value As Integer

value = instance.ImageIndex

instance.ImageIndex = value

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

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

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

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

public function get ImageIndex () : int

public function set ImageIndex (value : int)

Eigenschaftenwert

Der nullbasierte Index des Bilds in der ImageList, der für das Element angezeigt wird. Der Standardwert ist -1.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Der angegebene Wert ist kleiner als -1.

Hinweise

Der Wert dieser Eigenschaft hängt vom Wert der ImageList-Eigenschaft ab. Je nach dem aktuellen Wert der View-Eigenschaft des ListView-Steuerelements, das dem Element zugeordnet ist, ist die vom Element verwendete ImageList in der LargeImageList-Eigenschaft oder in der SmallImageList-Eigenschaft des ListView-Steuerelements angegeben. Wenn die View-Eigenschaft auf LargeIcon festgelegt ist, wird die in der LargeImageList-Eigenschaft angegebene ImageList verwendet, andernfalls wird die in der SmallImageList-Eigenschaft angegebene ImageList verwendet. Die Bilder, die in der in der SmallImageList angegebenenImageList definiert sind, müssen dieselben Indexpositionen aufweisen wie die Bilder, die in der ImageList der LargeImageList-Eigenschaft angegeben sind. Wenn die Indexpositionen beider ImageList-Steuerelemente übereinstimmen, können Sie einen einzigen Indexwert für die ImageIndex-Eigenschaft festlegen, wird das richtige Bild unabhängig vom Wert der View-Eigenschaft des ListView-Steuerelements angezeigt. Die ImageKey-Eigenschaft und die ImageIndex-Eigenschaft schließen einander aus, d. h., wenn eine Eigenschaft festgelegt ist, wird die andere ignoriert. Wenn Sie die ImageKey-Eigenschaft festlegen, wird die ImageIndex-Eigenschaft automatisch auf -1 festgelegt. Sie können auch die ImageIndex-Eigenschaft festlegen, wodurch ImageKey automatisch auf eine leere Zeichenfolge ("") festgelegt wird.

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

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

ListViewItem-Klasse
ListViewItem-Member
System.Windows.Forms-Namespace
ListView.View-Eigenschaft
ListView.SmallImageList-Eigenschaft
ListView.LargeImageList-Eigenschaft

Freigeben über