ButtonBase.Image Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define a imagem que é exibida em um controle de botão.

public:
 property System::Drawing::Image ^ Image { System::Drawing::Image ^ get(); void set(System::Drawing::Image ^ value); };

public System.Drawing.Image? Image { get; set; }

member this.Image : System.Drawing.Image with get, set

Public Property Image As Image

Valor da propriedade

Image

O Image que é exibido no controle de botão. O valor padrão é null.

Exemplos

O exemplo de código a seguir usa a classe Button derivada e define algumas de suas propriedades comuns. O resultado será um botão simples com texto à esquerda e uma imagem à direita. Esse código exige que você tenha uma imagem de bitmap chamada MyBitMap.bmp armazenada no C:\Graphics diretório e que uma referência ao System.Drawing namespace seja incluída.

private:
   void SetMyButtonProperties()
   {
      // Assign an image to the button.
      button1->Image = Image::FromFile( "C:\\Graphics\\MyBitmap.bmp" );
      // Align the image and text on the button.
      button1->ImageAlign = ContentAlignment::MiddleRight;
      button1->TextAlign = ContentAlignment::MiddleLeft;
      // Give the button a flat appearance.
      button1->FlatStyle = FlatStyle::Flat;
   }

private void SetMyButtonProperties()
 {
    // Assign an image to the button.
    button1.Image = Image.FromFile("C:\\Graphics\\MyBitmap.bmp");
    // Align the image and text on the button.
    button1.ImageAlign = ContentAlignment.MiddleRight;    
    button1.TextAlign = ContentAlignment.MiddleLeft;
    // Give the button a flat appearance.
    button1.FlatStyle = FlatStyle.Flat;
 }

Private Sub SetMyButtonProperties()
    ' Assign an image to the button.
    button1.Image = Image.FromFile("C:\Graphics\MyBitmap.bmp")
    ' Align the image and text on the button.
    button1.ImageAlign = ContentAlignment.MiddleRight
    button1.TextAlign = ContentAlignment.MiddleLeft
    ' Give the button a flat appearance.
    button1.FlatStyle = FlatStyle.Flat
End Sub

Comentários

Quando a Image propriedade for definida, a ImageList propriedade será definida como nulle a ImageIndex propriedade será definida como seu padrão, -1.

Observação

Se a FlatStyle propriedade estiver definida como FlatStyle.System, todas as imagens atribuídas à Image propriedade não serão exibidas.

Confira também

• ImageList
• FlatStyle