ToolStripItem.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 il valore di indice dell'immagine visualizzata nell'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, setPublic Property ImageIndex As IntegerValore della proprietà
Indice in base zero dell'immagine nell'oggetto ImageList visualizzato per l'elemento. Il valore predefinito è -1, che indica che l'elenco di immagini è vuoto.
- Attributi
Eccezioni
value è minore di -1.
Commenti
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 ("").
Le Imageproprietà , ImageIndexImageAlign, ImageKey, 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 ToolStrip e ToolStripItem, come indicato di seguito:
ImageScalingSize è la scala dell'immagine finale come determinato dalla combinazione dell'impostazione dell'immagine ImageScaling e dell'impostazione del AutoSize contenitore.
Se AutoSize è
true(impostazione predefinita) e ToolStripItemImageScaling è SizeToFit, non si verifica alcun ridimensionamento delle immagini e la ToolStrip dimensione è quella dell'elemento più grande o una dimensione minima prestabilita.Se AutoSize è
falsee ToolStripItemImageScaling è None, 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 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.
