Udostępnij za pośrednictwem

Klasa CHotKeyCtrl

  • Artykuł

Udostępnia funkcje typowej kontrolki klucza gorącego systemu Windows.

Składnia

class CHotKeyCtrl : public CWnd

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CHotKeyCtrl::CHotKeyCtrl CHotKeyCtrl Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko opis
CHotKeyCtrl::Create Tworzy kontrolkę klucza gorącego CHotKeyCtrl i dołącza ją do obiektu.
CHotKeyCtrl::CreateEx Tworzy kontrolkę klucza gorącego z określonymi stylami rozszerzonymi systemu Windows i dołącza ją do CHotKeyCtrl obiektu.
CHotKeyCtrl::GetHotKey Pobiera kod klucza wirtualnego i flagi modyfikatora klucza gorącego z kontrolki klucza gorącego.
CHotKeyCtrl::GetHotKeyName Pobiera nazwę klucza w lokalnym zestawie znaków przypisanym do klucza gorącego.
CHotKeyCtrl::GetKeyName Pobiera nazwę klucza w lokalnym zestawie znaków przypisanym do określonego kodu klucza wirtualnego.
CHotKeyCtrl::SetHotKey Ustawia kombinację gorąca dla kontrolki gorąca.
CHotKeyCtrl::SetRules Definiuje nieprawidłowe kombinacje i domyślną kombinację modyfikatora dla kontrolki gorąca.

Uwagi

"Kontrolka klucza gorącego" to okno, które umożliwia użytkownikowi utworzenie klucza gorącego. "Hot Key" to kombinacja, którą użytkownik może nacisnąć, aby szybko wykonać akcję. (Na przykład użytkownik może utworzyć klucz gorący, który aktywuje dane okno i przenosi go do góry zamówienia Z). Kontrolka klucza gorącego wyświetla opcje użytkownika i zapewnia, że użytkownik wybierze prawidłową kombinację.

Ta kontrolka CHotKeyCtrl (i dlatego klasa) jest dostępna tylko dla programów działających w systemach Windows 95/98 i Windows NT w wersji 3.51 lub nowszej.

Gdy użytkownik wybrał kombinację, aplikacja może pobrać określoną kombinację z kontrolki i użyć komunikatu WM_SETHOTKEY w celu skonfigurowania klucza gorącego w systemie. Za każdym razem, gdy użytkownik naciśnie następnie Hot, z dowolnej części systemu, okno określone w komunikacie WM_SETHOTKEY odbiera komunikat WM_SYSCOMMAND określający SC_HOTKEY. Ten komunikat aktywuje okno, które go odbiera. Klucz gorący pozostaje prawidłowy do momentu zakończenia działania aplikacji o nazwie WM_SETHOTKEY.

Ten mechanizm różni się od obsługi klucza gorącego, który zależy od komunikatu WM_HOTKEY i funkcji RegisterHotKey i UnregisterHotKey .

Aby uzyskać więcej informacji na temat korzystania z programu CHotKeyCtrl, zobacz Controls and Using CHotKeyCtrl (Kontrolki i używanie CHotKeyCtrl).

Hierarchia dziedziczenia

Obiekt CObject

CCmdTarget

CWnd

CHotKeyCtrl

Wymagania

Nagłówek: afxcmn.h

CHotKeyCtrl::CHotKeyCtrl

CHotKeyCtrl Tworzy obiekt.

CHotKeyCtrl();

CHotKeyCtrl::Create

Tworzy kontrolkę klucza gorącego CHotKeyCtrl i dołącza ją do obiektu.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parametry

dwStyle
Określa styl kontrolki dostępu. Zastosuj dowolną kombinację stylów kontrolek. Aby uzyskać więcej informacji, zobacz Typowe style kontrolek w zestawie Windows SDK.

Rect
Określa rozmiar i położenie kontrolki klucza gorącego. Może to być obiekt CRect lub struktura RECT.

pParentWnd
Określa okno nadrzędne kontrolki klucza gorącego, zwykle CDialog. Nie może mieć wartości NULL.

Nid
Określa identyfikator kontrolki klucza gorącego.

Wartość zwracana

Bezzerowe, jeśli inicjowanie zakończyło się pomyślnie; w przeciwnym razie 0.

Uwagi

Obiekt jest konstruowany CHotKeyCtrl w dwóch krokach. Najpierw wywołaj konstruktor, a następnie wywołaj Createmetodę , która tworzy kontrolkę klucza gorącego CHotKeyCtrl i dołącza ją do obiektu.

Jeśli chcesz użyć rozszerzonych stylów okien z kontrolką, wywołaj metodę CreateEx zamiast Create.

CHotKeyCtrl::CreateEx

Wywołaj tę funkcję, aby utworzyć kontrolkę (okno podrzędne) i skojarz ją z obiektem CHotKeyCtrl .

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parametry

dwExStyle
Określa rozszerzony styl tworzonej kontrolki. Aby uzyskać listę rozszerzonych stylów systemu Windows, zobacz parametr dwExStyle dla polecenia CreateWindowEx w zestawie WINDOWS SDK.

dwStyle
Określa styl kontrolki dostępu. Zastosuj dowolną kombinację stylów kontrolek. Aby uzyskać więcej informacji, zobacz Typowe style kontrolek w zestawie Windows SDK.

Rect
Odwołanie do struktury RECT opisującej rozmiar i położenie okna do utworzenia w współrzędnych klienta pParentWnd.

pParentWnd
Wskaźnik do okna, który jest elementem nadrzędnym kontrolki.

