GetKeyState

O GetKeyState função recupera o status da chave virtual especificado. O status especifica se a chave é para cima, para baixo, ou alternado (ligado, desligado — alternando cada vez que a tecla é pressionada).

Curto GetKeyState ( int  nVirtKey / / virtual-chave código);
 

Parâmetros

nVirtKey

Especifica uma chave virtual. Se a chave virtual desejada é uma letra ou dígito (de À Z, à z ou 0 a 9), nVirtKey deve ser definido como o valor ASCII do caractere. Para outras teclas, ele deve ser um código de chave virtual.

Se for utilizado um leiaute de teclado diferente do inglês, chaves virtuais com valores no intervalo de ASCII À Z e de 0 a 9 são usadas para especificar a maioria das teclas de caracteres. Por exemplo, para o layout de teclado alemão, se a chave virtual valor O ASCII (0x4F) refere a chave "o", Considerando que VK_OEM_1 refere-se à chave "o com umlaut".

Retornar valores

O valor de retorno especifica o status de determinada chave virtual, da seguinte forma:

• 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.

Observações

O status da chave retornado de alterações essa função como um determinado thread lê mensagens-chave da sua fila de mensagens. O status não reflecte o estado de nível de interrupção associado com o hardware. Use o GetAsyncKeyState função para recuperar informações.

Um aplicativo chama o GetKeyState em resposta a uma mensagem de entrada do teclado. Essa função recupera o estado da tecla quando a mensagem de entrada foi gerada.

Para recuperar informações de estado para todas as teclas virtuais, use a função GetKeyboardState.

Um aplicativo pode usar as constantes do código de chave virtual VK_SHIFT, VK_CONTROL e VK_MENU como valores para o parâmetro de nVirtKey . 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 valores para nVirtKey para distinguir entre as instâncias dessas teclas esquerdas e direita.

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.

Windows CE: O GetKeyState função só pode ser usado para verificar o estado pressionado do seguinte chaves virtuais

VK_CONTROL

VK_SHIFT

VK_MENU

VK_LCONTROL

VK_LSHIFT

VK_LMENU

VK_RCONTROL

VK_RSHIFT

VK_RMENU

GetKeyState só pode ser usado para verificar o estado toggled da chave virtual VK_CAPITAL.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
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, GetAsyncKeyState, GetKeyboardState, MapVirtualKey, SetKeyboardState

Index