ColumnHeader.ImageIndex Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta l'indice dell'immagine visualizzata nell'oggetto 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à
Indice dell’immagine visualizzato nell'oggetto ColumnHeader.
- Attributi
Eccezioni
value
è minore di -1.
Commenti
La ImageIndex proprietà fa riferimento all'indice di un'immagine specificata dalla SmallImageList proprietà dell'oggetto ListView contenente .ColumnHeader La ImageIndex proprietà restituisce -1 se non SmallImageList è presente alcun set sull'oggetto contenente ListView. L'immagine visualizzata in una colonna viene in genere usata per indicare lo stato degli elementi nella colonna.
ImageKey e si escludono ImageIndex a vicenda, ovvero se è impostato, l'altro è impostato su un valore non valido e ignorato. Se si imposta la proprietà, la ImageKeyImageIndex proprietà viene impostata automaticamente su -1. In alternativa, se si imposta la proprietà, l'oggetto ImageIndexImageKey viene impostato automaticamente su una stringa vuota ("").
Se il valore della proprietà viene modificato in null
, la ImageIndex proprietà restituisce il ImageList valore predefinito, -1. Tuttavia, il valore assegnato ImageIndex viene mantenuto internamente e usato quando viene assegnato un altro ImageList oggetto alla ImageList proprietà. Se il nuovo ImageList assegnato alla ImageList proprietà ha un ImageList.ImageCollection.Count valore di proprietà minore o uguale al valore assegnato alla ImageIndex proprietà meno uno (per tenere conto della raccolta 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 un nuovo ImageList oggetto con solo due immagini viene assegnato al pulsante, il ImageIndex valore viene modificato in 1.