Schaltflächen-Formate

  • Artikel

Dieses Thema beschreibt die Schaltfläche Typen und - Stile.

Schaltflächen-Typen

In der folgenden Tabelle werden die Typen von Schaltflächen auf.Sie können optional eine der folgenden Optionen auswählen.Wenn Sie keinen Schaltflächentyp angeben, ist der Standardwert BS_PUSHBUTTON.

type

Beschreibung

BS_3STATE

Stellt eine Schaltfläche Kontrollkästchen mit drei Zuständen: BST_CHECKED, BST_INDETERMINATE und BST_UNCHECKED.Durch Klicken auf die Schaltfläche sendet, eine BN_CLICKED Benachrichtigung an das Besitzerfenster ändert jedoch nicht den Zustand der Schaltfläche.Standardmäßig wird zugeordneter Text auf der rechten Seite des Kontrollkästchens angezeigt.Um Text auf der linken Seite des Kontrollkästchens anzuzeigen, verwenden Sie das BS_LEFTTEXT oder BS_RIGHTBUTTON Format.

BS_AUTO3STATE

Stellt eine Schaltfläche Kontrollkästchen mit drei Zuständen: BST_CHECKED, BST_INDETERMINATE und BST_UNCHECKED.Durch Klicken auf die Schaltfläche sendet eine BN_CLICKED Benachrichtigung an das Besitzerfenster, und ändert den Zustand der Schaltfläche.Die Schaltflächen Bedingungen werden in der Reihenfolge von BST_CHECKED, BST_INDETERMINATE und BST_UNCHECKED rad.Standardmäßig wird zugeordneter Text auf der rechten Seite des Kontrollkästchens angezeigt.Um Text auf der linken Seite des Kontrollkästchens anzuzeigen, verwenden Sie das BS_LEFTTEXT oder BS_RIGHTBUTTON Format.

BS_AUTOCHECKBOX

Stellt eine Schaltfläche Kontrollkästchen mit zwei Zuständen: BST_CHECKED und BST_UNCHECKED.Durch Klicken auf die Schaltfläche sendet eine BN_CLICKED Benachrichtigung an das Besitzerfenster, und ändert den Zustand der Schaltfläche.Standardmäßig wird zugeordneter Text auf der rechten Seite des Kontrollkästchens angezeigt.Um Text auf der linken Seite des Kontrollkästchens anzuzeigen, verwenden Sie das BS_LEFTTEXT oder BS_RIGHTBUTTON Format.

BS_AUTORADIOBUTTON

Stellt ein Optionsfeld mit zwei Zuständen: BST_CHECKED und BST_UNCHECKED.Optionsfelder werden normalerweise in Gruppen verwendet, wenn jede Gruppe ein Maximalwert aufweist, aus einer aktivierten Option.Durch Klicken auf die Schaltfläche sendet eine BN_CLICKED Benachrichtigung an das Besitzerfenster, legt den Zustand des Optionsfelds an, auf die geklickt wurde BST_CHECKED und die Bedingungen aller übrigen Optionsfelder in der Gruppe von Schaltflächen auf BST_UNCHECKED fest.Standardmäßig wird zugeordneter Text auf der rechten Seite des Optionsfelds angezeigt.Um Text auf der linken Seite des Optionsfelds anzuzeigen, verwenden Sie das BS_LEFTTEXT oder BS_RIGHTBUTTON Format.

BS_CHECKBOX

Stellt eine Schaltfläche Kontrollkästchen mit zwei Zuständen: BST_CHECKED und BST_UNCHECKED.Durch Klicken auf die Schaltfläche sendet, eine BN_CLICKED Benachrichtigung an das Besitzerfenster ändert jedoch nicht den Zustand der Schaltfläche.Standardmäßig wird zugeordneter Text auf der rechten Seite des Kontrollkästchens angezeigt.Um Text auf der linken Seite des Kontrollkästchens anzuzeigen, verwenden Sie das BS_LEFTTEXT oder BS_RIGHTBUTTON Format.

BS_COMMANDLINK

Stellt eine Schaltfläche Link Befehls erstellt.Eine Schaltfläche ist ein Link Befehls auf bestimmte Befehlsschaltflächen Windows Vista mit einem grünen Pfeil links neben dem primären Text und eines Hinweises unterhalb des primären Text anzeigt.Sie können den Text der Hinweis mit CButton::SetNote festlegen.

