ListViewItem.ImageIndex Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft den Index des Bilds ab, das für das Element angezeigt wird, oder legt diesen fest.

public:
 property int ImageIndex { int get(); void set(int value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))]
public int ImageIndex { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
member this.ImageIndex : int with get, set

Public Property ImageIndex As Integer

Eigenschaftswert

Int32

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

Attribute

TypeConverterAttribute

Ausnahmen

ArgumentOutOfRangeException

value ist kleiner als -1.

Hinweise

Der Wert dieser Eigenschaft hängt vom Wert der ImageList Eigenschaft ab. Abhängig vom aktuellen Wert der View -Eigenschaft des Steuerelements, das ListView dem Element zugeordnet ist, kann der ImageList vom Element verwendete in der LargeImageList -Eigenschaft oder der SmallImageList -Eigenschaft des Steuerelements ListView angegebene sein. Wenn die View -Eigenschaft auf LargeIconfestgelegt ist, wird die ImageList in der LargeImageList -Eigenschaft angegebene verwendet, andernfalls wird der ImageList in der SmallImageList -Eigenschaft angegebene verwendet. Die in der ImageList - SmallImageList Eigenschaft definierten Bilder sollten die gleichen Indexpositionen wie die Bilder in der ImageList in der LargeImageList -Eigenschaft angegebenen haben. Wenn die Indexpositionen für beide ImageList Steuerelemente identisch sind, können Sie einen einzelnen Indexwert für die ImageIndex Eigenschaft festlegen, und das entsprechende Bild wird unabhängig vom Wert der View -Eigenschaft des ListView Steuerelements angezeigt.

ImageKey und ImageIndex schließen sich gegenseitig aus, d. h., wenn eine festgelegt ist, wird der andere auf einen ungültigen Wert festgelegt und ignoriert. Wenn Sie die ImageKey -Eigenschaft festlegen, wird die ImageIndex -Eigenschaft automatisch auf -1 festgelegt. Alternativ wird beim Festlegen der ImageIndex -Eigenschaft ImageKey automatisch auf eine leere Zeichenfolge ("") festgelegt.

Wenn der ImageList Eigenschaftswert in nullgeändert wird, gibt die ImageIndex Eigenschaft den Standardwert -1 zurück. Der zugewiesene ImageIndex Wert wird jedoch intern beibehalten und verwendet, wenn der ImageList -Eigenschaft ein anderes ImageList Objekt zugewiesen wird. Wenn die neue ImageList der ImageList Eigenschaft zugewiesene Eigenschaft einen ImageList.ImageCollection.Count Eigenschaftswert aufweist, der kleiner oder gleich dem der ImageIndex Eigenschaft zugewiesenen Wert minus 1 ist (um zu berücksichtigen, dass die Auflistung ein nullbasierter Index ist), wird der ImageIndex Eigenschaftswert auf eins kleiner als der Count Eigenschaftswert angepasst. Betrachten Sie beispielsweise ein Schaltflächensteuerelement, dessen ImageList drei Bilder aufweist und dessen ImageIndex Eigenschaft auf 2 festgelegt ist. Wenn der Schaltfläche ein neues ImageList mit nur zwei Bildern zugewiesen wird, ändert sich der ImageIndex Wert in 1.

Weitere Informationen

• View
• SmallImageList
• LargeImageList