RegisterHotKey

Funkcja RegisterHotKey definiuje klawisz dostępu systemowe.

(BOOL RegisterHotKey HWND  hWnd, / / okno, aby otrzymywać powiadomienie klawisz skrótuint id, / / identyfikator klawisz dostępuUINTfsModifiers, / / flags klawisz modyfikującyUINTVK / / klucza wirtualnego kodu);
 

Parametry

hWnd

Dojście do okna, który będzie odbierał WM_HOTKEY komunikatów generowanych przez klawisz dostępu. Jeśli ten parametr ma wartość NULL, WM_HOTKEY wiadomości są księgowane w kolejce wywołania wątku i muszą zostać przetworzone w pętli komunikatów.

identyfikator

Określa identyfikator klawisz dostępu. Nie innych klawisz dostępu w wywołania wątku powinna mieć ten sam identyfikator. Aplikacja musi określić wartość w zakresie 0x0000 poprzez 0xBFFF. Udostępnionej biblioteki dołączanej (dynamicznie DLL) należy określić wartość z zakresu 0xC000 poprzez 0xFFFF (zakres zwrócony przez GlobalAddAtom funkcji). Aby uniknąć konfliktów z identyfikatorami klawisz skrótu zdefiniowane przez inne udostępnionej biblioteki dll, biblioteka DLL należy używać funkcji GlobalAddAtom Aby uzyskać identyfikator klawisz skrótu.

fsModifiers

Określa klucze, które muszą być wciśnięte, w połączeniu z kluczem określonej przez parametr nVirtKey do generowania komunikatu WM_HOTKEY. Parametr fsModifiers może być kombinacją następujących wartości.

Wartość	Znaczenie
MOD_ALT	Albo klawisz musi pozostawać wciśnięty.
MOD_CONTROL	Albo klawisz ctrl muszą znajdować się w dół.
MOD_SHIFT	Albo klawisz shift musi odbyć się w dół.
MOD_WIN	Albo klawisz WINDOWS był wciśnięty. Klucze te są oznaczone logo Microsoft Windows.

vk

Określa kod klucza wirtualnego klawisz dostępu.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest różna od zera.

Jeśli funkcja zawiedzie, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Po naciśnięciu klawisza system wyszukuje meczu wszystkie klawisze. Po znalezieniu pasującego, system zaksięguje WM_HOTKEY wiadomości do kolejki wiadomości wątku, który zarejestrował klawisz dostępu. Ten komunikat jest księgowana na początek kolejki, jest ona usuwana przez następnej iteracji pętli komunikatów.

Tej funkcji nie można skojarzyć klawisz dostępu z okna utworzone przez inny wątek.

RegisterHotKey nie powiedzie się, jeśli naciśnięcia klawiszy dla klawisz dostępu już zostały zarejestrowane przez inny klawisz dostępu.

Jeśli okno określone przez parametr hWnd już zarejestrowany klawisz dostępu o tym samym identyfikatorze jako określonej przez parametr identyfikator , nowe wartości parametrów fsModifiers i vk zastąpienie poprzednio określonej wartości dla tych parametrów.

Systemu Windows CE: Wersje systemu Windows CE 2.0 i nowsze wersje obsługują dodatkową flagę, nazywane MOD_KEYUP, dla parametru fsModifiers . Ustawienie flagi MOD_KEYUP, okno będzie się wysłał komunikat WM_HOTKEY kluczem do zdarzenia, jak również kluczem dół zdarzeń.

RegisterHotKey może być używany do rejestracji klawisze różnych wątków.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Nieobsługiwane.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Użycie user32.lib.

Zobacz też

Przegląd danych wejściowych klawiatura, funkcji wprowadzania klawiatury, GlobalAddAtom, UnregisterHotKey, WM_HOTKEY

Index