ColumnHeader.ImageIndex Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen des Index des Bilds, das in der ColumnHeader.
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, setPublic Property ImageIndex As IntegerEigenschaftswert
Der Index des Bilds, das in der ColumnHeader.
- Attribute
Ausnahmen
value ist kleiner als -1.
Hinweise
Die ImageIndex Eigenschaft bezieht sich auf den Index eines Bilds, das durch die SmallImageList Eigenschaft der ListView enthält.ColumnHeader Die ImageIndex Eigenschaft gibt -1 zurück, wenn der enthaltende ListViewWert nicht SmallImageList festgelegt ist. Das in einer Spalte angezeigte Bild wird in der Regel verwendet, um den Status von Elementen in der Spalte anzugeben.
ImageKey und ImageIndex schließen sich gegenseitig aus, d. h. wenn ein Wert 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. Wenn Sie die ImageIndex Eigenschaft festlegen, wird die ImageKey Eigenschaft auch automatisch auf eine leere Zeichenfolge ("") festgelegt.
Wenn der ImageList Eigenschaftswert geändert nullwird, 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 Wert ist, der der Eigenschaft minus 1 zugewiesen ImageIndex ist (um die Auflistung als nullbasierten Index zu berücksichtigen), wird der ImageIndex Eigenschaftswert auf einen Wert angepasst, der kleiner als der Count Eigenschaftswert ist.
Betrachten Sie z. B. ein Schaltflächensteuerelement, dessen ImageList Eigenschaft drei Bilder aufweist und deren ImageIndex Eigenschaft auf 2 festgelegt ist. Wenn der Schaltfläche nur zwei ImageList Bilder zugewiesen sind, ändert sich der ImageIndex Wert in 1.
