Schaltflächen-Formate
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
BN_CLICKED Notification