ButtonBase.ImageIndex Propriedade

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 Propriedade

Um índice baseado em zeros, que representa a posição da imagem num ImageList. O padrão é -1.

Atributos

TypeConverterAttribute

Exceções

Exemplos

O exemplo de código seguinte utiliza a classe derivada Button e define as ImageList propriedades e ImageIndex . Este código exige que um ImageList tenha sido criado e que pelo menos um Image tenha sido atribuído a ele. Este código também exige que tenha uma imagem bitmap nomeada MyBitMap.bmp armazenada no C:\Graphics diretório.

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

Observações

Quando as ImageIndex propriedades ou ImageList são definidas, a Image propriedade é definida para o seu valor padrão, null.

ImageKey e ImageIndex são mutuamente exclusivas, ou seja, se um for definido, o outro é atribuído a um valor inválido e ignorado. Se definires a ImageKey propriedade, ela ImageIndex é automaticamente definida para -1. Alternativamente, se definir a ImageIndex propriedade, o ImageKey é automaticamente definido para uma cadeia vazia ("").

Se o valor da ImageList propriedade for alterado para null, a ImageIndex propriedade devolve o seu valor padrão, -1. No entanto, o valor atribuído ImageIndex é mantido internamente e usado quando outro ImageList objeto é atribuído à ImageList propriedade. Se o novo ImageList valor atribuído à ImageList propriedade tiver ImageList.ImageCollection.Count um valor inferior ou igual ao valor atribuído à ImageIndex propriedade menos um (para considerar que a coleção é um índice baseado em zero), o ImageIndex valor da propriedade é ajustado para um valor inferior ao Count valor da propriedade. Por exemplo, considere um controlo de botão que ImageList tem três imagens e cuja ImageIndex propriedade está definida para 2. Se um novo ImageList que tenha apenas duas imagens for atribuído ao botão, o ImageIndex valor muda para 1.

Ver também

• ImageList