ButtonBase.ImageList Propriedade

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Obtém ou define o ImageList que contém o Image display num controlo de botão.

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 Propriedade

ImageList

Um ImageList. O valor predefinido é null.

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 a ImageList propriedade ou ImageIndex é definida, a Image propriedade é definida null, que é o seu valor padrão.

Note

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 valor é atribuído à ImageList propriedade. Se o novo ImageList atribuído à ImageList propriedade tiver um ImageList.ImageCollection.Count valor inferior ou igual ao valor atribuído à ImageIndex propriedade menos um (porque 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.

Aplica-se a

Ver também