ButtonBase.Image Eigenschaft

Definition

Ruft das auf einem Schaltflächen-Steuerelement angezeigte Bild ab oder legt dieses fest.Gets or sets the image that is displayed on a button control.

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

Eigenschaftswert

Das Image, das auf dem Schaltflächen-Steuerelement angezeigt wird.The Image displayed on the button control. Der Standardwert ist nullsein.The default value is null.

Beispiele

Im folgenden Codebeispiel wird Button die abgeleitete-Klasse verwendet und einige ihrer allgemeinen Eigenschaften festgelegt.The following code example uses the derived class, Button and sets some of its common properties. Das Ergebnis ist eine flache Schaltfläche mit Text auf der linken Seite und ein Bild auf der rechten Seite.The result will be a flat button with text on the left and an image on the right. Dieser Code erfordert, dass Sie über ein Bitmapbild MyBitMap.bmp mit dem C:\Graphics Namen verfügen, das im Verzeichnis gespeichert ist, System.Drawing und dass ein Verweis auf den Namespace enthalten ist.This code requires that you have a bitmap image named MyBitMap.bmp stored in the C:\Graphics directory, and that a reference to the System.Drawing namespace is included.

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

Hinweise

Wenn die Image -Eigenschaft festgelegt ist ImageList , wird die-Eigenschaft nullauf festgelegt ImageIndex , und die-Eigenschaft wird auf den Standardwert-1 festgelegt.When the Image property is set, the ImageList property will be set to null, and the ImageIndex property will be set to its default, -1.

Hinweis

Wenn die FlatStyle -Eigenschaft auf FlatStyle.Systemfestgelegt ist, werden alle der Image -Eigenschaft zugewiesenen Bilder nicht angezeigt.If the FlatStyle property is set to FlatStyle.System, any images assigned to the Image property are not displayed.

Gilt für:

Siehe auch