GetKeyState

Die GetKeyState -Funktion Ruft den Status der angegebenen virtuellen Taste. Der Status gibt an, ob der Schlüssel oben, unten ist, oder eingeschaltet (on, off — abwechselnd jeweils die Taste wird gedrückt).

Kurze GetKeyState) Int  nVirtKey / / virtual-Key Code);
 

Parameter

nVirtKey

Gibt eine virtuelle Taste. Wenn die gewünschte virtuelle Taste einen Buchstaben oder eine Ziffer (A bis Z, a bis z oder 0 bis 9) ist, muss nVirtKey auf den ASCII-Wert dieses Zeichens festgelegt werden. Für andere Schlüssel muss ein virtueller Tastencode.

Wenn eine nicht-englische Tastaturlayout verwendet wird, werden virtuelle Tasten mit Werten in ASCII BereichA bis z und 0-9 zum Großteil die Zeichentasten angeben. Beispielsweise verweist für die deutsche Tastaturbelegung, die virtuelle Taste der Wert ASCII O (0x4F) auf die Taste "o", während VK_OEM_1 bezieht sich auf die Taste "o mit Umlaut".

Rückgabewerte

Der Rückgabewert gibt den Status der angegebenen virtuellen Taste, wie folgt:

• Wenn das höchstwertige Bit 1 ist, ist der Schlüssel nach unten; Ansonsten ist es bis.
• Wenn das niederwertige Bit 1 ist, wird die Taste umgeschaltet. Ein Schlüssel, wird wie z. B. die Feststelltaste Schlüssel umgeschaltet wenn es eingeschaltet ist. Der Schlüssel ist aus und untoggled wenn das niederwertige Bit 0 ist. Eine Umschalttaste-Statusanzeige (sofern vorhanden) auf der Tastatur werden, wenn die Taste umgeschaltet wird, und aus, wenn der Schlüssel untoggled ist.

Bemerkungen

Der Schlüssel Status zurückgegeben von dieser Funktionsänderungen wie ein bestimmten Thread wichtige Nachrichten aus der Warteschlange liest. Der Status spiegelt nicht den zugeordnete Hardware-Interrupt-Ebene-Zustand. Verwenden Sie die GetAsyncKeyState -Funktion, um Informationen abzurufen.

Eine Anwendung ruft GetKeyState in Reaktion auf eine Tastatur-Eingabe-Nachricht. Diese Funktion Ruft den Status des Schlüssels als input-Message generiert wurde.

Verwenden Sie zum Abrufen von Statusinformationen für alle virtuellen Schlüssel GetKeyboardState Funktion.

Eine Anwendung kann die virtual-Key Code-Konstanten VK_SHIFT, VK_CONTROL und VK_MENU als Werte für den nVirtKey -Parameter verwenden. Dies gibt den Status der UMSCHALT, STRG oder Alt-Taste, ohne Unterscheidung zwischen Links und rechts. Eine Anwendung können die folgenden virtuellen-Key Code-Konstanten als Werte für nVirtKey auch zwischen den linken und rechten Instanzen dieser Tasten unterscheiden.

Diese Links und rechts-Unterscheidung-Konstanten stehen für eine Anwendung nur durch die GetKeyboardState, SetKeyboardState, GetAsyncKeyState GetKeyStateund MapVirtualKey Funktionen.

Windows CE: Die GetKeyState -Funktion kann nur verwendet werden, um den down-Status der folgenden virtuellen Tasten zu überprüfen

VK_CONTROL

VK_SHIFT

VK_MENU

VK_LCONTROL

VK_LSHIFT

VK_LMENU

VK_RCONTROL

VK_RSHIFT

VK_RMENU

GetKeyState kann nur verwendet werden, im umgeschalteten Zustand des Schlüssels VK_CAPITAL virtuelle überprüfen.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.

Siehe auch

Übersicht über die Tastatur-Eingabe, Keyboard Input Funktionen, GetAsyncKeyState, GetKeyboardState, MapVirtualKey, SetKeyboardState

Index