GetKeyState

De GetKeyState functie haalt de status van de opgegeven virtuele sleutel. Geeft de status aan of de sleutel omhoog, omlaag, of van een knevel gevoorzid (, off — afwisselend telkens de toets is ingedrukt).

Korte GetKeyState) int  nVirtKey / / virtuele-key code);
 

Parameters

nVirtKey

Hiermee geeft u een virtuele sleutel. Als de gewenste virtuele sleutel is een letter of cijfer (A tot en met Z, 0 tot en met 9 of a tot z), moeten nVirtKey worden ingesteld op de ASCII-waarde van het teken. Voor andere sleutels moet het een virtueel-sleutel code.

Als een niet-Engelse toetsenbordindeling wordt gebruikt, worden virtuele toetsen met waarden in het bereik ASCII A tot z en 0 tot en met 9 gebruikt om op te geven de meeste van de tekentoetsen. Bijvoorbeeld, voor de Duitse toetsenbordindeling, de virtuele sleutel van waarde ASCII-O (0x4F) verwijst naar de "o"-toets, terwijl VK_OEM_1 naar de sleutel "o met umlaut verwijst".

Retourwaarden

De retourwaarde geeft de status van de gegeven virtuele sleutel, als volgt:

• Als de hoge-bit 1 is, is de sleutel anders, het is.
• Als de lage-orde bit 1 is, is de sleutel een knevel gevoorzid. Of een sleutel, zoals de caps lock key, is uitgezet als deze is ingeschakeld. De sleutel is uitgeschakeld en untoggled als de lage-orde bit 0 is. Van de sleutel van een knevel indicator licht (indien aanwezig) op het toetsenbord zullen op wanneer de sleutel van een knevel wordt gevoorzid, en uit als de sleutel untoggled.

Opmerkingen

De belangrijke status terug van deze functie wijzigingen, zoals een bepaalde thread kernboodschappen van de berichtenwachtrij leest. De status weerspiegelt niet de interruptniveau staat die is gekoppeld aan de hardware. Gebruik de functie GetAsyncKeyState om die informatie te halen.

In antwoord op een bericht van toetsenbordinvoer roept een toepassing GetKeyState . Deze functie haalt de status van de toets wanneer het invoerbericht werd gegenereerd.

Gebruik de functie GetKeyboardState om ophalen staat informatie voor alle virtuele toetsen,.

Een toepassing kan de virtuele-code van de constanten VK_SHIFT, VK_CONTROL en VK_MENU gebruiken als waarden voor de parameter nVirtKey . Dit geeft de status van de shift, ctrl of alt toetsen zonder onderscheid te maken tussen links en rechts. Een toepassing kan ook de volgende virtuele-toonsoort wetboek constanten gebruiken als waarden voor nVirtKey onderscheid maken tussen de linker- en exemplaren van deze toetsen.

Deze onderscheiden links - en rechts constanten zijn beschikbaar voor een toepassing alleen door de GetKeyboardState, SetKeyboardState, GetAsyncKeyState, GetKeyStateen MapVirtualKey functies.

Windows CE: De GetKeyState functie kan alleen worden gebruikt om te controleren de ingedrukte toestand van de volgende virtuele toetsen

VK_CONTROL

VK_SHIFT

VK_MENU

VK_LCONTROL

VK_LSHIFT

VK_LMENU

VK_RCONTROL

VK_RSHIFT

VK_RMENU

GetKeyState kan alleen worden gebruikt om te controleren de toggled status van de virtuele toets VK_CAPITAL.

Syntaxisinfo

nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Versie 1.0 of hoger vereist.
Header:Verklaard in winuser.h.
Bibliotheek importeren:User32.lib gebruiken.

Zie ook

Toetsenbord Input overzicht, toetsenbord Input functies, GetAsyncKeyState, GetKeyboardState, MapVirtualKey, SetKeyboardState

Index