FlatStyle-Enumeration
Gibt die Darstellung eines Steuerelements an.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)
Syntax
'Declaration
Public Enumeration FlatStyle
'Usage
Dim instance As FlatStyle
public enum FlatStyle
public enum class FlatStyle
public enum FlatStyle
public enum FlatStyle
Member
| Membername | Beschreibung | |
|---|---|---|
| Flat | Das Steuerelement wird flach dargestellt. | |
| Popup | Ein Steuerelement wird flach dargestellt, bis der Mauszeiger über die Schaltfläche bewegt wird. Ist dies der Fall, wird das Steuerelement dreidimensional dargestellt. | |
| Standard | Das Steuerelement wird dreidimensional dargestellt. | |
| System | Die Darstellung des Steuerelements wird durch das Betriebssystem des Benutzers bestimmt. |
Hinweise
Diese Enumeration wird von Membern wie ButtonBase.FlatStyle, GroupBox.FlatStyle und Label.FlatStyle verwendet.
Wenn es sich um eine Popup-Schaltfläche handelt, werden über diese Enumeration neben der Darstellung auch einige Verhaltensmerkmale gesteuert. Popup-Schaltflächen werden so lange Flat dargestellt, bis der Mauszeiger über die Schaltfläche bewegt wird. Während sich der Mauszeiger über dem Popup-Steuerelement befindet, wird dieses als Standard-Steuerelement angezeigt.
Bei Verwendung des System-Stils wird die Darstellung des Steuerelements vom Betriebssystem des Benutzers bestimmt. Die folgenden Eigenschaftenwerte werden in diesem Fall ignoriert: Control.BackgroundImage, ImageAlign, Image, ImageIndex, ImageList und TextAlign. Zusätzlich wird die Control.BackColor-Eigenschaft für Schaltflächensteuerelemente ignoriert. Wenn Unterstützung gegeben ist, können Benutzer die Darstellung von Steuerelementen ändern, indem sie die Darstellungseinstellungen des Betriebssystems anpassen.
Hinweis
Wenn die FlatStyle-Eigenschaft der RadioButton-Klasse und der CheckBox-Klasse auf FlatStyle.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 ButtonBase.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 Textes. Wenn z. B. ein CheckBox-Steuerelement mit einem CheckAlign-Eigenschaftenwert von ContentAlignment.MiddleCenter und einem TextAlign-Eigenschaftenwert von ContentAlignment.TopRight vorhanden ist und der FlatStyle-Eigenschaftenwert auf FlatStyle.System festgelegt ist, wird die Ausrichtung des Kontrollkästchens mit dem Wert ContentAlignment.TopLeft dargestellt. Die Ausrichtung des Textes wird jedoch nicht geändert.
Warnung
Wenn Sie ein Bild auf einem Steuerelement anzeigen, ein Bild als Hintergrund eines Steuerelements anzeigen oder eine genaue Textausrichtung vornehmen müssen, empfiehlt es sich nicht, die FlatStyle-Eigenschaft auf FlatStyle.System festzulegen.
Hinweis zu Windows XP Home Edition, Windows XP Professional x64 Edition, Windows Server 2003: Um die Unterstützung der Darstellungsformate von Windows XP für eine Windows Forms-Anwendung zu aktivieren, müssen Sie die FlatStyle-Eigenschaft auf FlatStyle.System festlegen. Wenn Sie .NET Framework, Version 1.0, verwenden, muss die ausführbare Datei über ein Manifest verfügen. Ein Manifest ist eine XML-Datei, die sich entweder als Ressource in der ausführbaren Datei der Anwendung oder als separate Datei in demselben Verzeichnis wie die ausführbare Datei befindet. Im Abschnitt Beispiel finden Sie ein Beispiel für ein Manifest. Weitere Informationen über die Verwendung der in Windows XP verfügbaren Darstellungsformate finden Sie im Abschnitt "User Interface Design and Development" der MSDN Library unter "Using Windows XP Visual Styles".
Beispiel
Im folgenden Beispiel wird ein Manifest veranschaulicht, das der Anwendung eine Unterstützung der Darstellungsformate von Windows XP bei Verwendung von .NET Framework, Version 1.0, erlaubt. Sie können das Manifest als Ressource oder als eigenständige Textdatei zu einer Anwendung hinzufügen. Die Manifestdatei befindet sich im gleichen Verzeichnis wie die ausführbare Datei, und der Name der Textdatei muss dem vollständigen Namen der ausführbaren Datei zuzüglich der Dateinamenerweiterung .manifest entsprechen. Die Manifestdatei für MyApp.exe lautet z. B. MyApp.exe.manifest. In diesem Beispiel wird davon ausgegangen, dass die FlatStyle-Eigenschaften der Steuerelemente in der Anwendung auf FlatStyle.System festgelegt sind.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
<assemblyIdentity
version="1.0.0.0"
processorArchitecture="X86"
name="CompanyName.ProductName.YourApplication"
type="win32"
/>
<description>Your application description here.</description>
<dependency>
<dependentAssembly>
<assemblyIdentity
type="win32"
name="Microsoft.Windows.Common-Controls"
version="6.0.0.0"
processorArchitecture="X86"
publicKeyToken="6595b64144ccf1df"
language="*"
/>
</dependentAssembly>
</dependency>
</assembly>
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