Schaltfläche (Windows-Steuerelemente)

Artikel
06/13/2023

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 eine Eingabe für eine Anwendung bereitzustellen.

Übersichten

Thema	Inhalte
Schaltflächenmeldungen	In diesem Thema werden Nachrichten erläutert, die mit Schaltflächen verwendet werden.
Schaltflächenzustände	In diesem Abschnitt wird erläutert, wie das Auswählen 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.

Functions

Thema	Inhalte
CheckDlgButton	Ändert den Überprüfungsstatus eines Schaltflächensteuerelements.
CheckRadioButton	Fügt einem angegebenen Optionsfeld in einer Gruppe ein Häkchen hinzu (überprüft) und entfernt ein Häkchen aus allen anderen Optionsfeldern in der Gruppe.
IsDlgButtonChecked	Die IsDlgButtonChecked-Funktion bestimmt, ob ein Schaltflächensteuerelement aktiviert ist oder ob ein Schaltflächensteuerelement mit drei Status aktiviert, deaktiviert oder unbestimmt ist.

Makros

Thema	Inhalte
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 zu 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 BS_SPLITBUTTON fest. Verwenden Sie dieses Makro, oder senden Sie die BCM_SETDROPDOWNSTATE Nachricht explizit.
Button_SetElevationRequiredState	Legt den erforderlichen Höhenzustand für eine angegebene Schaltfläche oder einen angegebenen 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 Hervorhebungsstatus einer Schaltfläche fest. Der Hervorhebungszustand gibt an, ob die Schaltfläche hervorgehoben ist, als ob der Benutzer sie gepusht hätte. Sie können dieses Makro verwenden oder die BM_SETSTATE Nachricht explizit senden.
Button_SetStyle	Legt den Stil 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 das Zeichnen von Text in einem Schaltflächensteuerelement fest. Sie können dieses Makro verwenden oder die BCM_SETTEXTMARGIN-Nachricht explizit senden.

Nachrichten

Thema	Inhalte
BCM_GETIDEALSIZE	Ruft die Größe der Schaltfläche ab, die am besten zu Text und Bild passt, wenn eine Bildliste vorhanden ist. Sie können diese Nachricht explizit senden oder das Makro Button_GetIdealSize 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 Makro Button_GetImageList verwenden.
BCM_GETNOTE	Ruft den Text der Notiz ab, die einer Befehlslinkschaltfläche zugeordnet ist. Sie können diese Nachricht explizit senden oder das Makro Button_GetNote 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 makros Button_GetNoteLength .
BCM_GETSPLITINFO	Ruft Informationen für ein Steuerelement für geteilte Schaltflächen ab. Senden Sie diese Nachricht explizit oder mithilfe des Makros Button_GetSplitInfo .
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 Makro Button_GetTextMargin verwenden.
BCM_SETDROPDOWNSTATE	Legt den Dropdownstatus für eine Schaltfläche mit Stil TBSTYLE_DROPDOWN fest. Senden Sie diese Nachricht explizit oder mithilfe des Makros Button_SetDropDownState .
BCM_SETIMAGELIST	Weist einem Schaltflächensteuerelement eine Bildliste zu. Sie können diese Nachricht explizit senden oder das Makro Button_SetImageList verwenden.
BCM_SETNOTE	Legt den Text der Notiz fest, die einer Befehlslinkschaltfläche zugeordnet ist. Sie können diese Nachricht explizit senden oder das makro Button_SetNote verwenden.
BCM_SETSHIELD	Legt den erforderlichen Höhenzustand für eine angegebene Schaltfläche oder einen angegebenen Befehlslink fest, um ein Symbol mit erhöhten Rechten anzuzeigen. Senden Sie diese Nachricht explizit oder mithilfe des Makros Button_SetElevationRequiredState .
BCM_SETSPLITINFO	Legt Informationen für ein Steuerelement für geteilte Schaltflächen fest. Senden Sie diese Nachricht explizit oder mithilfe des makros Button_SetSplitInfo .
BCM_SETTEXTMARGIN	Die BCM_SETTEXTMARGIN Meldung legt die Ränder für das Zeichnen von Text in einem Schaltflächensteuerelement fest.
BM_CLICK	Simuliert den Benutzer, der auf eine Schaltfläche klickt. Diese Meldung bewirkt, dass die Schaltfläche die WM_LBUTTONDOWN und WM_LBUTTONUP Nachrichten empfängt, und das übergeordnete Fenster der Schaltfläche erhält einen BN_CLICKED Benachrichtigungscode.
BM_GETCHECK	Ruft den Kontrollkästchenstatus eines Optionsfelds oder Kontrollkästchens ab. Sie können diese Nachricht explizit senden oder das Makro Button_GetCheck verwenden.
BM_GETIMAGE	Ruft ein Handle für das Bild (Symbol oder Bitmap) ab, das der Schaltfläche zugeordnet ist.
BM_GETSTATE	Ruft den Zustand einer Schaltfläche oder eines Kontrollkästchens ab. Sie können diese Nachricht explizit senden oder das Makro Button_GetState verwenden.
BM_SETCHECK	Legt den Kontrollkästchenstatus eines Optionsfelds oder Kontrollkästchens fest. Sie können diese Nachricht explizit oder mithilfe des Makros Button_SetCheck senden.
BM_SETDONTCLICK	Legt ein Flag auf einem Optionsfeld fest, das die Generierung von BN_CLICKED Nachrichten steuert, wenn die Schaltfläche den Fokus erhält.
BM_SETIMAGE	Ordnet der Schaltfläche ein neues Bild (Symbol oder Bitmap) zu.
BM_SETSTATE	Legt den Hervorhebungsstatus einer Schaltfläche fest. Der Hervorhebungszustand gibt an, ob die Schaltfläche hervorgehoben ist, als ob der Benutzer sie gepusht hätte. Sie können diese Nachricht explizit senden oder das Makro Button_SetState verwenden.
BM_SETSTYLE	Legt den Stil einer Schaltfläche fest. Sie können diese Nachricht explizit senden oder das Makro Button_SetStyle verwenden.

