ButtonBase.FlatStyle-Eigenschaft

Artikel
08/20/2007

Ruft das Format für die flache Darstellung des Schaltflächen-Steuerelements ab oder legt dieses fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Property FlatStyle As FlatStyle
'Usage
Dim instance As ButtonBase
Dim value As FlatStyle

value = instance.FlatStyle

instance.FlatStyle = value

[LocalizableAttribute(true)] 
public FlatStyle FlatStyle { get; set; }

[LocalizableAttribute(true)] 
public:
property FlatStyle FlatStyle {
    FlatStyle get ();
    void set (FlatStyle value);
}

/** @property */
public FlatStyle get_FlatStyle ()

/** @property */
public void set_FlatStyle (FlatStyle value)

public function get FlatStyle () : FlatStyle

public function set FlatStyle (value : FlatStyle)

Eigenschaftenwert

Einer der FlatStyle-Werte. Der Standardwert ist Standard.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidEnumArgumentException	Der zugewiesene Wert ist keiner der FlatStyle-Werte.

Hinweise

Wenn die FlatStyle-Eigenschaft der RadioButton-Klasse und der CheckBox-Klasse auf System festgelegt ist, wird das Steuerelement durch das Betriebssystem des Benutzers gezeichnet, und die Ausrichtung des Kontrollkästchens beruht auf dem CheckAlign-Eigenschaftenwert und dem TextAlign-Eigenschaftenwert. Der CheckAlign-Eigenschaftenwert wird nicht geändert, jedoch kann die Darstellung des Steuerelements beeinflusst werden. Das Kontrollkästchen wird horizontal am linken oder rechten Rand des Steuerelements ausgerichtet. Eine linksbündige oder zentrierte Ausrichtung wird als linksbündige Ausrichtung, eine rechtsbündige Ausrichtung unverändert dargestellt. Die vertikale Ausrichtung entspricht der des beschreibenden Texts. Wenn Sie z. B. über ein CheckBox-Steuerelement mit dem CheckAlign-Eigenschaftenwert ContentAlignmentMiddleCenter, dem TextAlign-Eigenschaftenwert ContentAlignment.TopRight und einem auf System festgelegten FlatStyle-Eigenschaftenwert verfügen, wird für die Ausrichtung der Kontrollkästchen der Wert ContentAlignment.TopLeft verwendet, während die Textausrichtung nicht geändert wird.

Hinweis

Wenn die FlatStyle-Eigenschaft auf FlatStyle.System festgelegt ist, werden der Image-Eigenschaft zugewiesene Bilder nicht angezeigt.

Beispiel

Im folgenden Codebeispiel wird die abgeleitete Klasse Button verwendet, und einige ihrer allgemeinen Eigenschaften werden festgelegt. Das Ergebnis ist eine flache Schaltfläche mit Text auf der linken und einem Bild auf der rechten Seite. Für diesen Code ist es erforderlich, dass im Verzeichnis C:\Graphics eine Bitmap mit dem Namen MyBitMap.bmp gespeichert wurde und ein Verweis auf den System.Drawing-Namespace enthalten ist.

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 'SetMyButtonProperties

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 void SetMyButtonProperties()
{
    // Assign an image to the button.
    button1.set_Image(Image.FromFile("C:\\Graphics\\MyBitmap.bmp"));

    // Align the image and text on the button.
    button1.set_ImageAlign(ContentAlignment.MiddleRight);
    button1.set_TextAlign(ContentAlignment.MiddleLeft);

    // Give the button a flat appearance.
    button1.set_FlatStyle(FlatStyle.Flat);
} //SetMyButtonProperties

private function 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;
 }

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ButtonBase-Klasse
ButtonBase-Member
System.Windows.Forms-Namespace
System.Drawing.ContentAlignment

Freigeben über