ButtonBase.ImageIndex Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece el valor de índice de la lista de imágenes correspondiente a la imagen mostrada en el control de botón.

public:
 property int ImageIndex { int get(); void set(int value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int ImageIndex { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))>]
member this.ImageIndex : int with get, set

Public Property ImageIndex As Integer

Valor de propiedad

Int32

Índice basado en cero que representa la posición de la imagen en ImageList. El valor predeterminado es -1.

Atributos

TypeConverterAttribute

Excepciones

ArgumentOutOfRangeException

value es menor que 1.

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 establecen las propiedades o ImageList , la Image propiedad se establece en su valor predeterminado, null.ImageIndex

ImageKey y ImageIndex son mutuamente excluyentes, lo que significa que si se establece uno, el otro se establece en un valor no válido y se omite. Si establece la ImageKey propiedad , la ImageIndex propiedad se establece automáticamente en -1. Como alternativa, si establece la ImageIndex propiedad , se ImageKey establece automáticamente en una cadena vacía ("").

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 objeto 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 (para tener en cuenta que la colección es un índice de base cero), el ImageIndex valor de la propiedad se ajusta a uno menor que el valor de la Count propiedad. Por ejemplo, considere un control de botón cuya ImageList propiedad 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.

Consulte también

• ImageList