GetKeyState

Funkcja GetKeyState pobiera stan określonego klucza wirtualnego. Stan określa, czy klucz jest w górę, w dół lub przełączana (wł., wył — przemian przy każdym naciśnięciu klawisza).

(GetKeyState krótko int  nVirtKey / / klucza wirtualnego kodu);

Parametry

nVirtKey: Określa klucz wirtualnych. Jeśli jest żądanej klucz wirtualnych litera lub cyfra (od a do Z, do z lub od 0 do 9), nVirtKey musi być ustawiona wartość ASCII tego znaku. Dla innych kluczy musi być kod klucza wirtualnego.
Jeśli używany jest układ klawiatury innej niż angielska, klawiszy wirtualnych z wartościami w zakres ASCII A do z i 0–9 służą do określania najbardziej klawiszy znaków. Na przykład układ klawiatura niemiecka, wirtualny klucz wartość ASCII O (0x4F) odwołanie do klucza "o" VK_OEM_1 odnosi się do klucza "o z umlaut".

Zwraca wartości

Wartość zwracany określa stan danego klucza wirtualnego, w następujący sposób:

Jeśli bit wysokich numerach jest 1, klucz jest wyłączony; w przeciwnym razie to wyczynia.
Jeżeli znaczący bit 1, klucz jest przełączana. Klucz, takie jak wersaliki zablokować klucz jest przełączana, jeśli jest włączona. Klucz jest wyłączona i untoggled w przypadku znaczący bit 0. Klawiszem przełączania wskaźnik światła (jeśli istnieją) na klawiaturze będzie, gdy klucz jest przełączana, i wyłączanie kiedy klucz jest untoggled.

Uwagi

Stan kluczowych wrócił z tej zmiany funkcji, jak dany wątek odczytuje klucza wiadomości z kolejki wiadomości. Stan nie odzwierciedlają stan poziom przerwań związanych ze sprzętem. Użyj funkcji GetAsyncKeyState do pobierania informacji.

Aplikacja wywołuje GetKeyState , w odpowiedzi na wiadomość wprowadzanie z klawiatury. Funkcja ta pobiera Państwo klucz został wygenerowany komunikat wejściowy.

Aby pobrać informacje stanu dla wszystkich klawiszy wirtualnych, należy użyć funkcji GetKeyboardState.

Aplikację można używać stałych kod klucza wirtualnego, VK_SHIFT, VK_CONTROL i VK_MENU jako wartości parametru nVirtKey . Daje to stan shift, ctrl lub alt, klawisze bez rozróżniania lewy i prawy. Aplikacja także można używać następujących stałych kod klucza wirtualnego jako wartości nVirtKey do rozróżniania między lewym i prawym wystąpienia tych kluczy.

VK_LSHIFT	VK_RSHIFT
VK_LCONTROL	VK_RCONTROL
VK_LMENU	VK_RMENU

Te stałe odróżniający lewej i prawej są dostępne do aplikacji tylko poprzez GetKeyboardState, SetKeyboardState, GetAsyncKeyState, GetKeyStatei MapVirtualKey funkcje.

Systemu Windows CE: Funkcję GetKeyState można tylko sprawdzić stan dół następujących klawiszy wirtualnych

VK_CONTROL

VK_SHIFT

VK_MENU

VK_LCONTROL

VK_LSHIFT

VK_LMENU

VK_RCONTROL

VK_RSHIFT

VK_RMENU

GetKeyState należy używać tylko sprawdzić stan włączono klucza wirtualnego VK_CAPITAL.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Użycie user32.lib.

Zobacz też

Przegląd danych wejściowych klawiatura, funkcji wprowadzania klawiatury, GetAsyncKeyState, GetKeyboardState, MapVirtualKey, SetKeyboardState

Index