WM_SETHOTKEY

O cerere de a trimite un mesaj WM_SETHOTKEY într-o fereastră a asocia o tastă cu fereastra. Atunci când utilizatorul apasă tasta fierbinte, sistemul activează fereastra.

WM_SETHOTKEY wParam = (WPARAM) MAKEWORD (vkey, modificatori) / / virtual-cheie code și modificatori de hot lParam cheie = 0;                                   / / nu sunt utilizate; trebuie să fie zero 

 

Parametrii

vkey
Valoarea wParam. Specifică virtual-cheie code și modificatori de tastă să se asocieze cu fereastra. Codul virtual-cheie este în octet scăzută din parametrul și steagurile modificator sunt în mare octet. Setarea acestui parametru la NULL elimină tastă asociate cu o fereastră. Octetul modificator pot fi o combinatie dintre steagurile de următoarele.
Valoarea Sensul
HOTKEYF_ALT Tasta ALT
HOTKEYF_CONTROL Tasta CTRL
HOTKEYF_EXT Cheie extins
HOTKEYF_SHIFT Tasta SHIFT

Valorile întroarse

Valoarea returnată este unul dintre următoarele:

Valoarea Sensul
–1 Funcția nu reușește — tastă este nevalid.
..0 Funcția nu reușește — fereastra nu este valid.
..1 Funcția este de succes, și nici o altă fereastră are aceeași tastă fierbinte.
..2 Funcția este de succes, dar o altă fereastră deja are aceeași tastă fierbinte.

Observații

O tastă nu pot fi asociate cu o fereastră de copil.

VK_ESCAPE, VK_SPACE și VK_TAB sunt incorecte taste.

Atunci când utilizatorul apasă tasta fierbinte, sistemul generează un mesaj de WM_SYSCOMMAND cu wParam egală cu SC_HOTKEY ?i lParam egal cu fereastra de mâner. Dacă acest mesaj este transmisă DefWindowProc, sistemul va aduce a ferestrei active ultima prin popup (dacă există) sau fereastra în sine (în cazul în care nu există nici o fereastră pop-up) în prim plan.

O fereastră poate avea doar o singură tastă. Dacă fereastra are deja o tastă asociate cu acesta, cheia fierbinte nou înlocuiește vechi. Dacă mai mult de o fereastra are aceeași tastă fierbinte, fereastra care este activat de tastă este aleatoare.

Aceste taste nu au legătură cu taste stabilit de RegisterHotKey.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Neacceptat.
Antet:A declarat în winuser.h.

A se vedea, de asemenea

Prezentare de Input tastatură, tastatură intrare mesaje, RegisterHotKey, WM_GETHOTKEY, WM_SYSCOMMAND

Index