BS_DEFCOMMANDLINK

Stellt eine Schaltfläche Link Befehls erstellt.Eine Schaltfläche ist ein Link Befehls auf bestimmte Befehlsschaltflächen Windows Vista mit einem grünen Pfeil links neben dem primären Text und eines Hinweises unterhalb des primären Text anzeigt.Sie können den Text der Hinweis mit CButton::SetNote festlegen.Wenn die Schaltfläche in einem Dialogfeld ist, sendet das Drücken der EINGABETASTE eine Benachrichtigung BN_CLICKED dem Dialogfeld, auch wenn die Schaltfläche nicht den Eingabefokus besitzt.

BS_DEFPUSHBUTTON

Stellt eine Befehlsschaltfläche, die einem schweren Trauerrand verfügt.Wenn die Schaltfläche in einem Dialogfeld ist, sendet das Drücken der EINGABETASTE eine Benachrichtigung BN_CLICKED dem Dialogfeld, auch wenn die Schaltfläche nicht den Eingabefokus besitzt.

BS_DEFSPLITBUTTON

Stellt eine unterteilte Schaltfläche.Eine unterteilte Schaltfläche ist ein Befehlsschaltflächen besondere zu Windows Vista, das eine Schaltfläche neben dem Dropdownpfeil enthält.Wenn Sie auf die Schaltfläche klicken, wird der Befehl ausgeführt wird.Wenn Sie auf den Dropdownpfeil klicken, wird ein Menü mit zusätzlichen Befehle.Wenn die unterteilte Schaltfläche in einem Dialogfeld ist, sendet das Drücken der EINGABETASTE eine Benachrichtigung BN_CLICKED dem Dialogfeld, auch wenn die Schaltfläche nicht den Eingabefokus besitzt

BS_GROUPBOX

Erstellt ein Rechteck, in dem andere Schaltflächen gruppiert werden können.Der Text, der mit diesem Format zugewiesen ist, wird in der oberen linken Ecke des Rechtecks angezeigt.

BS_OWNERDRAW

Stellt eine ownerdrawn- Button.Das Framework ruft die DrawItem-Methode auf, wenn sich ein Darstellungsaspekt der Schaltfläche geändert hat.Dieses Format muss festgelegt werden, wenn Sie die CBitmapButton-Klasse verwenden.

BS_PUSHBUTTON

Stellt eine Befehlsschaltfläche erstellt, die eine Benachrichtigung für den BN_CLICKED Besitzerfenster sendet, wenn der Benutzer auf die Schaltfläche klickt.

BS_RADIOBUTTON

Stellt ein Optionsfeld mit zwei Zuständen: BST_CHECKED und BST_UNCHECKED.Optionsfelder werden normalerweise in Gruppen verwendet, wenn jede Gruppe ein Maximalwert aufweist, aus einer aktivierten Option.Durch Klicken auf die Schaltfläche sendet, eine Benachrichtigung für den BN_CLICKED Besitzerfenster jedoch nicht automatisch ändert den Zustand einer Schaltfläche in der Gruppe.Standardmäßig wird zugeordneter Text auf der rechten Seite des Optionsfelds angezeigt.Um Text auf der linken Seite des Optionsfelds anzuzeigen, verwenden Sie das BS_LEFTTEXT oder BS_RIGHTBUTTON Format.

BS_SPLITBUTTON

Stellt eine unterteilte Schaltfläche.Eine unterteilte Schaltfläche ist ein Befehlsschaltflächen besondere zu Windows Vista, das eine Schaltfläche neben dem Dropdownpfeil enthält.Wenn Sie auf die Schaltfläche klicken, wird der Befehl ausgeführt wird.Wenn Sie auf den Dropdownpfeil klicken, wird ein Menü mit zusätzlichen Befehle.

BS_USERBUTTON

Veraltet, jedoch vorausgesetzt die Kompatibilität mit 16-Bit-Versionen von Windows.Anwendungen sollten Win32-based BS_OWNERDRAW-Version verwenden.

Optionsfeld-und Kontrollkästchen-Formate

In der folgenden Tabelle werden die Formate aufgelistet, die sich auf die Kontrollkästchen und Optionsfelder spezifisch sind.Diese Formate werden in allen anderen Typen von Schaltflächen ignoriert.Sie können eine oder mehrere der folgenden optional auswählen.

