ButtonBase.ImageIndex Proprietà

Definizione

Ottiene o imposta il valore di indice dell'elenco immagini dell'immagine visualizzata sul controllo pulsante.Gets or sets the image list index value of the image displayed on the button control.

public:
 property int ImageIndex { int get(); void set(int value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int ImageIndex { get; set; }
member this.ImageIndex : int with get, set
Public Property ImageIndex As Integer

Valore della proprietà

Indice in base zero, che rappresenta la posizione dell'immagine in un oggetto ImageList.A zero-based index, which represents the image position in an ImageList. Il valore predefinito è -1.The default is -1.

Attributi

Eccezioni

Il valore assegnato è minore dei limiti inferiori della proprietà ImageIndex.The assigned value is less than the lower bounds of the ImageIndex.

Esempi

Nell'esempio di codice seguente viene usata la classe Button derivata e vengono ImageList impostate ImageIndex le proprietà e.The following code example uses the derived class, Button and sets the ImageList and ImageIndex properties. Per questo codice è necessario ImageList che sia stato creato un oggetto e che Image ne sia stato assegnato almeno uno.This code requires that an ImageList has been created and a minimum of one Image has been assigned to it. Questo codice richiede anche che sia presente un'immagine bitmap denominata MyBitMap.bmp archiviata C:\Graphics nella directory.This code also requires that you have a bitmap image named MyBitMap.bmp stored in the 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 si ImageIndex impostano le proprietà o Image ImageList , la nullproprietà viene impostata sul valore predefinito.When the ImageIndex or ImageList properties are set, the Image property is set to its default value, null.

Nota

Se il ImageList valore della proprietà viene modificato nullin, ImageIndex la proprietà restituisce il valore predefinito-1.If the ImageList property value is changed to null, the ImageIndex property returns its default value, -1. Il valore assegnato ImageIndex viene tuttavia mantenuto internamente e utilizzato quando un ImageList altro ImageList oggetto viene assegnato alla proprietà.However, the assigned ImageIndex value is retained internally and used when another ImageList object is assigned to the ImageList property. Se il nuovo ImageList oggetto assegnato ImageList alla proprietà ha un ImageList.ImageCollection.Count valore della proprietà minore ImageIndex o uguale al valore assegnato alla proprietà meno uno (per tenere conto della raccolta che rappresenta un indice in base zero), l'oggetto ImageIndexil valore della proprietà viene impostato su uno minore Count del valore della proprietà.If the new ImageList assigned to the ImageList property has an ImageList.ImageCollection.Count property value that is less than or equal to the value assigned to the ImageIndex property minus one (to account for the collection being a zero-based index), the ImageIndex property value is adjusted to one less than the Count property value. Si consideri ad esempio un controllo ImageList Button la cui proprietà è ImageIndex costituita da tre immagini e la cui proprietà è impostata su 2.For example, consider a button control whose ImageList has three images and whose ImageIndex property is set to 2. Se al pulsante ImageList viene assegnato un nuovo oggetto con due immagini, il ImageIndex valore viene impostato su 1.If a new ImageList that has only two images is assigned to the button, the ImageIndex value changes to 1.

Si applica a

Vedi anche