Schaltfläche (Windows-Steuerelemente)

Artikel
03/12/2025

Dieser Abschnitt enthält Informationen zu den Programmierelementen, die mit Schaltflächensteuerelementen verwendet werden. Eine Schaltfläche ist ein Steuerelement, auf das der Benutzer klicken kann, um einer Anwendung Eingaben bereitzustellen.

Überblicke

Thema	Inhalt
Schaltflächennachrichten	In diesem Thema werden Nachrichten erläutert, die mit Schaltflächen verwendet werden.
Schaltflächenstatus	In diesem Abschnitt wird erläutert, wie die Auswahl einer Schaltfläche ihren Zustand ändert und wie die Anwendung reagieren soll.
Schaltflächentypen	In diesem Thema werden die verschiedenen Arten von Schaltflächen erläutert.
Verwenden von Schaltflächen	In diesem Abschnitt wird erläutert, wie bestimmte Aufgaben ausgeführt werden, die Schaltflächen zugeordnet sind.

Funktionen

Thema	Inhalt
CheckDlgButton-	Ändert den Prüfstatus eines Schaltflächensteuerelements.
CheckRadioButton-	Fügt ein Häkchen zu (überprüft) einem angegebenen Optionsfeld in einer Gruppe hinzu und entfernt ein Häkchen aus (Löscht) alle anderen Optionsfelder in der Gruppe.
IsDlgButtonChecked	Die IsDlgButtonChecked--Funktion bestimmt, ob ein Schaltflächensteuerelement überprüft wird oder ob ein Schaltflächensteuerelement mit drei Status aktiviert, deaktiviert oder unbestimmt ist.

Macros

Thema	Inhalt
Button_Enable	Aktiviert oder deaktiviert eine Schaltfläche.
Button_GetCheck	Ruft den Kontrollkästchenstatus eines Optionsfelds oder Kontrollkästchens ab. Sie können dieses Makro verwenden oder die BM_GETCHECK Nachricht explizit senden.
Button_GetIdealSize	Ruft die Größe der Schaltfläche ab, die am besten zum Text und Bild passt, wenn eine Bildliste vorhanden ist. Sie können dieses Makro verwenden oder die BCM_GETIDEALSIZE Nachricht explizit senden.
Button_GetImageList	Ruft die BUTTON_IMAGELIST Struktur ab, die die Bildliste beschreibt, die für ein Schaltflächensteuerelement festgelegt ist. Sie können dieses Makro verwenden oder die BCM_GETIMAGELIST Nachricht explizit senden.
Button_GetNote	Ruft den Text der Notiz ab, die einer Befehlslinkschaltfläche zugeordnet ist. Sie können dieses Makro verwenden oder die BCM_GETNOTE Nachricht explizit senden.
Button_GetNoteLength	Ruft die Länge des Notiztexts ab, der in der Beschreibung für einen Befehlslink angezeigt werden kann. Verwenden Sie dieses Makro, oder senden Sie die BCM_GETNOTELENGTH Nachricht explizit.
Button_GetSplitInfo	Ruft Informationen für ein angegebenes Steuerelement für geteilte Schaltflächen ab. Verwenden Sie dieses Makro, oder senden Sie die BCM_GETSPLITINFO Nachricht explizit.
Button_GetState	Ruft den Kontrollkästchenstatus eines Optionsfelds oder Kontrollkästchens ab. Sie können dieses Makro verwenden oder die BM_GETSTATE Nachricht explizit senden.
Button_GetText	Ruft den Text einer Schaltfläche ab.
Button_GetTextLength	Ruft die Anzahl der Zeichen im Text einer Schaltfläche ab.
Button_GetTextMargin	Ruft die Ränder ab, die zum Zeichnen von Text in einem Schaltflächensteuerelement verwendet werden. Sie können dieses Makro verwenden oder die BCM_GETTEXTMARGIN Nachricht explizit senden.
Button_SetCheck	Legt den Kontrollkästchenstatus eines Optionsfelds oder Kontrollkästchens fest. Sie können dieses Makro verwenden oder die BM_SETCHECK Nachricht explizit senden.
Button_SetDropDownState	Legt den Dropdownstatus für eine angegebene Schaltfläche mit dem Stil von BS_SPLITBUTTONfest. Verwenden Sie dieses Makro, oder senden Sie die BCM_SETDROPDOWNSTATE Nachricht explizit.
Button_SetElevationRequiredState	Legt den erforderlichen Zustand für die Rechteerweiterung für eine angegebene Schaltfläche oder einen Befehlslink fest, um ein Symbol mit erhöhten Rechten anzuzeigen. Verwenden Sie dieses Makro, oder senden Sie die BCM_SETSHIELD Nachricht explizit.
Button_SetImageList	Weist einem Schaltflächensteuerelement eine Bildliste zu. Sie können dieses Makro verwenden oder die BCM_SETIMAGELIST Nachricht explizit senden.
Button_SetNote	Legt den Text der Notiz fest, die einer angegebenen Befehlslinkschaltfläche zugeordnet ist. Sie können dieses Makro verwenden oder die BCM_SETNOTE Nachricht explizit senden.
Button_SetSplitInfo	Legt Informationen für ein angegebenes Steuerelement für geteilte Schaltflächen fest. Verwenden Sie dieses Makro, oder senden Sie die BCM_SETSPLITINFO Nachricht explizit.
Button_SetState	Legt den Hervorhebungszustand einer Schaltfläche fest. Der Hervorhebungszustand gibt an, ob die Schaltfläche hervorgehoben ist, als ob der Benutzer sie gedrückt hatte. Sie können dieses Makro verwenden oder die BM_SETSTATE Nachricht explizit senden.
Button_SetStyle	Legt die Formatvorlage einer Schaltfläche fest. Sie können dieses Makro verwenden oder die BM_SETSTYLE Nachricht explizit senden.
Button_SetText	Legt den Text einer Schaltfläche fest.
Button_SetTextMargin	Legt die Ränder für den Zeichnungstext in einem Schaltflächensteuerelement fest. Sie können dieses Makro verwenden oder die BCM_SETTEXTMARGIN Nachricht explizit senden.