Nid
Identyfikator okna podrzędnego kontrolki.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Użyj CreateEx zamiast opcji Utwórz, aby zastosować rozszerzone style systemu Windows określone przez WS_EX_ stylu rozszerzonego systemu Windows.

CHotKeyCtrl::GetHotKey

Pobiera kod klucza wirtualnego i flagi modyfikatora skrótu klawiaturowego z kontrolki gorąca.

DWORD GetHotKey() const;

void GetHotKey(
    WORD& wVirtualKeyCode,
    WORD& wModifiers) const;

Parametry

wVirtualKeyCode
[out] Wirtualny kod skrótu klawiaturowego. Aby uzyskać listę standardowych kodów kluczy wirtualnych, zobacz Winuser.h.

Moduły wModifiers
[out] Kombinacja bitowa (OR) flag wskazująca modyfikujące w skrótie klawiaturowym.

Flagi modyfikatora są następujące:

Flaga Odpowiedni klucz
HOTKEYF_ALT ALT — Klawisz
HOTKEYF_CONTROL CTRL
HOTKEYF_EXT Klucz rozszerzony
HOTKEYF_SHIFT SHIFT

Wartość zwracana

W pierwszej przeciążonej metodzie dword zawierający kod klucza wirtualnego i flagi modyfikatora. Bajt o niskiej kolejności wyrazu o niskiej kolejności zawiera kod klucza wirtualnego, bajt o wysokiej kolejności wyrazu o niskiej kolejności zawiera flagi modyfikatora, a wyraz o wysokiej kolejności to zero.

Uwagi

Kod klucza wirtualnego i modyfikujące razem definiują skrót klawiaturowy.

CHotKeyCtrl::GetHotKeyName

Wywołaj tę funkcję składową, aby uzyskać zlokalizowaną nazwę klucza gorącego.

CString GetHotKeyName() const;

Wartość zwracana

Zlokalizowana nazwa aktualnie wybranego klucza gorącego. Jeśli nie wybrano klucza gorącego, GetHotKeyName zwraca pusty ciąg.

Uwagi

Nazwa zwracana przez tę funkcję składową pochodzi ze sterownika klawiatury. Sterownik klawiatury nielokalizowanej można zainstalować w zlokalizowanej wersji systemu Windows i na odwrót.

CHotKeyCtrl::GetKeyName

Wywołaj tę funkcję składową, aby uzyskać zlokalizowaną nazwę klucza przypisanego do określonego kodu klucza wirtualnego.

static CString GetKeyName(
    UINT vk,
    BOOL fExtended);

Parametry

VK
Kod klucza wirtualnego.

fExtended
Jeśli kod klucza wirtualnego jest kluczem rozszerzonym, wartość TRUE; w przeciwnym razie FAŁSZ.

Wartość zwracana

Zlokalizowana nazwa klucza określonego przez parametr vk . Jeśli klucz nie ma zamapowanej nazwy, GetKeyName zwraca pusty ciąg.

Uwagi

Nazwa klucza zwracana przez tę funkcję pochodzi ze sterownika klawiatury, więc można zainstalować nielokalizowany sterownik klawiatury w zlokalizowanej wersji systemu Windows i na odwrót.

Przykład

CString str;
str = CHotKeyCtrl::GetKeyName(VK_CONTROL, FALSE);
// str is now "Ctrl", or the localized equivalent.

CHotKeyCtrl::SetHotKey

Ustawia skrót klawiaturowy dla kontrolki gorąca.

void SetHotKey(
    WORD wVirtualKeyCode,
    WORD wModifiers);

Parametry

wVirtualKeyCode
[in] Wirtualny kod skrótu klawiaturowego. Aby uzyskać listę standardowych kodów kluczy wirtualnych, zobacz Winuser.h.

Moduły wModifiers
[in] Kombinacja bitowa (OR) flag wskazująca modyfikujące w skrótie klawiaturowym.

Flagi modyfikatora są następujące:

Flaga Odpowiedni klucz
HOTKEYF_ALT ALT — Klawisz
HOTKEYF_CONTROL CTRL
HOTKEYF_EXT Klucz rozszerzony
HOTKEYF_SHIFT SHIFT

Uwagi

Kod klucza wirtualnego i modyfikujące razem definiują skrót klawiaturowy.

CHotKeyCtrl::SetRules

Wywołaj tę funkcję, aby zdefiniować nieprawidłowe kombinacje i domyślną kombinację modyfikatora dla kontrolki gorącego.

void SetRules(
    WORD wInvalidComb,
    WORD wModifiers);

Parametry

wInvalidComb
Tablica flag określających nieprawidłowe kombinacje. Może to być kombinacja następujących wartości:

  • HKCOMB_A ALT

  • HKCOMB_C CTRL

  • HKCOMB_CA CTRL+ALT

  • HKCOMB_NONE niezmodyfikowane klucze

  • HKCOMB_S SHIFT

  • HKCOMB_SA SHIFT+ALT

  • HKCOMB_SC SHIFT+CTRL

  • HKCOMB_SCA SHIFT+CTRL+ALT

Moduły wModifiers
Tablica flag, która określa kombinację do użycia, gdy użytkownik wprowadzi nieprawidłową kombinację. Aby uzyskać więcej informacji na temat flag modyfikatora, zobacz GetHotKey.

Uwagi

Gdy użytkownik wprowadzi nieprawidłową kombinację klucza, zdefiniowaną przez flagi określone w wInvalidComb, system używa operatora OR do łączenia kluczy wprowadzonych przez użytkownika z flagami określonymi w wModifiers. Wynikowa kombinacja jest konwertowana na ciąg, a następnie wyświetlana w kontrolce gorąca.

Zobacz też

Klasa CWnd
Wykres hierarchii