ToolStripItem.ImageIndex Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

BrowsableAttribute TypeConverterAttribute RelatedImageListAttribute

Eccezioni

ArgumentOutOfRangeException

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:

• ImageScalingSize è la scala dell'immagine finale determinata dalla combinazione dell'impostazione dell'immagine ImageScaling e dell'impostazione del AutoSize contenitore.

  • Se AutoSize è true (impostazione predefinita) e ToolStripItemImageScaling è SizeToFit, non viene eseguita alcuna scalabilità delle immagini e la ToolStrip dimensione è quella dell'elemento più grande o di una dimensione minima prestabilita.

  • Se AutoSize è e ToolStripItemImageScaling è Nonefalse , non si verifica né l'immagine né ToolStrip il ridimensionamento.

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.