GetKeyboardState

A função GetKeyboardState copia o status das 256 chaves virtuais para o buffer especificado.

(BOOL GetKeyboardState PBYTE  lpKeyState / / ponteiro para matriz para receber dados de status);
 

Parâmetros

lpKeyState
Ponteiro para a matriz de 256 bytes que receberá os dados de status para cada chave virtual.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é diferente de zero.

Se a função falhar, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

Um aplicativo pode chamar esta função para recuperar o status atual de todas as teclas virtuais. As alterações de status como um thread remove mensagens do teclado da sua fila de mensagens. O status não muda como teclado mensagens são postadas para o fila de mensagens do segmento, nem faz ele alterar as mensagens do teclado são postadas ou retiradas de filas de mensagens de outros segmentos. (Exceção: segmentos que são conectados através do AttachThreadInput compartilhar o mesmo Estado de teclado.)

Quando a função retorna, cada membro da matriz apontado pelo lpKeyState parâmetro contém dados de status para uma chave virtual. Se o bit de alta ordem for 1, a chave é para baixo; caso contrário, é para cima. Se o bit de ordem inferior for 1, a chave é alternada. Uma chave, tais como os bonés bloqueio chave, é alternada se ele está ativado. A chave está desativado e untoggled se o bit de ordem inferior for 0. Indicador luminoso de uma chave alternar (se houver) do teclado será quando a chave é alternada, e desligar quando a chave é untoggled.

Para recuperar informações de status para uma chave individual, use o GetKeyState função. Para recuperar o atual estado para um chave individual independentemente de saber se a mensagem de teclado correspondente tiver sido recuperada da fila de mensagens, use o GetAsyncKeyState função

Um aplicativo pode usar as constantes do código de chave virtual VK_SHIFT, VK_CONTROL e VK_MENU como índices para a matriz apontada pelo lpKeyState. Isto dá o status da tecla shift, ctrl ou alt chaves sem fazer distinção entre esquerda e direita. Um aplicativo também pode usar as seguintes constantes de código de chave virtual como índices para distinguir entre as instâncias dessas teclas esquerdas e direita.

VK_LSHIFT VK_RSHIFT
VK_LCONTROL VK_RCONTROL
VK_LMENU VK_RMENU

Essas constantes distinção entre esquerda e direita estão disponíveis para um aplicativo somente através do GetKeyboardState, SetKeyboardState, GetAsyncKeyState GetKeyStatee MapVirtualKey funções.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de entrada de teclado, funções de entrada de teclado, GetKeyState, GetAsyncKeyState, MapVirtualKey, SetKeyboardState

Index