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

Índice basado en cero que representa la posición de la imagen en 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 ImageIndex.The assigned value is less than the lower bounds of the ImageIndex.

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 ImageIndex establecen ImageList las propiedades o, la Image propiedad se establece 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 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 utiliza ImageList cuando otro objeto se asigna ImageList a la 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 que la colección es un índice basado en cero), el ImageIndexel 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 (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 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: