Função GetAsyncKeyState (winuser.h)

Determina se uma tecla está para cima ou para baixo no momento em que a função é chamada e se a tecla foi pressionada após uma chamada anterior a GetAsyncKeyState.

Sintaxe

SHORT GetAsyncKeyState(
  [in] int vKey
);

Parâmetros

[in] vKey

Tipo: int

O código de chave virtual. Para obter mais informações, consulte Códigos de chave virtual.

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

Valor retornado

Tipo: SHORT

Se a função for bem-sucedida, o valor retornado especificará se a tecla foi pressionada desde a última chamada para GetAsyncKeyState e se a tecla está atualmente para cima ou para baixo. Se o bit mais significativo for definido, a tecla será inativa e, se o bit menos significativo estiver definido, a tecla será pressionada após a chamada anterior para GetAsyncKeyState. No entanto, você não deve confiar nesse último comportamento; para obter mais informações, consulte os Comentários.

O valor retornado é zero para os seguintes casos:

• A área de trabalho atual não é a área de trabalho ativa
• O thread em primeiro plano pertence a outro processo e a área de trabalho não permite o gancho ou o registro de diário.

Comentários

A função GetAsyncKeyState funciona com botões do mouse. No entanto, ele verifica o estado dos botões físicos do mouse, não nos botões lógicos do mouse para os quais os botões físicos são mapeados. Por exemplo, a chamada GetAsyncKeyState(VK_LBUTTON) sempre retorna o estado do botão esquerdo do mouse físico, independentemente de ele ser mapeado para o botão lógico esquerdo ou direito do mouse. Você pode determinar o mapeamento atual do sistema de botões físicos do mouse para botões lógicos do mouse chamando GetSystemMetrics(SM_SWAPBUTTON).

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

Embora o bit menos significativo do valor retornado indique se a tecla foi pressionada desde a última consulta, devido à natureza de multitarefa preemptiva do Windows, outro aplicativo pode chamar GetAsyncKeyState e receber o bit "pressionado recentemente" em vez de seu aplicativo. O comportamento do bit menos significativo do valor retornado é mantido estritamente para compatibilidade com aplicativos windows de 16 bits (que não são preemptivos) e não devem ser confiados.

Você pode usar as constantes de código de chave virtual VK_SHIFT, VK_CONTROL e VK_MENU como valores para o parâmetro vKey . Isso fornece o estado das teclas SHIFT, CTRL ou ALT sem distinguir entre esquerda e direita.

Você pode usar as seguintes constantes de código de chave virtual como valores para vKey para distinguir entre as instâncias esquerda e direita dessas chaves.

Essas constantes de distinção esquerda e direita só estão disponíveis quando você chama as funções GetKeyboardState, SetKeyboardState, GetAsyncKeyState, GetKeyState e MapVirtualKey .

Exemplo

while (GetMessage(&msg, nullptr, 0, 0))
{
    if (!TranslateAccelerator(msg.hwnd, hAccelTable, &msg))
    {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }

    switch (msg.message)
    {
    case WM_KEYDOWN:
        if ((GetAsyncKeyState(VK_ESCAPE) & 0x01) && bRunning)
        {
            Stop();
        }
        break;
    }
}

Exemplo das Amostras do Windows Classic no GitHub.

Requisitos

Confira também

• GetAsyncKeyState
• GetKeyState
• GetKeyboardState
• GetSystemMetrics
• MapVirtualKey
• SetKeyboardState
• Entrada por teclado