Freigeben über


ColumnHeader.ImageIndex Eigenschaft

Definition

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

Der Index des im ColumnHeader angezeigten Bilds.

Attribute

Ausnahmen

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.

Gilt für: