GetKeyboardState

Składnia

Argumenty

Argument	Opis
lpKeyState	256-bajtowa tablica, która otrzyma stan każdego wirtualnego klawisza.

Zwracana wartość

Jeśli funkcja wykona swoje zadanie, zwrócona wartość będzie niezerowa. W przeciwnym wypadku wyniesie ona 0. Aby uzyskać szczegółowe informacje o błędzie, użyj _{» WinAPI ♦} GetLastError.

Opis szczegółowy

Funkcja GetKeyboardState kopiuje stan 256 wirtualnych klawiszy do podanego bufora. Jeśli wyższy bajt danego elementu klawisza jest ustawiony na 1, klawisz ten jest wciśnięty. Jeśli klawisz jest przełączany (np. Caps Lock), niższy bajt jest ustawiony na 1, gdy klawisz jest aktywny, lub na 0 w przeciwnym wypadku. Aby uzyskać wyższe lub niższe bajty, użyj makr _{» WinAPI ♦} HIWORD lub _{» WinAPI ♦} LOWORD.

Status zmienia się, kiedy wątek usunie daną wiadomość ze swojej kolejki komunikatów. Ani podczas wysyłania wiadomości do kolejki, ani podczas wysyłania lub usuwania wiadomości z kolejki komunikatów innego wątku, status nie jest zmieniany.

Do uzyskania informacji o indywidualnym klawiszu służy funkcja GetKeyState. Możesz też użyć GetAsyncKeyState, aby otrzymać tą informację niezależnie od tego, czy odpowiednia wiadomość została pobrana z kolejki komunikatów.

Aplikacje mogą używać następujących stałych wirtualnych klawiszy jako indeksów do tablicy wskazywanej przez lpKeyState:

• VK_LSHIFT
• VK_RSHIFT
• VK_LCONTROL
• VK_RCONTROL
• VK_LMENU
• VK_RMENU

Te stałe mogą być używane tylko w funkcjach GetKeyboardState, SetKeyboardState, GetAsyncKeyState, GetKeyState i MapVirtualKey.

Wymagania

Minimalny obsługiwany klient	Windows 2000 Professional
Minimalny obsługiwany serwer	Windows 2000 Server
Nagłówek	Winuser.h (wewnątrz Windows.h)
Biblioteka	User32.lib
DLL	User32.dll

Zagadnienia powiązane

BlockInput	Blokuje wszystkie zdarzenia pochodzące od klawiatury i myszy. (funkcja)

Linki zewnętrzne

• http://msdn.microsoft.com/en-us/library/windows/desktop/ms646299(v=vs.85).aspx