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