GetAsyncKeyState

O GetAsyncKeyState função determina se uma chave é para cima ou para baixo quando que a função é chamada, e se a chave foi pressionado após uma chamada anterior para GetAsyncKeyState.

Curto GetAsyncKeyState ( int  vChave / / virtual-chave código);
 

Parâmetros

vChave
Especifica um dos 256 possíveis virtual-chave códigos. Para obter mais informações, consulte Virtual-chave códigos.

Windows NT: Você pode usar constantes de distinção entre esquerda e direita para especificar determinadas teclas. Consulte a seção Comentários para obter mais informações.

Retornar valores

Se a função for bem-sucedido, o valor de retorno especifica se a chave foi pressionado desde a Último chamada para GetAsyncKeyState, e se a chave é atualmente para cima ou para baixo. Se o bit mais significativo é definido, a chave é para baixo, e se o bit menos significativo é definido, a chave foi pressionado após a chamada anterior a GetAsyncKeyState. O valor de retorno será zero se a janela em outro processo ou thread atualmente tem o foco do teclado.

Windows 95: Windows 95 não oferece suporte a constantes a distinção entre esquerda e direita. Se você chamar GetAsyncKeyState com essas constantes, o valor de retorno é zero.

Observações

O GetAsyncKeyState função funciona com botões do mouse. No entanto, ele verifica o estado dos botões do mouse físico, não nos botões do mouse lógico que os botões físicos são mapeados para. Por exemplo, a chamada GetAsyncKeyState(VK_LBUTTON) sempre retorna o estado do botão esquerdo do mouse físico, independentemente de saber se ele é mapeado para o botão do mouse à esquerda ou à direita lógico. Você pode determinar o mapeamento atual do sistema de botões físicos para botões do mouse lógica chamando

GetSystemMetrics(SM_SWAPBUTTON) 

 

que retorna TRUE se os botões do mouse tiverem sido trocados.

Você pode usar as constantes do código de chave virtual VK_SHIFT, VK_CONTROL e VK_MENU como valores para o parâmetro vChave . Isto dá o estado da tecla shift, ctrl ou alt chaves sem fazer distinção entre esquerda e direita.

Windows NT: Você pode usar as seguintes constantes de código de chave virtual como valores para vChave para distinguir entre as instâncias dessas teclas esquerdas e direita.

Código Significado
VK_LSHIFT VK_RSHIFT
VK_LCONTROL VK_RCONTROL
VK_LMENU VK_RMENU

Essas constantes distinção entre esquerda e direita estão disponíveis somente quando você chamar o GetKeyboardState, SetKeyboardState, GetAsyncKeyState GetKeyStatee MapVirtualKey funções.

Windows CE: O GetAsyncKeyState função oferece suporte as constantes chaves esquerdas e direita virtuais, para que você possa determinar se foi pressionado a tecla esquerda ou direita. Essas constantes são VK_LCONTROL, VK_RCONTROL, VK_LMENU, VK_RMENU, VK_LSHIFT e VK_RSHIFT.

O bit menos significativo valor de retorno não é válido em Windows CE e deve ser ignorado.

GetAsyncKeyState retorna o estado atual da chave mesmo se uma janela em outro processo ou thread atualmente tem o foco do teclado.

Você também pode usar a constante de código de chave virtual de VK_LBUTTON para determinar o estado da dica de caneta, (cima/baixo), na tela de toque.

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, GetKeyboardState, GetKeyState, GetSystemMetrics, MapVirtualKey, SetKeyboardState

Index