Benachrichtigungen

Thema	Inhalte
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 Meldung.
BN_DBLCLK	Wird gesendet, wenn der Benutzer auf eine Schaltfläche doppelklicken. Dieser Benachrichtigungscode wird automatisch für schaltflächen BS_USERBUTTON, BS_RADIOBUTTON und BS_OWNERDRAW gesendet. Andere Schaltflächentypen senden nur BN_DBLCLK , wenn sie über das BS_NOTIFY-Format verfügen. 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 aus Gründen der Kompatibilität mit 16-Bit-Versionen von Windows vor Version 3.0 bereitgestellt. Anwendungen sollten für diese Aufgabe das BS_OWNERDRAW-Schaltflächenformat und die DRAWITEMSTRUCT-Struktur 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. Dieser Benachrichtigungscode wird automatisch für schaltflächen BS_USERBUTTON, BS_RADIOBUTTON und BS_OWNERDRAW gesendet. Andere Schaltflächentypen senden nur BN_DOUBLECLICKED , wenn sie über das BS_NOTIFY-Format 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 aus Gründen der Kompatibilität mit 16-Bit-Versionen von Windows vor Version 3.0 bereitgestellt. Anwendungen sollten für diese Aufgabe das BS_OWNERDRAW-Schaltflächenformat und die DRAWITEMSTRUCT-Struktur verwenden. Das übergeordnete Fenster der Schaltfläche empfängt den BN_HILITE Benachrichtigungscode über die WM_COMMAND Meldung.
BN_KILLFOCUS	Wird gesendet, wenn eine Schaltfläche den Tastaturfokus verliert. Die Schaltfläche muss den BS_NOTIFY Format aufweisen, um diesen Benachrichtigungscode zu senden. Das übergeordnete Fenster der Schaltfläche empfängt den BN_KILLFOCUS Benachrichtigungscode über die WM_COMMAND Nachricht.
BN_PAINT	Wird gesendet, wenn eine Schaltfläche gezeichnet werden soll. Hinweis: Dieser Benachrichtigungscode wird nur aus Gründen der Kompatibilität mit 16-Bit-Versionen von Windows vor Version 3.0 bereitgestellt. Anwendungen sollten für diese Aufgabe das BS_OWNERDRAW-Schaltflächenformat und die DRAWITEMSTRUCT-Struktur verwenden. Das übergeordnete Fenster der Schaltfläche empfängt den BN_PAINT Benachrichtigungscode über die WM_COMMAND Meldung.
BN_PUSHED	Wird gesendet, wenn der Druckzustand einer Schaltfläche auf pushen festgelegt ist. Hinweis: Dieser Benachrichtigungscode wird nur aus Gründen der Kompatibilität mit 16-Bit-Versionen von Windows vor Version 3.0 bereitgestellt. Anwendungen sollten für diese Aufgabe das BS_OWNERDRAW-Schaltflächenformat und die DRAWITEMSTRUCT-Struktur verwenden. Das übergeordnete Fenster der Schaltfläche empfängt den BN_PUSHED Benachrichtigungscode über die WM_COMMAND Meldung.
BN_SETFOCUS	Wird gesendet, wenn eine Schaltfläche den Tastaturfokus erhält. Die Schaltfläche muss die BS_NOTIFY Format aufweisen, 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 die BS_OWNERDRAW-Schaltflächenformat 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 Druckzustand einer Schaltfläche auf "unverpunt" festgelegt ist. Hinweis: Dieser Benachrichtigungscode wird nur zur Kompatibilität mit 16-Bit-Versionen von Windows vor Version 3.0 bereitgestellt. Anwendungen sollten die BS_OWNERDRAW-Schaltflächenformat 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 Zeichnungsvorgänge für die 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 den Text und die Hintergrundfarben der Schaltfläche ändern. Allerdings reagieren nur vom Besitzer gezeichnete Schaltflächen auf das übergeordnete Fenster, das diese Nachricht verarbeitet.

Strukturen

Thema	Inhalte
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 mit den BCM_GETSPLITINFO - und BCM_SETSPLITINFO-Nachrichten verwendet.
NMBCDROPDOWN	Enthält Informationen zu einer BCN_DROPDOWN Benachrichtigung.
NMBCHOTITEM	Enthält Informationen zur Bewegung der Maus über ein Schaltflächensteuerelement.

Konstanten

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