Meldungen

Thema	Inhalt
BCM_GETIDEALSIZE	Ruft die Größe der Schaltfläche ab, die am besten zum Text und Bild passt, wenn eine Bildliste vorhanden ist. Sie können diese Nachricht explizit senden oder das Button_GetIdealSize Makro verwenden.
BCM_GETIMAGELIST	Ruft die BUTTON_IMAGELIST Struktur ab, die die Bildliste beschreibt, die einem Schaltflächensteuerelement zugewiesen ist. Sie können diese Nachricht explizit senden oder das Button_GetImageList Makro verwenden.
BCM_GETNOTE	Ruft den Text der Notiz ab, die einer Befehlslinkschaltfläche zugeordnet ist. Sie können diese Nachricht explizit senden oder das Button_GetNote Makro verwenden.
BCM_GETNOTELENGTH	Ruft die Länge des Notiztexts ab, der in der Beschreibung für eine Befehlslinkschaltfläche angezeigt werden kann. Senden Sie diese Nachricht explizit oder mithilfe des Button_GetNoteLength-Makros.
BCM_GETSPLITINFO	Ruft Informationen für ein Steuerelement für geteilte Schaltflächen ab. Senden Sie diese Nachricht explizit oder mithilfe des Button_GetSplitInfo Makros.
BCM_GETTEXTMARGIN	Ruft die Ränder ab, die zum Zeichnen von Text in einem Schaltflächensteuerelement verwendet werden. Sie können diese Nachricht explizit senden oder das Button_GetTextMargin Makro verwenden.
BCM_SETDROPDOWNSTATE	Legt den Dropdownstatus für eine Schaltfläche mit formatieren TBSTYLE_DROPDOWNfest. Senden Sie diese Nachricht explizit oder mithilfe des Button_SetDropDownState Makros.
BCM_SETIMAGELIST	Weist einem Schaltflächensteuerelement eine Bildliste zu. Sie können diese Nachricht explizit senden oder das Button_SetImageList Makro verwenden.
BCM_SETNOTE	Legt den Text der Notiz fest, die einer Befehlslinkschaltfläche zugeordnet ist. Sie können diese Nachricht explizit senden oder das Button_SetNote Makro verwenden.
BCM_SETSHIELD	Legt den erforderlichen Zustand für die Rechteerweiterung für eine angegebene Schaltfläche oder einen Befehlslink fest, um ein Symbol mit erhöhten Rechten anzuzeigen. Senden Sie diese Nachricht explizit oder mithilfe des Button_SetElevationRequiredState-Makros.
BCM_SETSPLITINFO	Legt Informationen für ein Steuerelement für geteilte Schaltflächen fest. Senden Sie diese Nachricht explizit oder mithilfe des Button_SetSplitInfo Makros.
BCM_SETTEXTMARGIN	Die BCM_SETTEXTMARGIN Meldung legt die Ränder für den Zeichnungstext in einem Schaltflächensteuerelement fest.
BM_CLICK	Simuliert, dass der Benutzer auf eine Schaltfläche klickt. Diese Nachricht bewirkt, dass die Schaltfläche die WM_LBUTTONDOWN und WM_LBUTTONUP Nachrichten empfängt und das übergeordnete Fenster der Schaltfläche einen BN_CLICKED Benachrichtigungscode empfängt.
BM_GETCHECK	Ruft den Kontrollkästchenstatus eines Optionsfelds oder Kontrollkästchens ab. Sie können diese Nachricht explizit senden oder das Button_GetCheck Makro verwenden.
BM_GETIMAGE	Ruft ein Handle zum Bild (Symbol oder Bitmap) ab, das der Schaltfläche zugeordnet ist.
BM_GETSTATE	Ruft den Status einer Schaltfläche oder eines Kontrollkästchens ab. Sie können diese Nachricht explizit senden oder das Button_GetState Makro verwenden.
BM_SETCHECK	Legt den Kontrollkästchenstatus eines Optionsfelds oder Kontrollkästchens fest. Sie können diese Nachricht explizit oder mithilfe des Button_SetCheck Makros senden.
BM_SETDONTCLICK	Legt ein Kennzeichen für ein Optionsfeld fest, das die Generierung von BN_CLICKED Nachrichten steuert, wenn die Schaltfläche den Fokus erhält.
BM_SETIMAGE	Ordnet ein neues Bild (Symbol oder Bitmap) der Schaltfläche zu.
BM_SETSTATE	Legt den Hervorhebungszustand einer Schaltfläche fest. Der Hervorhebungszustand gibt an, ob die Schaltfläche hervorgehoben ist, als ob der Benutzer sie gedrückt hatte. Sie können diese Nachricht explizit senden oder das Button_SetState Makro verwenden.
BM_SETSTYLE	Legt die Formatvorlage einer Schaltfläche fest. Sie können diese Nachricht explizit senden oder das Button_SetStyle Makro verwenden.