Format

Beschreibung

BS_LEFTTEXT

Wenn sie mit einem Optionsfeld- oder Kontrollkästchen Format kombiniert wird, wird der Text auf der linken Seite des Optionsfelds oder des Kontrollkästchens.

BS_RIGHTBUTTON

Wenn sie mit einem Optionsfeld- oder Kontrollkästchen Format kombiniert wird, wird der Text auf der linken Seite des Optionsfelds oder des Kontrollkästchens.Dieses Format ist mit dem BS_LEFTTEXT Format identisch.

BS_PUSHLIKE

Stellt ein Kontrollkästchen oder eine Optionsschaltfläche, z. B. eine Befehlsschaltfläche Handlers dargestellt und sich entsprechend verhalten.Die Schaltfläche ist gedrückt freigegeben, wenn der Status BST_CHECKED ist, gedrückt und abgeblendet, wenn der Status BST_INDETERMINATE ist, und wenn der Status BST_UNCHECKED ist.

Text-Ausrichtungs-Formate

In der folgenden Tabelle sind die horizontalen und vertikalen Ausrichtungsoptionen des Texts auf.Sie können optional eine der folgenden Optionen auswählen.

Format

Beschreibung

BS_LEFT

Links: Richtet den Text im Schaltflächenrechteck aus.Wenn jedoch die Schaltfläche ein Kontrollkästchen oder ein Optionsfeld ist BS_RIGHTBUTTON, die nicht das Format aufweist, ist der Text der linken Seite auf der rechten Seite des Kontrollkästchens oder des Optionsfelds ausgerichtet ist.

BS_RIGHT

Rechts: Richtet den Text im Schaltflächenrechteck aus.Wenn jedoch die Schaltfläche ein Kontrollkästchen oder ein Optionsfeld ist, die nicht das Format aufweist, BS_RIGHTBUTTON der Text befindet sich rechts auf der rechten Seite des Kontrollkästchens oder des Optionsfelds ausgerichtet ist.

BS_CENTER

Mittelpunkte simsen horizontal im Schaltflächenrechteck.

BS_TOP

Stellen simsen am oberen Rand des Schaltflächenrechtecks.

BS_BOTTOM

Stellen simsen am unteren Rand des Schaltflächenrechteck.

BS_VCENTER

Mittelpunkte simsen vertikal im Schaltflächenrechteck.

Schaltflächen-zufriedene Optionen

In der folgenden Tabelle sind Optionen aufgeführt, die angeben, was in der Schaltfläche angezeigt wird.Typen von Schaltflächen, die nur Text anzeigen, diese Formate ignorieren.Sie können optional eine der folgenden Optionen auswählen.

Format

Beschreibung

BS_BITMAP

Gibt an, dass die Schaltfläche eine Bitmap angezeigt werden.

BS_ICON

Gibt an, dass die Schaltfläche ein Symbol anzeigt.

BS_TEXT

Gibt an, dass die Schaltflächen angezeigt werden simsen.

Weitere Optionen

In der folgenden Tabelle sind Optionen aufgeführt, die Sie mit jedem Schaltflächentyp verwenden können.Sie können eine oder mehrere der folgenden optional auswählen.

Format

Beschreibung

BS_FLAT

Gibt an, dass die Schaltfläche zweidimensional ist und nicht mit standardmäßigen Schattierung gezeichnet wird, um ein dreidimensionales Bild zu erstellen.

BS_MULTILINE

Bindet den Schaltflächentext an mehrere Zeilen ein, wenn die Zeichenfolge zu lang ist, in einer einzigen Zeile im Schaltflächenrechteck angepasst.

BS_NOTIFY

Aktiviert eine Schaltfläche, um BN_DBLCLK, BN_KILLFOCUS und BN_SETFOCUS Benachrichtigungsmeldungen an das übergeordnete Fenster zu senden.Beachten Sie, dass die Schaltflächen BN_CLICKED Benachrichtigung gesendet, unabhängig davon, ob dieses Format angegeben wurde.

Siehe auch

Referenz

CButton::Create

Schaltflächen-Formate

BN_CLICKED Notification

Weitere Ressourcen

Stile wird von MFC