WM_SETHOTKEY üzenet

Egy ablakba küldve egy gyorsbillentyűt társíthat az ablakhoz. Amikor a felhasználó lenyomja a gyorsbillentyűt, a rendszer aktiválja az ablakot.

#define WM_SETHOTKEY                    0x0032

Paraméterek

wParam

Az alacsonyrendű szó kis bájtja határozza meg az ablakhoz társítandó virtuáliskulcs-kódot.

Az alacsonyrendű szó magas bájtja a CommCtrl.h következő értékei közül egy vagy több lehet.

Érték	Értelmezés
HOTKEYF_ALT 0x04	ALT billentyű
HOTKEYF_CONTROL 0x02	CTRL billentyű
HOTKEYF_EXT 0x08	Bővített kulcs
HOTKEYF_SHIFT 0x01	SHIFT billentyű

A wParam magasrendű szava figyelmen kívül lesz hagyva.

A wParamnull értékre állítása eltávolítja az ablakhoz társított gyorsbillentyűt.

lParam

Ezt a paramétert nem használja a rendszer.

Visszaadott érték

A visszatérési érték az alábbiak egyike.

Visszaadott érték	Leírás
-1	A függvény sikertelen; a gyorsbillentyű érvénytelen.
0	A függvény sikertelen; az ablak érvénytelen.
1	A függvény sikeres, és egyetlen másik ablak sem rendelkezik ugyanazzal a gyorsbillentyű-kulccsal.
2	A függvény sikeres, de egy másik ablakban már ugyanaz a gyorsbillentyű található.

Megjegyzések

A gyakori elérésű kulcsok nem társíthatók gyermekablakhoz.

VK_ESCAPE, VK_SPACE, VK_TAB és VK_PACKET érvénytelen gyorsbillentyűk.

Amikor a felhasználó lenyomja a gyorsbillentyűt, a rendszer létrehoz egy WM_SYSCOMMAND üzenetet, amelynek wParam értéke SC_HOTKEY , az lParam pedig az ablak fogópontjával egyenlő. Ha ezt az üzenetet a Rendszer átadja a DefWindowProc-nak, a rendszer az ablak utolsó aktív előugró ablakát (ha létezik), vagy magát az ablakot (ha nincs előugró ablak) az előtérbe.

Egy ablakban csak egy gyorsbillentyű lehet. Ha az ablakhoz már tartozik egy gyorsbillentyű, az új gyorsbillentyű lecseréli a régit. Ha több ablak is rendelkezik ugyanazzal a gyorsbillentyűvel, a gyorsbillentyű által aktivált ablak véletlenszerű.

Ezek a gyorsbillentyűk nem kapcsolódnak a RegisterHotKey által beállított gyorsbillentyűkhöz.

Követelmények

Követelmény	Érték
Minimálisan támogatott ügyfél	Windows 2000 Professional [csak asztali alkalmazások]
Minimálisan támogatott kiszolgáló	Windows 2000 Server [csak asztali alkalmazások]
Fejléc	Winuser.h (a Windows.h is)

Lásd még

Utalás

RegisterHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

Koncepcionális

Billentyűzetbemenet