GetKeyboardState

Funksjonen GetKeyboardState kopierer statusen til 256 virtuelle tastene til angitt buffer.

BOOL GetKeyboardState) PBYTE  lpKeyState / / peker til matrisen for å motta statusdataene);
 

Parametere

lpKeyState
Pekeren til 256-byte-matrise som skal motta statusdataene for hver virtuelle nøkkel.

Returverdier

Hvis funksjonen lykkes, er returverdien ikke-null.

Hvis funksjonen mislykkes, er verdien som returneres Null. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.

Merknader

Et program kan kalle denne funksjonen til å hente gjeldende status for alle virtuelle tastene. Statusendringer som en tråd fjerner tastaturet meldinger fra målkøen for meldingen. Statusen endres ikke som posteres tastaturet meldinger til meldingskøen trådens, og heller ikke does den endre som tastaturet meldinger som er postert til eller Hentet fra meldingskøer av andre tråder. (Unntak: tråder som er koblet via AttachThreadInput dele samme tastatur tilstand.)

Når funksjonen returnerer, inneholder hvert medlem av matrisen som parameteren lpKeyState peker til statusen data for en virtuell nøkkel. Hvis den signifikante biten er 1, er nøkkelen ned; Ellers er det opp. Hvis den signifikante biten er 1, skrus på-tasten. En nøkkel, skrus som caps lock-tasten, hvis den er slått på. Nøkkelen er deaktivert, og untoggled hvis den signifikante biten er 0. En veksleknapp lampen (Hvis noen) på tastaturet vil være på når nøkkelen er aktivert/deaktivert, og av når nøkkelen er untoggled.

Hvis du vil hente statusinformasjon for en individuelle nøkkel, kan du bruke funksjonen GetKeyState . Hvis du vil hente gjeldende status for en individuell nøkkel uavhengig av om tilsvarende tastatur meldingen har blitt hentet fra meldingskøen, bruk GetAsyncKeyState -funksjonen

Et program kan bruke virtuelle tastekode konstantene VK_SHIFT, VK_CONTROL og VK_MENU som indekser i matrisen som lpKeyStatepeker til. Dette gir statusen på Skift, ctrl eller alt-tastene uten å skille mellom venstre og høyre. Et program kan også bruke følgende virtuellnøkkelkoden-konstanter som indekser til å skille mellom venstre og høyre forekomstene av disse nøklene.

VK_LSHIFT VK_RSHIFT
VK_LCONTROL VK_RCONTROL
VK_LMENU VK_RMENU

Disse konstantene med venstre - og høyre-atskillende er tilgjengelig for en applikasjon bare gjennom funksjonene GetKeyboardState, SetKeyboardState, GetAsyncKeyState, GetKeyStateog MapVirtualKey.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Som ikke støttes.
Topptekst:Deklarert i winuser.h.
Importere biblioteket:Bruk user32.lib.

Se også

Tastatur Input oversikt, tastatur Input funksjoner, GetKeyState, GetAsyncKeyState, MapVirtualKey, SetKeyboardState

Index