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 Button clase derivada y ImageList se ImageIndex establecen las propiedades y.The following code example uses the derived class, Button and sets the ImageList and ImageIndex properties. Este código requiere que se ImageList haya creado un y se le haya asignado Image al menos uno.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 MyBitMap.bmp bits denominada almacenada en el C:\Graphics directorio.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 se ImageList establece ImageIndex la propiedad o, se Image establece nullla propiedad, 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 valor de la propiedad se nullcambia a ImageIndex , la 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 ImageIndex valor asignado se conserva internamente y se usa ImageList cuando se asigna otro ImageList a la 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 basado en cero), el ImageIndex método el valor de la propiedad se ajusta a uno Count menos que el valor de la 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 un control de botón ImageList cuyo tiene tres imágenes y ImageIndex cuya 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 se asigna ImageList un nuevo que solo tiene dos imágenes al botón, el ImageIndex valor cambia a 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: