GetKeyboardState

Funkcja GetKeyboardState kopiuje stan 256 klawiszy wirtualnych do buforu.

(BOOL GetKeyboardState PBYTE  lpKeyState / / wskaźnik tablicy do odbierania danych stanu);
 

Parametry

lpKeyState
Wskaźnik tablicy 256 bajtów, który będzie odbierał dane stanu dla każdego klucza wirtualnego.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest różna od zera.

Jeśli funkcja zawiedzie, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Aplikacja może wywołać tej funkcji Pobierz bieżący stan wszystkich klawiszy wirtualnych. Zmiany statusu, jak wątek usuwa klawiatury wiadomości z kolejki wiadomości. Stan nie zmienia się, jak klawiatury wiadomości są księgowane w wątku wiadomości kolejki, ani nie zmienia klawiatury wiadomości są księgowane lub źródło kolejki wiadomości innych wątków. (Wyjątek: wątków, które są połączone za pośrednictwem AttachThreadInput udział ten sam stan klawiatury.)

Gdy funkcja zwraca, każdy członek tablicy wskazywanego przez parametr lpKeyState zawiera stan danych klucza wirtualnego. Jeśli bit wysokich numerach jest 1, klucz jest wyłączony; w przeciwnym wypadku jest w górę. 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.

Aby pobrać informacje o stanie dla poszczególnych kluczy, należy użyć funkcji GetKeyState . Aby pobrać bieżący stan dla poszczególnych klucza niezależnie od tego, czy odpowiedni komunikat klawiatury zostały pobrane z kolejki wiadomości, należy użyć funkcji GetAsyncKeyState

Aplikację można używać stałych kod klucza wirtualnego, VK_SHIFT, VK_CONTROL i VK_MENU jako wskaźniki do tablicy wskazywanego przez lpKeyState. 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 wskaźniki 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.

Skrócone informacje

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

Zobacz też

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

Index