ButtonBase.ImageIndex Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

ButtonBase.cs

Ottiene o imposta il valore dell'indice dell'elenco di immagini dell'immagine visualizzata nel controllo pulsante.

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à

Int32

Indice in base zero, che rappresenta la posizione dell'immagine in un oggetto ImageList. Il valore predefinito è -1.

Attributi

TypeConverterAttribute

Eccezioni

ArgumentOutOfRangeException

value è minore di -1.

Esempio

Nell'esempio di codice seguente viene utilizzata la classe Button derivata e vengono impostate le ImageList proprietà e ImageIndex . Questo codice richiede che sia stato creato un oggetto ImageList e che ne sia stato assegnato almeno uno Image . Questo codice richiede anche che sia presente un'immagine bitmap denominata MyBitMap.bmp archiviata nella C:\Graphics directory .

private:
   void AddMyImage()
   {
      // Assign an image to the imageList.
      imageList1->Images->Add( Image::FromFile( "C:\\Graphics\\MyBitmap.bmp" ) );
      // Assign the imageList to the button control.
      button1->ImageList = imageList1;
      // Select the image from the ImageList (using the ImageIndex property).
      button1->ImageIndex = 0;
   }

private void AddMyImage()
 {
    // Assign an image to the ImageList.
    ImageList1.Images.Add(Image.FromFile("C:\\Graphics\\MyBitmap.bmp"));
    // Assign the ImageList to the button control.   
    button1.ImageList = ImageList1;
    // Select the image from the ImageList (using the ImageIndex property).    
    button1.ImageIndex = 0;
 }

Private Sub AddMyImage()
    ' Assign an image to the ImageList.
    ImageList1.Images.Add(Image.FromFile("C:\Graphics\MyBitmap.bmp"))
    ' Assign the ImageList to the button control.   
    button1.ImageList = ImageList1
    ' Select the image from the ImageList (using the ImageIndex property).    
    button1.ImageIndex = 0
End Sub

Commenti

Quando le ImageIndex proprietà o ImageList sono impostate, la Image proprietà viene impostata sul relativo valore predefinito, null.

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

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.

Vedi anche

• ImageList