Compartir vía


ButtonBase.ImageList Propiedad

Definición

Obtiene o establece el objeto ImageList que contiene el objeto Image que se muestra en un control de botón.

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; }
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

ImageList

Una clase ImageList. El valor predeterminado es null.

Ejemplos

En el ejemplo de código siguiente se usa la clase Button derivada y se establecen las ImageList propiedades y ImageIndex . Este código requiere que se haya creado un ImageList y se le haya asignado un mínimo de uno Image . Este código también requiere que tenga una imagen de mapa de bits denominada MyBitMap.bmp almacenada en el C:\Graphics directorio .

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

Comentarios

Cuando se establece la ImageList propiedad o ImageIndex , la Image propiedad se establece null, que es su valor predeterminado.

Nota

Si el valor de la ImageList propiedad se cambia a null, la ImageIndex propiedad devuelve su valor predeterminado, -1. Sin embargo, el valor asignado ImageIndex se conserva internamente y se usa cuando se asigna otro ImageList a la ImageList propiedad . Si el nuevo ImageList asignado a la ImageList propiedad tiene un ImageList.ImageCollection.Count valor de propiedad 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 valor de propiedad Count . Por ejemplo, considere un control de botón cuya propiedad ImageList tiene tres imágenes y cuya ImageIndex propiedad está establecida en 2. Si un nuevo ImageList que solo tiene dos imágenes se asigna al botón, el ImageIndex valor cambia a 1.

Se aplica a

Consulte también