ButtonBase.ImageIndex ButtonBase.ImageIndex ButtonBase.ImageIndex ButtonBase.ImageIndex Property

Definición

Obtiene o establece el valor de índice de la lista de imágenes correspondiente a la imagen mostrada en el control de botón.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

Valor de propiedad

Un índice de base cero que representa la posición de la imagen en un ImageList.A zero-based index, which represents the image position in an ImageList. El valor predeterminado es -1.The default is -1.

Excepciones

El valor asignado es menor que los límites inferiores de la ImageIndex.The assigned value is less than the lower bounds of the ImageIndex.

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 ImageIndex o ImageList propiedades están establecidas, el Image propiedad está establecida en su valor predeterminado, null.When the ImageIndex or ImageList properties are set, the Image property is set to its default value, null.

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 object 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 (para tener en cuenta la colección es un índice de base cero), el ImageIndexvalor 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 (to account for the collection being 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: