Schaltfläche (Windows-Steuerelemente)

Dieser Abschnitt enthält Informationen zu den Programmierelementen, die mit Schaltflächen-Steuerelementen verwendet werden. Eine Schaltfläche ist ein Steuerelement, auf das der Benutzer klicken kann, um eine Eingabe für eine Anwendung zu ermöglichen.

Übersichten

Thema Inhalte
Schaltflächenmeldungen In diesem Thema werden Meldungen erläutert, die mit Schaltflächen verwendet werden.
Schaltflächenzustände In diesem Abschnitt wird erläutert, wie das Auswählen einer Schaltfläche den 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 sie bestimmte Aufgaben ausführen, die Schaltflächen zugeordnet sind.

Funktionen

Thema Inhalte
CheckDlgButton Ändert den Überprüfungszustand eines Schaltflächen-Steuerelements.
CheckCheckCheckButton 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 ( clears).
IsDlgButtonChecked Die IsDlgButtonChecked-Funktion bestimmt, ob ein Schaltflächen-Steuerelement aktiviert ist oder ob ein Schaltflächen-Steuerelement mit drei Zusicherungen aktiviert, deaktiviert oder unbestimmt ist.

Makros

Thema Inhalte
Schaltfläche _ "Aktivieren" Aktiviert oder deaktiviert eine Schaltfläche.
Schaltfläche _ "GetCheck" Ruft den Kontrollkästchenstatus eines Optionsfelds oder Kontrollkästchens ab. Sie können dieses Makro verwenden oder die BM _ GETCHECK-Nachricht explizit senden.
Schaltfläche _ "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.
Schaltfläche _ "GetImageList" Ruft die BUTTON _ IMAGELIST-Struktur ab, die die Bildliste beschreibt, die für ein Schaltflächen-Steuerelement festgelegt ist. Sie können dieses Makro verwenden oder die BCM _ GETIMAGELIST-Nachricht explizit senden.
Schaltfläche _ "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.
Schaltfläche _ "GetNoteLength" Ruft die Länge des Notiztexts ab, der möglicherweise in der Beschreibung für einen Befehlslink angezeigt wird. Verwenden Sie dieses Makro, oder senden Sie die BCM _ GETNOTELENGTH-Nachricht explizit.
Schaltfläche _ "GetSplitInfo" Ruft Informationen für ein angegebenes Geteilte Schaltflächen-Steuerelement ab. Verwenden Sie dieses Makro, oder senden Sie die _ BCM-GETSPLITINFO-Nachricht explizit.
Schaltfläche _ "GetState" Ruft den Kontrollkästchenstatus eines Optionsfelds oder Kontrollkästchens ab. Sie können dieses Makro verwenden oder die BM _ GETSTATE-Nachricht explizit senden.
Schaltfläche _ "GetText" Ruft den Text einer Schaltfläche ab.
Schaltfläche _ "GetTextLength" Ruft die Anzahl der Zeichen im Text einer Schaltfläche ab.
Schaltfläche _ "GetTextMargin" Ruft die Ränder ab, die zum Zeichnen von Text in einem Schaltflächen-Steuerelement verwendet werden. Sie können dieses Makro verwenden oder die BCM _ GETTEXTMARGIN-Nachricht explizit senden.
Schaltfläche _ "SetCheck" Legt den Häkchenzustand eines Optionsfelds oder Kontrollkästchens fest. Sie können dieses Makro verwenden oder die BM _ SETCHECK-Nachricht explizit senden.
Schaltfläche _ "SetDropDownState" Legt den Dropdownzustand für eine angegebene Schaltfläche im Format BS _ SPLITBUTTON fest. Verwenden Sie dieses Makro, oder senden Sie die _ BCM-Nachricht SETDROPDOWNSTATE explizit.
Schaltfläche _ "SetElevationRequiredState" Legt den erforderlichen Höhe-Zustand 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.
Schaltfläche _ "SetImageList" Weist einem Schaltflächen-Steuerelement eine Bildliste zu. Sie können dieses Makro verwenden oder die BCM _ SETIMAGELIST-Nachricht explizit senden.
Schaltfläche _ "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.
Schaltfläche _ "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.
Schaltfläche _ "SetState" Legt den Hervorhebungszustand einer Schaltfläche fest. Der Hervorhebungszustand gibt an, ob die Schaltfläche so hervorgehoben ist, als hätte der Benutzer sie gedrückt. 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.
Schaltfläche _ "SetText" Legt den Text einer Schaltfläche fest.
Schaltfläche _ "SetTextMargin" Legt die Ränder zum Zeichnen von Text in einem Schaltflächen-Steuerelement fest. Sie können dieses Makro verwenden oder die _ BCM-Nachricht SETTEXTMARGIN explizit senden.

