Freigeben über


Schaltfläche (Windows-Steuerelemente)

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.