RegisterHotKey

Funcţia RegisterHotKey defineşte o tastă de sistem-wide.

(BOOL RegisterHotKey HWND  hWnd, / / fereastra pentru a primi notificări hot-cheieint id, / / identificator de tastăUINTfsModifiers, / / cheie-modificator steaguriUINTVK / / virtual-cheie code);
 

Parametrii

hWnd

Ocupa în fereastra care va primi mesaje WM_HOTKEY generate de tastă. Dacă acest parametru este NULL, WM_HOTKEY mesaje sunt înregistrate la coada de mesaj fir de apel şi trebuie să fie prelucrate în bucla mesaj.

id-ul

Identificatorul cheii fierbinte. Nu alte tastă în asteptare thread ar trebui să aibă acelaşi identificator. Cererea trebuie să specificaţi o valoare în intervalul 0x0000 prin 0xBFFF. O bibliotecă cu legare dinamică (DLL) partajat trebuie să specificaţi o valoare în intervalul 0xC000 prin 0xFFFF (zona întors de GlobalAddAtom funcţia). Pentru a evita conflicte cu identificatori hot-cheie definit de alte biblioteci partajate, un DLL trebuie să utilizaţi funcţia GlobalAddAtom pentru a obţine identificatorul de hot-cheie.

fsModifiers

Specifică cheile de care trebuie să fie presat în combinaţie cu tasta specificat de parametrul nVirtKey pentru a genera WM_HOTKEY mesajul. Parametrul fsModifiers poate fi o combinaţie de următoarele valori.

Valoarea	Sensul
MOD_ALT	Fie tasta alt trebuie să fie men?inut în jos.
MOD_CONTROL	Fie tasta ctrl trebuie să fie men?inut în jos.
MOD_SHIFT	Fie tasta shift trebuie să fie men?inut în jos.
MOD_WIN	Fie Ferestre cheie a avut loc în jos. Aceste chei sunt etichetate cu sigla Microsoft Windows.

vk

Precizează codul virtual-key tastă.

Valorile întroarse

Dacă funcţia reuşeşte, valoarea returnată este nenul.

Dacă funcţia nu reuşeşte, valoarea returnată este zero. Pentru a obţine extins informa?ii eroare, apel GetLastError.

Observaţii

Atunci când se apasă o tastă, sistemul pare pentru un meci împotriva tuturor taste. La găsirea un meci, sistemul posturi mesaj WM_HOTKEY coada de mesaje de firul care înregistrate tastă. Acest mesaj este postat la începutul coada, astfel încât acesta este eliminat prin repetare următoare de bucla mesaj.

Această funcţie nu poate asocia o tastă cu o fereastră creat de un alt fir.

RegisterHotKey nu reuşeşte în cazul în care intrarile de la tastatura specificate pentru fierbinte cheie au fost înregistrate deja de o altă tastă fierbinte.

Dacă fereastra identificate de parametrul hWnd deja înregistrat o tastă cu acela?i identificator de ca specificat de parametrul de identitate , noile valori pentru parametrii fsModifiers şi vk înlocuiţi valorile specificate anterior pentru ace?ti parametri.

Windows CE: Versiunile Windows CE 2.0 şi mai târziu acceptă un steag suplimentare, numit MOD_KEYUP, pentru parametrul fsModifiers . Dacă setaţi pavilion MOD_KEYUP, fereastra va fi trimis un mesaj WM_HOTKEY pe o cheie până eveniment, precum şi de o cheie în jos eveniment.

RegisterHotKey poate fi folosit pentru a înregistra taste peste fire.

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.
Import Biblioteca:Utilizarea user32.lib.

A se vedea, de asemenea

Tastatură intrare prezentare generală, funcţii de Input tastatură, GlobalAddAtom, UnregisterHotKey, WM_HOTKEY

Index