Nachrichten

Thema Inhalte
BCM _ GETIDEALSIZE Ruft die Größe der Schaltfläche ab, die am besten zu ihrem 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 einem Schaltflächen-Steuerelement zugewiesene Bildliste beschreibt. 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 möglicherweise in der Beschreibung einer Befehlslinkschaltfläche angezeigt wird. 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ächen-Steuerelement verwendet werden. Sie können diese Nachricht explizit senden oder das Button _ GetTextMargin-Makro verwenden.
BCM _ SETDROPDOWNSTATE Legt den Dropdownzustand für eine Schaltfläche mit dem Format TBSTYLE _ DROPDOWN fest. Senden Sie diese Nachricht explizit oder mithilfe des _ Button SetDropDownState-Makros.
BCM _ SETIMAGELIST Weist einem Schaltflächen-Steuerelement 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 Höhe-Zustand 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-Nachricht SETTEXTMARGIN legt die Ränder zum Zeichnen von Text in einem Schaltflächen-Steuerelement fest.
BM _ CLICK Simuliert, dass der Benutzer auf eine Schaltfläche klickt. Diese Meldung bewirkt, dass die Schaltfläche die _ WM-LBUTTONDOWN- und _ WM-LBUTTONUP-Meldungen und das übergeordnete Fenster der Schaltfläche einen BN CLICKED-Benachrichtigungscode _ erhält.
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 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 Button _ GetState-Makro verwenden.
BM _ SETCHECK Legt den Häkchenzustand eines Optionsfelds oder Kontrollkästchens fest. Sie können diese Nachricht explizit oder mithilfe des Button _ SetCheck-Makros 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 Hervorhebungszustand einer Schaltfläche fest. Der Hervorhebungszustand gibt an, ob die Schaltfläche so hervorgehoben ist, als hätte der Benutzer sie gedrückt. Sie können diese Nachricht explizit senden oder das Button _ SetState-Makro verwenden.
BM _ SETSTYLE Legt den Stil einer Schaltfläche fest. Sie können diese Nachricht explizit senden oder das Button _ SetStyle-Makro 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ächensteuerfelds, dass die Maus in den Clientbereich des Schaltflächen-Steuerelements eintritt oder diesen verlässt. Das Schaltflächen-Steuerelement 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 WM_COMMAND Meldung.
BN_DBLCLK Wird gesendet, wenn der Benutzer auf eine Schaltfläche doppelklickt. Dieser Benachrichtigungscode wird automatisch für die Schaltflächen BS_USERBUTTON, BS_RADIOBUTTONund BS_OWNERDRAW gesendet. Andere Schaltflächentypen senden BN_DBLCLK, wenn sie den BS_NOTIFY haben.
Das übergeordnete Fenster der Schaltfläche empfängt den BN_DBLCLK Benachrichtigungscode über die WM_COMMAND Meldung.
BN_DISABLE Wird gesendet, wenn eine Schaltfläche deaktiviert ist.
[!Note]
Dieser Benachrichtigungscode wird nur zur Kompatibilität mit 16-Bit-Versionen von Windows 3.0 bereitgestellt. Anwendungen sollten den Stil BS_OWNERDRAW Schaltflächen 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 Meldung.
BN_DOUBLECLICKED Wird gesendet, wenn der Benutzer auf eine Schaltfläche doppelklickt. Dieser Benachrichtigungscode wird automatisch für die Schaltflächen BS_USERBUTTON, BS_RADIOBUTTONund BS_OWNERDRAW gesendet. Andere Schaltflächentypen senden BN_DOUBLECLICKED, wenn sie den BS_NOTIFY haben.
Das übergeordnete Fenster der Schaltfläche empfängt den BN_DOUBLECLICKED Benachrichtigungscode über die WM_COMMAND Meldung.
BN_HILITE Wird gesendet, wenn der Benutzer eine Schaltfläche auswählt.
[!Note]
Dieser Benachrichtigungscode wird nur zur Kompatibilität mit 16-Bit-Versionen von Windows 3.0 bereitgestellt. Anwendungen sollten den Stil BS_OWNERDRAW Schaltflächen und die DRAWITEMSTRUCT-Struktur für diese Aufgabe verwenden.


