ColumnHeader.ImageIndex Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

ColumnHeader.cs

Ottiene o imposta l'indice dell'immagine visualizzata in 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, set

Public Property ImageIndex As Integer

Valore della proprietà

Int32

Indice dell'immagine visualizzata in ColumnHeader.

Attributi

TypeConverterAttribute

Eccezioni

ArgumentOutOfRangeException

value è minore di -1.

Commenti

La ImageIndex proprietà fa riferimento all'indice di un'immagine specificata dalla SmallImageList proprietà di ListView che contiene l'oggetto ColumnHeader. La ImageIndex proprietà restituisce -1 se non è presente alcun SmallImageList oggetto impostato sull'oggetto che lo contiene ListView. L'immagine visualizzata in una colonna viene in genere utilizzata per indicare lo stato degli elementi nella colonna.

ImageKey e ImageIndex si escludono a vicenda, ovvero se ne è impostata una, l'altra viene impostata su un valore non valido e ignorata. Se si imposta la ImageKey proprietà , la ImageIndex proprietà viene impostata automaticamente su -1. In alternativa, se si imposta la ImageIndex proprietà , l'oggetto ImageKey viene impostato automaticamente su una stringa vuota ("").

Se il valore della ImageList proprietà viene modificato in null, la proprietà restituisce il ImageIndex valore predefinito - 1. Tuttavia, il valore assegnato ImageIndex viene mantenuto internamente e utilizzato quando un altro ImageList oggetto viene assegnato alla ImageList proprietà . Se il nuovo ImageList assegnato alla ImageList proprietà ha un ImageList.ImageCollection.Count valore della proprietà minore o uguale al valore assegnato alla ImageIndex proprietà meno uno (per tenere conto dell'insieme come indice in base zero), il ImageIndex valore della proprietà viene modificato in un valore minore del valore della Count proprietà. Si consideri, ad esempio, un controllo pulsante con ImageList tre immagini e la cui ImageIndex proprietà è impostata su 2. Se al ImageList pulsante sono assegnate solo due immagini, il ImageIndex valore diventa 1.