Schaltflächenstile

Artikel
06/13/2023

Gibt eine Kombination von Schaltflächenstilen an. Wenn Sie eine Schaltfläche mithilfe der BUTTON-Klasse mit der Funktion CreateWindow oder CreateWindowEx erstellen, können Sie eine der unten aufgeführten Schaltflächenstile angeben.

Beispiel

HRESULT Button::CreateText(HWND hParent, const TCHAR *szCaption, int nID, 
                               const Rect& rcBound)
{
    CREATESTRUCT create;
	ZeroMemory(&create, sizeof(CREATESTRUCT));

    create.x = rcBound.left;
    create.y = rcBound.top;
    create.cx = rcBound.right - create.x;
    create.cy = rcBound.bottom - create.y;

    create.hwndParent = hParent;
    create.lpszName = szCaption;
    create.hMenu = (HMENU)(INT_PTR)nID;
    create.lpszClass = TEXT("BUTTON");
    create.style = BS_PUSHBUTTON | BS_FLAT;
    return Control::Create(create);
}

Beispiel aus Klassische Windows-Beispiele auf GitHub.

Konstanten

Konstante	BESCHREIBUNG
BS_3STATE	Erstellt eine Schaltfläche, die mit einem Kontrollkästchen identisch ist, mit der Ausnahme, dass das Kontrollkästchen abgeblendet sowie aktiviert oder deaktiviert werden kann. Verwenden Sie den abgeblendeten Zustand, um anzuzeigen, dass der Zustand des Kontrollkästchens nicht bestimmt ist.
BS_AUTO3STATE	Erstellt eine Schaltfläche, die mit einem Kontrollkästchen mit drei Status identisch ist, mit der Ausnahme, dass das Kontrollkästchen seinen Status ändert, wenn der Benutzer es auswählt. Der Zustand durchläuft überprüft, unbestimmt und gelöscht.
BS_AUTOCHECKBOX	Erstellt eine Schaltfläche, die mit einem Kontrollkästchen identisch ist, mit der Ausnahme, dass der Überprüfungszustand bei jedem Aktivieren des Kontrollkästchens automatisch zwischen aktiviert und deaktiviert wird.
BS_AUTORADIOBUTTON	Erstellt eine Schaltfläche, die mit einem Optionsfeld identisch ist, mit der Ausnahme, dass das System, wenn der Benutzer sie auswählt, automatisch den Überprüfungsstatus der Schaltfläche auf aktiviert festlegt und den Überprüfungsstatus für alle anderen Schaltflächen in derselben Gruppe automatisch auf deaktiviert festlegt.
BS_BITMAP	Gibt an, dass die Schaltfläche eine Bitmap anzeigt. Informationen zur Interaktion mit BS_ICON finden Sie im Abschnitt Hinweise.
BS_BOTTOM	Setzt Text an den unteren Rand des Schaltflächenrechtecks.
BS_CENTER	Zentriert Text horizontal im Schaltflächenrechteck.
BS_CHECKBOX	Erstellt ein kleines, leeres Kontrollkästchen mit Text. Standardmäßig wird der Text rechts neben dem Kontrollkästchen angezeigt. Um den Text links neben dem Kontrollkästchen anzuzeigen, kombinieren Sie dieses Flag mit der BS_LEFTTEXT-Formatvorlage (oder mit der entsprechenden BS_RIGHTBUTTON Formatvorlage).
BS_COMMANDLINK	Erstellt eine Befehlslinkschaltfläche, die sich wie eine BS_PUSHBUTTON Stilschaltfläche verhält, aber die Befehlslinkschaltfläche hat einen grünen Pfeil auf der linken Seite, der auf den Schaltflächentext zeigt. Ein Untertitel für den Schaltflächentext kann festgelegt werden, indem die BCM_SETNOTE Nachricht an die Schaltfläche gesendet wird.
BS_DEFCOMMANDLINK	Erstellt eine Befehlslinkschaltfläche, die sich wie eine BS_PUSHBUTTON Stilschaltfläche verhält. Wenn sich die Schaltfläche in einem Dialogfeld befindet, kann der Benutzer die Befehlslinkschaltfläche durch Drücken der EINGABETASTE auswählen, auch wenn die Befehlslinkschaltfläche nicht über den Eingabefokus verfügt. Dieser Stil ist nützlich, damit der Benutzer schnell die wahrscheinlichste (Standard)-Option auswählen kann.
BS_DEFPUSHBUTTON	Erstellt eine Drucktaste, die sich wie eine BS_PUSHBUTTON Stilschaltfläche verhält, aber eine eindeutige Darstellung aufweist. Wenn sich die Schaltfläche in einem Dialogfeld befindet, kann der Benutzer die Schaltfläche durch Drücken der EINGABETASTE auswählen, auch wenn die Schaltfläche nicht über den Eingabefokus verfügt. Dieser Stil ist nützlich, damit der Benutzer schnell die wahrscheinlichste (Standard)-Option auswählen kann.
BS_DEFSPLITBUTTON	Erstellt eine geteilte Schaltfläche, die sich wie eine BS_PUSHBUTTON Stilschaltfläche verhält, aber auch eine charakteristische Darstellung aufweist. Wenn sich die geteilte Schaltfläche in einem Dialogfeld befindet, kann der Benutzer die geteilte Schaltfläche durch Drücken der EINGABETASTE auswählen, auch wenn die geteilte Schaltfläche nicht über den Eingabefokus verfügt. Dieser Stil ist nützlich, damit der Benutzer schnell die wahrscheinlichste (Standard)-Option auswählen kann.
BS_GROUPBOX	Erstellt ein Rechteck, in dem andere Steuerelemente gruppiert werden können. Jeder dieser Formatvorlage zugeordnete Text wird in der oberen linken Ecke des Rechtecks angezeigt.
BS_ICON	Gibt an, dass die Schaltfläche ein Symbol anzeigt. Weitere Informationen zur Interaktion mit BS_BITMAP finden Sie im Abschnitt Hinweise.
BS_FLAT	Gibt an, dass die Schaltfläche zweidimensional ist; Es verwendet nicht die Standardschattierung, um ein 3D-Image zu erstellen.
BS_LEFT	Rechtfertigt den Text im Schaltflächenrechteck nach links. Wenn es sich bei der Schaltfläche jedoch um ein Kontrollkästchen oder Optionsfeld handelt, das nicht über die BS_RIGHTBUTTON-Formatvorlage verfügt, wird der Text rechts neben dem Kontrollkästchen oder Optionsfeld links ausgerichtet.
BS_LEFTTEXT	Platziert Text auf der linken Seite des Optionsfelds oder Kontrollkästchens, wenn er mit einem Optionsfeld oder einem Kontrollkästchenformat kombiniert wird. Identisch mit dem BS_RIGHTBUTTON Stil.
BS_MULTILINE	Bricht den Schaltflächentext in mehrere Zeilen um, wenn die Zeichenfolge für eine einzelne Zeile im Schaltflächenrechteck zu lang ist.
BS_NOTIFY	Ermöglicht einer Schaltfläche das Senden BN_KILLFOCUS und BN_SETFOCUS Benachrichtigungscodes an das übergeordnete Fenster. Beachten Sie, dass Schaltflächen den BN_CLICKED Benachrichtigungscode unabhängig davon senden, ob er diesen Stil aufweist. Um BN_DBLCLK Benachrichtigungscodes abzurufen, muss die Schaltfläche über das BS_RADIOBUTTON- oder BS_OWNERDRAW-Format verfügen.
BS_OWNERDRAW	Erstellt eine Ownerdrawn-Schaltfläche. Das Besitzerfenster erhält eine WM_DRAWITEM Meldung, wenn sich ein visueller Aspekt der Schaltfläche geändert hat. Kombinieren Sie den BS_OWNERDRAW Stil nicht mit anderen Schaltflächenformatvorlagen.
BS_PUSHBUTTON	Erstellt eine Druckschaltfläche, die eine WM_COMMAND Nachricht an das Besitzerfenster sendet, wenn der Benutzer die Schaltfläche auswählt.
BS_PUSHLIKE	Bewirkt, dass eine Schaltfläche (z. B. ein Kontrollkästchen, ein Kontrollkästchen mit drei Status oder ein Optionsfeld) aussieht und wie eine Drucktaste fungiert. Die Schaltfläche wird angehoben, wenn sie nicht gedrückt oder überprüft wird, und wird beim Drücken oder Überprüfen abgesenkt.
BS_RADIOBUTTON	Erstellt einen kleinen Kreis mit Text. Standardmäßig wird der Text rechts neben dem Kreis angezeigt. Um den Text auf der linken Seite des Kreises anzuzeigen, kombinieren Sie dieses Flag mit der BS_LEFTTEXT-Formatvorlage (oder mit der entsprechenden BS_RIGHTBUTTON Formatvorlage). Verwenden Sie Optionsfelder für Gruppen verwandter, aber sich gegenseitig ausschließenden Optionen.
BS_RIGHT	Rechtfertigt Text im Schaltflächenrechteck. Wenn es sich bei der Schaltfläche jedoch um ein Kontrollkästchen oder Optionsfeld handelt, das nicht über die BS_RIGHTBUTTON-Formatvorlage verfügt, wird der Text rechts neben dem Kontrollkästchen oder Optionsfeld rechts ausgerichtet.
BS_RIGHTBUTTON	Positioniert den Kreis eines Optionsfelds oder das Quadrat eines Kontrollkästchens auf der rechten Seite des Schaltflächenrechtecks. Identisch mit dem BS_LEFTTEXT Stil.
BS_SPLITBUTTON	Erstellt eine unterteilte Schaltfläche. Eine geteilte Schaltfläche verfügt über einen Dropdownpfeil.
BS_TEXT	Gibt an, dass die Schaltfläche Text anzeigt.
BS_TOP	Setzt Text an den oberen Rand des Schaltflächenrechtecks.
BS_TYPEMASK	Verwenden Sie diesen Stil nicht. Ein zusammengesetztes Formatvorlagenbit, das sich aus der Verwendung des OR-Operators für BS_-Formatvorlagen-Bits ergibt. Es kann verwendet werden, um gültige BS_-Bits aus einer bestimmten Bitmaske zu maskieren. Beachten Sie, dass dies veraltet ist und nicht alle gültigen Formatvorlagen ordnungsgemäß enthält. Daher sollten Sie diesen Stil nicht verwenden.
BS_USERBUTTON	Veraltet, wird jedoch für die Kompatibilität mit 16-Bit-Versionen von Windows bereitgestellt. Anwendungen sollten stattdessen BS_OWNERDRAW verwenden.
BS_VCENTER	Platziert Text in der Mitte (vertikal) des Schaltflächenrechtecks.

Bemerkungen

Abbildungen der Prinzipalschaltflächenstile wie BS_CHECKBOX und BS_GROUPBOX finden Sie unter Schaltflächentypen.

Die Darstellung von Text oder Symbol oder beidem in einem Schaltflächensteuerelement hängt von der BS_ICON und BS_BITMAP ab und davon, ob die BM_SETIMAGE Nachricht gesendet wird. Die möglichen Ergebnisse sind wie folgt:

BS_ICON oder BS_BITMAP festgelegt?	BM_SETIMAGE aufgerufen?	Ergebnis
Ja	Ja	Nur Symbol anzeigen.
Nein	Ja	Symbol und Text anzeigen.
Ja	Nein	Nur Text anzeigen.
Nein	Nein	Nur Text anzeigen

Anforderungen

Anforderung	Wert
Header	Winuser.h