GetKeyboardState

Funcția de GetKeyboardState copiază statutul de tastele virtuale 256 Tamponul specificat.

(BOOL GetKeyboardState PBYTE  lpKeyState / / indicatorul la matrice pentru a primi statutul datelor);
 

Parametrii

lpKeyState
Indicatorul pentru matricea de 256-byte care va primi statutul datelor pentru fiecare cheie virtual.

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

Cererea poate apela această funcție pentru a prelua starea curentă a toate tastele virtuale. Modificările statutului ca un fir elimină tastatură mesaje din coada sa mesaj. Starea nu schimba cât și tastatură mesaje sunt înregistrate la firul lui mesaj coadă, nici nu ca mesajele de tastatură sunt înregistrate sau adus la cozile de mesaje de alte fire. (Excepție: fire care sunt conectate prin intermediul AttachThreadInput partaja același stat tastatură.)

Atunci când funcția întoarce, fiecare membru al matricei a subliniat de parametrul lpKeyState conține date de stare pentru un cheie virtual. În cazul în care biți high-comandă este 1, cheia este în caz contrar, este de până. Dacă bit low-comandă este 1, cheia este toggled. O cheie, cum ar fi caps lock-cheie, este toggled dacă este activată. Cheia este oprit și untoggled dacă bit low-order este 0. O cheie de comutare indicatorul luminos (dacă există) pe tastatura va fi pe când cheia este toggled, și când cheia este untoggled.

Pentru a regăsi informații de stare pentru un cheie individuale, utilizați funcția GetKeyState . Pentru a prelua starea curentă pentru un cheie individuale indiferent dacă mesajul tastatură corespunzătoare a fost adus la coada de mesaj, utilizați funcția GetAsyncKeyState

Cererea poate utilizarea constantelor virtual-cheie code VK_SHIFT, VK_CONTROL și VK_MENU ca indici în matricea a subliniat de lpKeyState. Acest lucru dă starea shift, ctrl, sau tastele alt fără a face distincție între stânga și dreapta. Cererea poate utiliza, de asemenea, următoarele constante virtual-cheie code ca indici să se facă distinc?ia între cazurile stânga și la dreapta de acele chei.

VK_LSHIFT VK_RSHIFT
VK_LCONTROL VK_RCONTROL
VK_LMENU VK_RMENU

Aceste constante distinctiv de stânga ?i de dreapta sunt disponibile pentru o cerere numai prin GetKeyboardState, SetKeyboardState, GetAsyncKeyState, GetKeyStateși MapVirtualKey funcții.

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ă, GetKeyState, GetAsyncKeyState, MapVirtualKey, SetKeyboardState

Index