WM_SETHOTKEY

Aplikacja wysyła wiadomość WM_SETHOTKEY okno, aby skojarzyć klawisz dostępu z okna. Gdy użytkownik naciśnie klawisz dostępu, system uaktywnia okno.

WM_SETHOTKEY wParam = MAKEWORD (WPARAM) (parametr vkey, Modyfikatory) / / kod klucza wirtualnego i modyfikatorów z gorąco fikcyjnymi klucza = 0;                                   / / nie używane; musi mieć wartość zero

Parametry

parametr vkey
Wartość wParam. Określa kod klucza wirtualnego i modyfikatorów klawisz dostępu do skojarzenia z okna. Kod klucza wirtualnego w bajcie parametru i flag modyfikujących są w bajcie. Ustawienie tego parametru na wartość NULL usuwa gorąco klucza skojarzonego z okna. Bajt modyfikator może być kombinacją następujących flag.
Wartość Znaczenie
HOTKEYF_ALT Klawisz ALT
HOTKEYF_CONTROL Klawisz CTRL
HOTKEYF_EXT Klucz rozszerzony
HOTKEYF_SHIFT Klawisz SHIFT

Zwraca wartości

Wartość zwracany jest jedną z następujących czynności:

Wartość Znaczenie
–1 Funkcja kończy się niepowodzeniem — klawisz dostępu jest nieprawidłowy.
..0 Funkcja kończy się niepowodzeniem — okno jest nieprawidłowy.
..1 Funkcja zakończy się powodzeniem, a żadne inne okno ma ten sam klawisz dostępu.
..2 Funkcja zakończy się powodzeniem, ale inne okno ma już ten sam klawisz dostępu.

Uwagi

Klawisz dostępu nie może być skojarzona z okna podrzędnego.

VK_ESCAPE, VK_SPACE i VK_TAB są nieprawidłowe klawisze dostępu.

Gdy użytkownik naciśnie klawisz dostępu, system generuje komunikat WM_SYSCOMMAND z wParam równą SC_HOTKEY i fikcyjnymi równa dojście do okna. Jeśli ten komunikat jest przekazywany do DefWindowProc, system przyniesie okna ostatni aktywny podręczne (jeśli istnieje) lub w oknie, sam (jeśli istnieje żadne okno podręczne) na pierwszym planie.

Okno może mieć tylko jeden klawisz dostępu. Jeśli okno ma już klawisz dostępu skojarzony z nim, nowy klawisz dostępu zastępuje starą. Jeżeli więcej niż jedno okno ma ten sam klawisz dostępu, okno, w którym jest uaktywniona przez klawisz dostępu jest losowa.

Te klawisze są niezwiązane z klawisze dostępu przez RegisterHotKey.

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.

Zobacz też

Przegląd danych wejściowych klawiatura, komunikaty wejściowe klawiatury, RegisterHotKey, WM_GETHOTKEY, WM_SYSCOMMAND

Index