ButtonBase.ImageList Proprietà

Definizione

Ottiene o imposta l'oggetto ImageList che contiene l'oggetto Image visualizzato su un controllo pulsante.Gets or sets the ImageList that contains the Image displayed on a button control.

public:
 property System::Windows::Forms::ImageList ^ ImageList { System::Windows::Forms::ImageList ^ get(); void set(System::Windows::Forms::ImageList ^ value); };
public System.Windows.Forms.ImageList ImageList { get; set; }
member this.ImageList : System.Windows.Forms.ImageList with get, set
Public Property ImageList As ImageList

Valore della proprietà

Oggetto ImageList.An ImageList. Il valore predefinito è null.The default value is null.

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 viene ImageList impostata ImageIndex la proprietà o, viene Image impostata nullla proprietà, ovvero il valore predefinito.When the ImageList or ImageIndex property is set, the Image property is set null, which is its default value.

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 oggetto viene assegnato ImageList alla proprietà.However, the assigned ImageIndex value is retained internally and used when another ImageList 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 (poiché la raccolta è un indice in base zero), l'oggetto ImageIndex il 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 (because the collection is 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