Das übergeordnete Fenster der Schaltfläche empfängt den BN_HILITE Benachrichtigungscode über WM_COMMAND Meldung.
BN_KILLFOCUS Wird gesendet, wenn eine Schaltfläche den Tastaturfokus verliert. Die Schaltfläche muss über den BS_NOTIFY verfügen, um diesen Benachrichtigungscode zu senden.
Das übergeordnete Fenster der Schaltfläche empfängt den BN_KILLFOCUS Benachrichtigungscode über die WM_COMMAND Meldung.
BN_PAINT Wird gesendet, wenn eine Schaltfläche gestrichen werden soll.
[!Note]
Dieser Benachrichtigungscode wird nur zur Kompatibilität mit 16-Bit-Versionen von Windows 3.0 bereitgestellt. Anwendungen sollten den Stil BS_OWNERDRAW Schaltflächen 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 Meldung.
BN_PUSHED Wird gesendet, wenn der Pushzustand einer Schaltfläche auf pushed festgelegt ist.
[!Note]
Dieser Benachrichtigungscode wird nur zur Kompatibilität mit 16-Bit-Versionen von Windows 3.0 bereitgestellt. Anwendungen sollten den Stil BS_OWNERDRAW Schaltflächen 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 Wird gesendet, wenn eine Schaltfläche den Tastaturfokus erhält. Die Schaltfläche muss den 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 Meldung.
BN_UNHILITE Wird gesendet, wenn die Hervorhebung aus einer Schaltfläche entfernt werden soll.
[!Note]
Dieser Benachrichtigungscode wird nur zur Kompatibilität mit 16-Bit-Versionen von Windows vor Version 3.0 bereitgestellt. Anwendungen sollten für diese Aufgabe den BS_OWNERDRAW Schaltflächenstil und die DRAWITEMSTRUCT-Struktur verwenden.


Das übergeordnete Fenster der Schaltfläche empfängt den BN_UNHILITE Benachrichtigungscode über die WM_COMMAND Meldung.
BN_UNPUSHED Wird gesendet, wenn der Pushzustand einer Schaltfläche auf "Nicht gesendet" festgelegt ist.
[!Note]
Dieser Benachrichtigungscode wird nur zur Kompatibilität mit 16-Bit-Versionen von Windows vor Version 3.0 bereitgestellt. Anwendungen sollten für diese Aufgabe den BS_OWNERDRAW Schaltflächenstil und die DRAWITEMSTRUCT-Struktur verwenden.


Das übergeordnete Fenster der Schaltfläche empfängt den BN_UNPUSHED Benachrichtigungscode über die WM_COMMAND Meldung.
NM_CUSTOMDRAW (Schaltfläche) Benachrichtigt das übergeordnete Fenster eines Schaltflächensteuerelements über benutzerdefinierte Zeichnen-Vorgä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 den Text und die Hintergrundfarben der Schaltfläche ändern. Allerdings reagieren nur vom Besitzer gezeichnete Schaltflächen auf das übergeordnete Fenster, das diese Meldung 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 unterteilte Schaltfläche definieren (BS _ SPLITBUTTON- und BS _ DEFSPLITBUTTON-Stile). Wird mit den Meldungen BCM _ GETSPLITINFO und BCM _ SETSPLITINFO verwendet.
NMBCDROPDOWN Enthält Informationen zu einer _ BCN-DROPDOWNbenachrichtigung.
NMBCHOTITEM Enthält Informationen zur Bewegung des Mauszeigers über ein Schaltflächensteuerelement.

Konstanten

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