Przycisk (kontrolki systemu Windows)
Ta sekcja zawiera informacje o elementach programowania używanych z kontrolkami przycisków. Przycisk to kontrolka, która użytkownik może kliknąć, aby podać dane wejściowe aplikacji.
Przeglądy
| Temat | Treść |
|---|---|
| komunikatów przycisków | W tym temacie omówiono komunikaty, które są używane z przyciskami. |
| stany przycisku | W tej sekcji omówiono sposób zmiany stanu przycisku i sposobu reagowania aplikacji. |
| Typy przycisków | W tym temacie omówiono różne rodzaje przycisków. |
| używanie przycisków | W tej sekcji opisano sposób wykonywania określonych zadań skojarzonych z przyciskami. |
Funkcje
| Temat | Treść |
|---|---|
| CheckDlgButton | Zmienia stan sprawdzania kontrolki przycisku. |
| CheckRadioButton | Dodaje znacznik wyboru do (sprawdzania) określonego przycisku radiowego w grupie i usuwa znacznik wyboru z (czyści) wszystkie inne przyciski radiowe w grupie. |
| IsDlgButtonChecked | Funkcja IsDlgButtonChecked określa, czy kontrolka przycisku jest sprawdzana, czy kontrolka przycisku trójstanowego jest zaznaczona, nie zaznaczona lub nieokreślona. |
Makra
| Temat | Treść |
|---|---|
| Button_Enable | Włącza lub wyłącza przycisk. |
| Button_GetCheck | Pobiera stan wyboru przycisku radiowego lub pola wyboru. Tego makra można użyć lub wysłać jawnie komunikat BM_GETCHECK. |
| Button_GetIdealSize | Pobiera rozmiar przycisku, który najlepiej pasuje do tekstu i obrazu, jeśli lista obrazów jest obecna. Tego makra można użyć lub jawnie wysłać komunikat BCM_GETIDEALSIZE. |
| Button_GetImageList | Pobiera strukturę BUTTON_IMAGELIST opisujący listę obrazów ustawioną dla kontrolki przycisku. Tego makra można użyć lub jawnie wysłać komunikat BCM_GETIMAGELIST. |
| Button_GetNote | Pobiera tekst notatki skojarzonej z przyciskiem linku polecenia. Tego makra można użyć lub jawnie wysłać komunikat BCM_GETNOTE. |
| Button_GetNoteLength | Pobiera długość tekstu notatki, który może być wyświetlany w opisie linku polecenia. Użyj tego makra lub wyślij jawnie komunikat BCM_GETNOTELENGTH. |
| Button_GetSplitInfo | Pobiera informacje dla określonej kontrolki przycisku podziału. Użyj tego makra lub wyślij jawnie komunikat BCM_GETSPLITINFO. |
| Button_GetState | Pobiera stan wyboru przycisku radiowego lub pola wyboru. Tego makra można użyć lub wysłać jawnie komunikat BM_GETSTATE. |
| Button_GetText | Pobiera tekst przycisku. |
| Button_GetTextLength | Pobiera liczbę znaków w tekście przycisku. |
| Button_GetTextMargin | Pobiera marginesy używane do rysowania tekstu w kontrolce przycisku. Tego makra można użyć lub wysłać jawnie komunikat BCM_GETTEXTMARGIN. |
| Button_SetCheck | Ustawia stan wyboru przycisku radiowego lub pola wyboru. Tego makra można użyć lub wysłać jawnie komunikat BM_SETCHECK. |
| Button_SetDropDownState | Ustawia stan listy rozwijanej dla określonego przycisku ze stylem BS_SPLITBUTTON. Użyj tego makra lub wyślij jawnie komunikat BCM_SETDROPDOWNSTATE. |
| Button_SetElevationRequiredState | Ustawia wymagany stan podniesienia uprawnień dla określonego przycisku lub linku polecenia, aby wyświetlić ikonę z podwyższonym poziomem uprawnień. Użyj tego makra lub wyślij jawnie komunikat BCM_SETSHIELD. |
| Button_SetImageList | Przypisuje listę obrazów do kontrolki przycisku. Tego makra można użyć lub wysłać jawnie komunikat BCM_SETIMAGELIST. |
| Button_SetNote | Ustawia tekst notatki skojarzonej z określonym przyciskiem linku polecenia. Tego makra można użyć lub wysłać jawnie komunikat BCM_SETNOTE. |
| Button_SetSplitInfo | Ustawia informacje dla określonej kontrolki przycisku podziału. Użyj tego makra lub wyślij jawnie komunikat BCM_SETSPLITINFO. |
| Button_SetState | Ustawia stan wyróżnienia przycisku. Stan wyróżnienia wskazuje, czy przycisk jest wyróżniony tak, jakby użytkownik go wypchnął. Tego makra można użyć lub jawnie wysłać komunikat BM_SETSTATE. |
| Button_SetStyle | Ustawia styl przycisku. Tego makra można użyć lub wysłać jawnie komunikat BM_SETSTYLE. |
| Button_SetText | Ustawia tekst przycisku. |
| Button_SetTextMargin | Ustawia marginesy tekstu rysunkowego w kontrolce przycisku. Tego makra można użyć lub wysłać jawnie komunikat BCM_SETTEXTMARGIN. |
Wiadomości
| Temat | Treść |
|---|---|
| BCM_GETIDEALSIZE | Pobiera rozmiar przycisku, który najlepiej pasuje do jego tekstu i obrazu, jeśli lista obrazów jest obecna. Tę wiadomość można wysłać jawnie lub użyć makra Button_GetIdealSize. |
| BCM_GETIMAGELIST | Pobiera strukturę BUTTON_IMAGELIST opisujący listę obrazów przypisaną do kontrolki przycisku. Tę wiadomość można wysłać jawnie lub użyć makra Button_GetImageList. |
| BCM_GETNOTE | Pobiera tekst notatki skojarzonej z przyciskiem linku polecenia. Tę wiadomość można wysłać jawnie lub użyć makra Button_GetNote. |
| BCM_GETNOTELENGTH | Pobiera długość tekstu notatki, który może być wyświetlany w opisie przycisku linku polecenia. Wyślij tę wiadomość jawnie lub przy użyciu makra Button_GetNoteLength. |
| BCM_GETSPLITINFO | Pobiera informacje dotyczące kontrolki przycisku podziału. Wyślij tę wiadomość jawnie lub przy użyciu makra Button_GetSplitInfo. |
| BCM_GETTEXTMARGIN | Pobiera marginesy używane do rysowania tekstu w kontrolce przycisku. Tę wiadomość można wysłać jawnie lub użyć makra Button_GetTextMargin. |
| BCM_SETDROPDOWNSTATE | Ustawia stan listy rozwijanej dla przycisku ze stylem TBSTYLE_DROPDOWN. Wyślij tę wiadomość jawnie lub przy użyciu makra Button_SetDropDownState. |
| BCM_SETIMAGELIST | Przypisuje listę obrazów do kontrolki przycisku. Tę wiadomość można wysłać jawnie lub użyć makra Button_SetImageList. |
| BCM_SETNOTE | Ustawia tekst notatki skojarzonej z przyciskiem linku polecenia. Tę wiadomość można wysłać jawnie lub użyć makra Button_SetNote. |
| BCM_SETSHIELD | Ustawia wymagany stan podniesienia uprawnień dla określonego przycisku lub linku polecenia, aby wyświetlić ikonę z podwyższonym poziomem uprawnień. Wyślij tę wiadomość jawnie lub przy użyciu makra Button_SetElevationRequiredState. |
| BCM_SETSPLITINFO | Ustawia informacje dotyczące kontrolki przycisku podziału. Wyślij tę wiadomość jawnie lub przy użyciu makra Button_SetSplitInfo. |
| BCM_SETTEXTMARGIN | Komunikat BCM_SETTEXTMARGIN ustawia marginesy tekstu rysunkowego w kontrolce przycisku. |
| BM_CLICK | Symuluje kliknięcie przycisku przez użytkownika. Ten komunikat powoduje, że przycisk odbiera komunikaty WM_LBUTTONDOWN i WM_LBUTTONUP oraz okno nadrzędne przycisku odbiera kod powiadomienia BN_CLICKED. |
| BM_GETCHECK | Pobiera stan wyboru przycisku radiowego lub pola wyboru. Tę wiadomość można wysłać jawnie lub użyć makra Button_GetCheck. |
| BM_GETIMAGE | Pobiera uchwyt do obrazu (ikona lub mapa bitowa) skojarzony z przyciskiem . |
| BM_GETSTATE | Pobiera stan przycisku lub pola wyboru. Tę wiadomość można wysłać jawnie lub użyć makra Button_GetState. |
| BM_SETCHECK | Ustawia stan wyboru przycisku radiowego lub pola wyboru. Tę wiadomość można wysłać jawnie lub przy użyciu makra Button_SetCheck. |
| BM_SETDONTCLICK | Ustawia flagę na przycisku radiowym, który kontroluje generowanie komunikatów BN_CLICKED, gdy przycisk odbiera fokus. |
| BM_SETIMAGE | Kojarzy nowy obraz (ikona lub mapa bitowa) z przyciskiem . |
| BM_SETSTATE | Ustawia stan wyróżnienia przycisku. Stan wyróżnienia wskazuje, czy przycisk jest wyróżniony tak, jakby użytkownik go wypchnął. Tę wiadomość można wysłać jawnie lub użyć makra Button_SetState. |
| BM_SETSTYLE | Ustawia styl przycisku. Tę wiadomość można wysłać jawnie lub użyć makra Button_SetStyle. |
Powiadomienia
| Temat | Treść |
|---|---|
| BCN_DROPDOWN | Wysłane, gdy użytkownik kliknie strzałkę listy rozwijanej na przycisku. Okno nadrzędne kontrolki odbiera ten kod powiadomienia w postaci komunikatu WM_NOTIFY. |
| BCN_HOTITEMCHANGE | Powiadamia właściciela kontrolki przycisku, że mysz wprowadza lub opuszcza obszar klienta kontrolki przycisku. Kontrolka przycisku wysyła ten kod powiadomienia w postaci komunikatu WM_NOTIFY. |
| BN_CLICKED | Wysłane, gdy użytkownik kliknie przycisk. Okno nadrzędne przycisku odbiera kod powiadomienia BN_CLICKED za pośrednictwem komunikatu WM_COMMAND. |
| BN_DBLCLK | Wysłane, gdy użytkownik kliknie dwukrotnie przycisk. Ten kod powiadomienia jest wysyłany automatycznie dla przycisków BS_USERBUTTON, BS_RADIOBUTTONi BS_OWNERDRAW. Inne typy przycisków wysyłają BN_DBLCLK tylko wtedy, gdy mają styl BS_NOTIFY. Okno nadrzędne przycisku odbiera kod powiadomienia BN_DBLCLK za pośrednictwem komunikatu WM_COMMAND. |
| BN_DISABLE | Wysyłane, gdy przycisk jest wyłączony.
Uwaga: Ten kod powiadomienia jest dostarczany tylko w celu zapewnienia zgodności z 16-bitowymi wersjami systemu Windows starszym niż wersja 3.0. Aplikacje powinny używać stylu przycisku BS_OWNERDRAW i struktury DRAWITEMSTRUCT dla tego zadania. Okno nadrzędne przycisku odbiera kod powiadomienia BN_DISABLE za pośrednictwem komunikatu WM_COMMAND. |
| BN_DOUBLECLICKED | Wysłane, gdy użytkownik kliknie dwukrotnie przycisk. Ten kod powiadomienia jest wysyłany automatycznie dla przycisków BS_USERBUTTON, BS_RADIOBUTTONi BS_OWNERDRAW. Inne typy przycisków wysyłają BN_DOUBLECLICKED tylko wtedy, gdy mają styl BS_NOTIFY. Okno nadrzędne przycisku odbiera kod powiadomienia BN_DOUBLECLICKED za pośrednictwem komunikatu WM_COMMAND. |
| BN_HILITE | Wysłane, gdy użytkownik wybierze przycisk.
Uwaga: Ten kod powiadomienia jest dostarczany tylko w celu zapewnienia zgodności z 16-bitowymi wersjami systemu Windows starszym niż wersja 3.0. Aplikacje powinny używać stylu przycisku BS_OWNERDRAW i struktury DRAWITEMSTRUCT dla tego zadania. Okno nadrzędne przycisku odbiera kod powiadomienia BN_HILITE za pośrednictwem komunikatu WM_COMMAND. |
| BN_KILLFOCUS | Wysyłane, gdy przycisk traci fokus klawiatury. Przycisk musi mieć styl BS_NOTIFY, aby wysłać ten kod powiadomienia. Okno nadrzędne przycisku odbiera kod powiadomienia BN_KILLFOCUS za pośrednictwem komunikatu WM_COMMAND. |
| BN_PAINT | Wysłane, gdy przycisk powinien być malowany.
Uwaga: Ten kod powiadomienia jest dostarczany tylko w celu zapewnienia zgodności z 16-bitowymi wersjami systemu Windows starszym niż wersja 3.0. Aplikacje powinny używać stylu przycisku BS_OWNERDRAW i struktury DRAWITEMSTRUCT dla tego zadania. Okno nadrzędne przycisku odbiera kod powiadomienia BN_PAINT za pośrednictwem komunikatu WM_COMMAND. |
| BN_PUSHED | Wysyłane, gdy stan wypychania przycisku jest ustawiony na wypchnięcie.
Uwaga: Ten kod powiadomienia jest dostarczany tylko w celu zapewnienia zgodności z 16-bitowymi wersjami systemu Windows starszym niż wersja 3.0. Aplikacje powinny używać stylu przycisku BS_OWNERDRAW i struktury DRAWITEMSTRUCT dla tego zadania. Okno nadrzędne przycisku odbiera kod powiadomienia BN_PUSHED za pośrednictwem komunikatu WM_COMMAND. |
| BN_SETFOCUS | Wysłane, gdy przycisk odbiera fokus klawiatury. Przycisk musi mieć styl BS_NOTIFY, aby wysłać ten kod powiadomienia. Okno nadrzędne przycisku odbiera kod powiadomienia BN_SETFOCUS za pośrednictwem komunikatu WM_COMMAND. |
| BN_UNHILITE | Wysłane po usunięciu wyróżnienia z przycisku.
Uwaga: Ten kod powiadomienia jest dostarczany tylko w celu zapewnienia zgodności z 16-bitowymi wersjami systemu Windows starszym niż wersja 3.0. Aplikacje powinny używać stylu przycisku BS_OWNERDRAW i struktury DRAWITEMSTRUCT dla tego zadania. Okno nadrzędne przycisku odbiera kod powiadomienia BN_UNHILITE za pośrednictwem komunikatu WM_COMMAND. |
| BN_UNPUSHED | Wysyłane po ustawieniu stanu wypychania przycisku na wartość unpushed.
Uwaga: Ten kod powiadomienia jest dostarczany tylko w celu zapewnienia zgodności z 16-bitowymi wersjami systemu Windows starszym niż wersja 3.0. Aplikacje powinny używać stylu przycisku BS_OWNERDRAW i struktury DRAWITEMSTRUCT dla tego zadania. Okno nadrzędne przycisku odbiera kod powiadomienia BN_UNPUSHED za pośrednictwem komunikatu WM_COMMAND. |
| NM_CUSTOMDRAW (przycisk) | Powiadamia okno nadrzędne kontrolki przycisku o niestandardowych operacjach rysowania na przycisku. Kontrolka przycisku wysyła ten kod powiadomienia w postaci komunikatu WM_NOTIFY. |
| WM_CTLCOLORBTN | Komunikat WM_CTLCOLORBTN jest wysyłany do okna nadrzędnego przycisku przed rysowaniem przycisku. Okno nadrzędne może zmienić tekst i kolory tła przycisku. Jednak tylko przyciski narysowane przez właściciela odpowiadają na okno nadrzędne przetwarzają ten komunikat. |
Struktur
| Temat | Treść |
|---|---|
| BUTTON_IMAGELIST | Zawiera informacje o liście obrazów używanej z kontrolką przycisku. |
| BUTTON_SPLITINFO | Zawiera informacje definiujące przycisk podziału (styleBS_SPLITBUTTON i BS_DEFSPLITBUTTON). Używany z komunikatami BCM_GETSPLITINFO i BCM_SETSPLITINFO. |
| NMBCDROPDOWN | Zawiera informacje o powiadomieniu BCN_DROPDOWN. |
| NMBCHOTITEM | Zawiera informacje o ruchu myszy nad kontrolką przycisku. |
Stałe
| Temat | Treść |
|---|---|
| style przycisków | Określa kombinację stylów przycisków. Jeśli utworzysz przycisk przy użyciu klasy BUTTON z CreateWindow lub createWindowEx funkcji, możesz określić dowolny z stylów przycisków wymienionych poniżej. |