Benachrichtigungen

Thema	Inhalt
BCN_DROPDOWN	Wird gesendet, wenn der Benutzer auf einen Dropdownpfeil auf einer Schaltfläche klickt. Das übergeordnete Fenster des Steuerelements empfängt diesen Benachrichtigungscode in Form einer WM_NOTIFY Nachricht.
BCN_HOTITEMCHANGE	Benachrichtigt den Besitzer des Schaltflächensteuerelements, dass die Maus den Clientbereich des Schaltflächensteuerelements eingibt oder verlässt. Das Schaltflächensteuerelement sendet diesen Benachrichtigungscode in Form einer WM_NOTIFY Nachricht.
BN_CLICKED	Wird gesendet, wenn der Benutzer auf eine Schaltfläche klickt. Das übergeordnete Fenster der Schaltfläche empfängt den BN_CLICKED Benachrichtigungscode über die WM_COMMAND Nachricht.
BN_DBLCLK	Wird gesendet, wenn der Benutzer auf eine Schaltfläche doppelklicken soll. Dieser Benachrichtigungscode wird automatisch für die Schaltflächen BS_USERBUTTON, BS_RADIOBUTTONund BS_OWNERDRAW gesendet. Andere Schaltflächentypen senden BN_DBLCLK nur, wenn sie die BS_NOTIFY Formatvorlage aufweisen. Das übergeordnete Fenster der Schaltfläche empfängt den BN_DBLCLK Benachrichtigungscode über die WM_COMMAND Nachricht.
BN_DISABLE	Wird gesendet, wenn eine Schaltfläche deaktiviert ist. Hinweis: Dieser Benachrichtigungscode wird nur zur Kompatibilität mit 16-Bit-Versionen von Windows vor Version 3.0 bereitgestellt. Anwendungen sollten den BS_OWNERDRAW-Schaltflächenstil und die DRAWITEMSTRUCT- Struktur für diese Aufgabe verwenden. Das übergeordnete Fenster der Schaltfläche empfängt den BN_DISABLE Benachrichtigungscode über die WM_COMMAND Nachricht.
BN_DOUBLECLICKED	Wird gesendet, wenn der Benutzer auf eine Schaltfläche doppelklicken soll. Dieser Benachrichtigungscode wird automatisch für die Schaltflächen BS_USERBUTTON, BS_RADIOBUTTONund BS_OWNERDRAW gesendet. Andere Schaltflächentypen senden BN_DOUBLECLICKED nur, wenn sie über die BS_NOTIFY Formatvorlage verfügen. Das übergeordnete Fenster der Schaltfläche empfängt den BN_DOUBLECLICKED Benachrichtigungscode über die WM_COMMAND Nachricht.
BN_HILITE	Wird gesendet, wenn der Benutzer eine Schaltfläche auswählt. Hinweis: Dieser Benachrichtigungscode wird nur zur Kompatibilität mit 16-Bit-Versionen von Windows vor Version 3.0 bereitgestellt. Anwendungen sollten den BS_OWNERDRAW-Schaltflächenstil und die DRAWITEMSTRUCT- Struktur für diese Aufgabe verwenden. Das übergeordnete Fenster der Schaltfläche empfängt den BN_HILITE Benachrichtigungscode über die WM_COMMAND Nachricht.
BN_KILLFOCUS	Wird gesendet, wenn eine Schaltfläche den Tastaturfokus verliert. Die Schaltfläche muss über die BS_NOTIFY Formatvorlage verfügen, um diesen Benachrichtigungscode zu senden. Das übergeordnete Fenster der Schaltfläche empfängt den BN_KILLFOCUS Benachrichtigungscode über die WM_COMMAND Nachricht.
BN_PAINT	Gesendet, wenn eine Schaltfläche gezeichnet werden soll. Hinweis: Dieser Benachrichtigungscode wird nur zur Kompatibilität mit 16-Bit-Versionen von Windows vor Version 3.0 bereitgestellt. Anwendungen sollten den BS_OWNERDRAW-Schaltflächenstil und die DRAWITEMSTRUCT- Struktur für diese Aufgabe verwenden. Das übergeordnete Fenster der Schaltfläche empfängt den BN_PAINT Benachrichtigungscode über die WM_COMMAND Nachricht.
BN_PUSHED	Wird gesendet, wenn der Pushstatus einer Schaltfläche auf "Gedrückt" festgelegt ist. Hinweis: Dieser Benachrichtigungscode wird nur zur Kompatibilität mit 16-Bit-Versionen von Windows vor Version 3.0 bereitgestellt. Anwendungen sollten den BS_OWNERDRAW-Schaltflächenstil und die DRAWITEMSTRUCT- Struktur für diese Aufgabe verwenden. Das übergeordnete Fenster der Schaltfläche empfängt den BN_PUSHED Benachrichtigungscode über die WM_COMMAND Nachricht.
BN_SETFOCUS	Gesendet, wenn eine Schaltfläche den Tastaturfokus erhält. Die Schaltfläche muss über die BS_NOTIFY Formatvorlage verfügen, um diesen Benachrichtigungscode zu senden. Das übergeordnete Fenster der Schaltfläche empfängt den BN_SETFOCUS Benachrichtigungscode über die WM_COMMAND Nachricht.
BN_UNHILITE	Wird gesendet, wenn die Hervorhebung aus einer Schaltfläche entfernt werden soll. Hinweis: Dieser Benachrichtigungscode wird nur zur Kompatibilität mit 16-Bit-Versionen von Windows vor Version 3.0 bereitgestellt. Anwendungen sollten den BS_OWNERDRAW-Schaltflächenstil und die DRAWITEMSTRUCT- Struktur für diese Aufgabe verwenden. Das übergeordnete Fenster der Schaltfläche empfängt den BN_UNHILITE Benachrichtigungscode über die WM_COMMAND Nachricht.
BN_UNPUSHED	Wird gesendet, wenn der Pushstatus einer Schaltfläche auf "Entpuppen" festgelegt ist. Hinweis: Dieser Benachrichtigungscode wird nur zur Kompatibilität mit 16-Bit-Versionen von Windows vor Version 3.0 bereitgestellt. Anwendungen sollten den BS_OWNERDRAW-Schaltflächenstil und die DRAWITEMSTRUCT- Struktur für diese Aufgabe verwenden. Das übergeordnete Fenster der Schaltfläche empfängt den BN_UNPUSHED Benachrichtigungscode über die WM_COMMAND Nachricht.
NM_CUSTOMDRAW (Schaltfläche)	Benachrichtigt das übergeordnete Fenster eines Schaltflächensteuerelements über benutzerdefinierte Zeichenvorgänge auf der Schaltfläche. Das Schaltflächensteuerelement sendet diesen Benachrichtigungscode in Form einer WM_NOTIFY Nachricht.
WM_CTLCOLORBTN	Die WM_CTLCOLORBTN Nachricht wird vor dem Zeichnen der Schaltfläche an das übergeordnete Fenster einer Schaltfläche gesendet. Das übergeordnete Fenster kann die Text- und Hintergrundfarben der Schaltfläche ändern. Allerdings reagieren nur vom Besitzer gezeichnete Schaltflächen auf das übergeordnete Fenster, das diese Nachricht verarbeitet.

Strukturen

Thema	Inhalt
BUTTON_IMAGELIST	Enthält Informationen zu einer Bildliste, die mit einem Schaltflächensteuerelement verwendet wird.
BUTTON_SPLITINFO	Enthält Informationen, die eine geteilte Schaltfläche definieren (BS_SPLITBUTTON und BS_DEFSPLITBUTTON Formatvorlagen). Wird zusammen mit den nachrichten BCM_GETSPLITINFO und BCM_SETSPLITINFO verwendet.
NMBCDROPDOWN-	Enthält Informationen zu einer BCN_DROPDOWN-Benachrichtigung.
NMBCHOTITEM-	Enthält Informationen zur Bewegung der Maus über ein Schaltflächensteuerelement.

Konstanten

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

Freigeben über