ColumnHeader.ImageIndex Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft den Index des im ColumnHeader angezeigten Bilds ab oder legt diesen fest.

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

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

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

Public Property ImageIndex As Integer

Eigenschaftswert

Int32

Der Index des im ColumnHeader angezeigten Bilds.

Attribute

TypeConverterAttribute

Ausnahmen

ArgumentOutOfRangeException

value ist kleiner als -1.

Hinweise

Die ImageIndex -Eigenschaft verweist auf den Index eines Bilds, das durch die SmallImageList -Eigenschaft des angegeben wird, das ListView den ColumnHeaderenthält. Die ImageIndex -Eigenschaft gibt -1 zurück, wenn kein SmallImageList Satz für enthält ListView. Das in einer Spalte angezeigte Bild wird in der Regel verwendet, um den Zustand der Elemente in der Spalte anzugeben.

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 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 der Eigenschaft zugewiesene ImageList neue ImageList Eigenschaft einen ImageList.ImageCollection.Count Eigenschaftswert aufweist, der kleiner oder gleich dem der ImageIndex Eigenschaft minus 1 zugewiesenen Wert 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 Bild mit nur zwei Bildern zugewiesen ist, ändert sich der ImageIndex Wert in 1.