WM_SETHOTKEY zpráva

Odesláno do okna pro přidružení klávesové zkratky k oknem. Když uživatel stiskne klávesovou zkratku, systém aktivuje okno.

#define WM_SETHOTKEY                    0x0032

Parametry

wParam

Nízký bajt slova s nízkým pořadím určuje kód virtuálního klíče, který se má přidružit k oknům.

Vysoký bajt slova s nízkým pořadím může být jedna nebo více následujících hodnot z hodnoty CommCtrl.h.

Hodnota	Význam
HOTKEYF_ALT 0x04	Klávesa ALT
HOTKEYF_CONTROL 0x02	Klávesa CTRL
HOTKEYF_EXT 0x08	Rozšířený klíč
HOTKEYF_SHIFT 0x01	Klávesa SHIFT

Slovo wParam s vysokým pořadím je ignorováno.

Nastavení wParam na HODNOTU NULL odebere klávesovou zkratku přidruženou k oknům.

lParam

Tento parametr se nepoužívá.

Návratová hodnota

Návratová hodnota je jedna z následujících možností.

Návratová hodnota	Popis
-1	Funkce je neúspěšná; Klávesová zkratka je neplatná.
0	Funkce je neúspěšná; okno je neplatné.
1	Funkce je úspěšná a žádné jiné okno nemá stejné klávesové zkratky.
2	Funkce je úspěšná, ale další okno už má stejné klávesové zkratky.

Poznámky

Klávesová zkratka nemůže být přidružená k podřízené sadě.

VK_ESCAPE, VK_SPACE, VK_TAB a VK_PACKET jsou neplatné klávesové zkratky.

Když uživatel stiskne klávesovou zkratku, systém vygeneruje zprávu WM_SYSCOMMAND s wParam rovnajícím se SC_HOTKEY a lParam se rovná popisovači okna. Pokud se tato zpráva předá defWindowProc, systém přenese poslední aktivní místní okno okna (pokud existuje) nebo samotné okno (pokud neexistuje žádné automaticky otevírané okno) do popředí.

Okno může mít jenom jednu klávesu. Pokud už okno obsahuje přidruženou klávesovou zkratku, nahradí nová klávesová zkratka starou klávesu. Pokud má více než jedno okno stejnou klávesu, je okno aktivované klávesou hot key náhodné.

Tyto klávesové zkratky nesouvisejí s klávesovými zkratkami nastavenými pomocí RegisterHotKey.

Požadavky

Požadavek	Hodnota
Minimální podporovaný klient	Windows 2000 Professional [jenom desktopové aplikace]
Minimální podporovaný server	Windows 2000 Server [jenom desktopové aplikace]
Záhlaví	Winuser.h (včetně Windows.h)

Viz také

Odkaz

RegisterHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

Koncepční

Klávesnicový vstup