Sdílet prostřednictvím


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