Condividi tramite


ToolStripItem.ImageIndex Proprietà

Definizione

Ottiene o imposta il valore di indice dell'immagine visualizzata sull'elemento.

public:
 property int ImageIndex { int get(); void set(int value); };
[System.ComponentModel.Browsable(false)]
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))]
[System.Windows.Forms.RelatedImageList("Owner.ImageList")]
public int ImageIndex { get; set; }
[<System.ComponentModel.Browsable(false)>]
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
[<System.Windows.Forms.RelatedImageList("Owner.ImageList")>]
member this.ImageIndex : int with get, set
Public Property ImageIndex As Integer

Valore della proprietà

Int32

Indice in base zero dell'immagine contenuta in ImageList visualizzata per l'elemento. Il valore predefinito è -1, indicante che l'elenco di immagini è vuoto.

Attributi

Eccezioni

value è minore di -1.

Commenti

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 ("").

Le Imageproprietà , ImageAlign, ImageKeyImageIndex, e ImageScaling riguardano vari aspetti della gestione delle immagini. Usare le immagini nei ToolStrip controlli impostando queste proprietà direttamente o impostando la proprietà di sola ImageList esecuzione.

Il ridimensionamento delle immagini è determinato dall'interazione delle proprietà in e ToolStrip ToolStripItem, come indicato di seguito:

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.

Si applica a