Freigeben über


Schaltflächenstile

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