ButtonBase.ImageList ButtonBase.ImageList ButtonBase.ImageList ButtonBase.ImageList Property

Definición

Obtiene o establece el objeto ImageList que contiene el objeto Image que se muestra en un control de botón.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

Valor de propiedad

Una clase ImageList.An ImageList. El valor predeterminado es null.The default value is null.

Ejemplos

En el ejemplo de código siguiente se usa la clase derivada, Button y establece el ImageList y ImageIndex propiedades.The following code example uses the derived class, Button and sets the ImageList and ImageIndex properties. Este código requiere que un ImageList ha sido creado y un valor uno como mínimo Image se ha asignado a él.This code requires that an ImageList has been created and a minimum of one Image has been assigned to it. Este código también requiere que tenga una imagen de mapa de bits denominada MyBitMap.bmp almacenados en el C:\Graphics 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 'AddMyImage

Comentarios

Cuando el ImageList o ImageIndex propiedad está establecida, el Image se establece la propiedad null, que es su valor predeterminado.When the ImageList or ImageIndex property is set, the Image property is set null, which is its default value.

Nota

Si el ImageList se cambia el valor de propiedad a null, el ImageIndex propiedad devuelve su valor predeterminado, -1.If the ImageList property value is changed to null, the ImageIndex property returns its default value, -1. Sin embargo, el asignado ImageIndex se retiene internamente y se utiliza cuando otro valor ImageList se asigna a la ImageList propiedad.However, the assigned ImageIndex value is retained internally and used when another ImageList is assigned to the ImageList property. Si el nuevo ImageList asignado a la ImageList propiedad tiene un ImageList.ImageCollection.Count valor de propiedad que es menor o igual que el valor asignado a la ImageIndex propiedad menos uno (porque la colección es un índice de base cero), el ImageIndex valor de propiedad se ajusta a uno menor que el Count valor de propiedad.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. Por ejemplo, considere la posibilidad de un botón de control cuya ImageList tiene tres imágenes y cuya propiedad ImageIndex propiedad está establecida en 2.For example, consider a button control whose ImageList has three images and whose ImageIndex property is set to 2. Si un nuevo ImageList que tiene solo dos imágenes se asigna al botón, el ImageIndex cambia el valor en 1.If a new ImageList that has only two images is assigned to the button, the ImageIndex value changes to 1.

Se aplica a

Consulte también: