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