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] 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] 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] 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] 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] 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] 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. |