ListViewItem.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 associata all'elemento.
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.NoneExcludedImageIndexConverter))]
public int ImageIndex { get; set; }[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))>]
member this.ImageIndex : int with get, set[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
member this.ImageIndex : int with get, setPublic Property ImageIndex As IntegerValore della proprietà
Indice in base zero dell'immagine contenuta in ImageList visualizzata per l'elemento. Il valore predefinito è -1.
- Attributi
Eccezioni
value è minore di -1.
Commenti
Il valore di questa proprietà dipende dal valore della ImageList proprietà . A seconda del valore corrente della View proprietà del ListView controllo associato all'elemento, l'oggetto ImageList utilizzato dall'elemento può essere specificato nella LargeImageList proprietà o nella SmallImageList proprietà del ListView controllo. Se la View proprietà è impostata su LargeIcon, viene utilizzato l'oggetto ImageList specificato nella LargeImageList proprietà ; in caso contrario, viene utilizzato l'oggetto ImageList SmallImageList specificato nella proprietà . Le immagini definite nell'oggetto ImageList specificato nella SmallImageList proprietà devono avere le stesse posizioni di indice delle immagini nell'oggetto ImageList specificato nella LargeImageList proprietà . Se le posizioni dell'indice sono uguali per entrambi ImageList i controlli, è possibile impostare un singolo valore di indice per la ImageIndex proprietà e l'immagine appropriata verrà visualizzata indipendentemente dal valore della View proprietà del ListView controllo.
ImageKey e si escludono ImageIndex a vicenda, ovvero se ne è impostata una, l'altra è 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 usato 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 che l'insieme è un indice in base zero), il valore della ImageIndex 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 vengono assegnate solo due immagini, il ImageIndex valore viene modificato in 1.