Share via

Estrutura KEYBDINPUT (winuser.h)

  • Artigo

Contém informações sobre um evento de teclado simulado.

Sintaxe

typedef struct tagKEYBDINPUT {
  WORD      wVk;
  WORD      wScan;
  DWORD     dwFlags;
  DWORD     time;
  ULONG_PTR dwExtraInfo;
} KEYBDINPUT, *PKEYBDINPUT, *LPKEYBDINPUT;

Membros

wVk

Tipo: WORD

Um código de chave virtual. O código deve ser um valor no intervalo de 1 a 254. Se o membro dwFlagsespecificar KEYEVENTF_UNICODE, wVk deverá ser 0.

wScan

Tipo: WORD

Um código de verificação de hardware para a chave. Se dwFlagsespecificar KEYEVENTF_UNICODE, wScan especificará um caractere Unicode que deve ser enviado para o aplicativo em primeiro plano.

dwFlags

Tipo: DWORD

Especifica vários aspectos de um pressionamento de tecla. Esse membro pode ser determinadas combinações dos valores a seguir.

Valor Significado
KEYEVENTF_EXTENDEDKEY
0x0001
 Se especificado, o código de verificação wScan consiste em uma sequência de dois bytes, em que o primeiro byte tem um valor de 0xE0. Consulte Sinalizador de Chave Estendida para obter mais informações.
KEYEVENTF_KEYUP
0x0002
 Se especificado, a chave está sendo liberada. Se não for especificado, a tecla estará sendo pressionada.
KEYEVENTF_SCANCODE
0x0008
 Se especificado, wScan identifica a chave e wVk é ignorado.
KEYEVENTF_UNICODE
0x0004
 Se especificado, o sistema sintetiza um pressionamento de tecla VK_PACKET . O parâmetro wVk deve ser zero. Esse sinalizador só pode ser combinado com o sinalizador KEYEVENTF_KEYUP . Para obter mais informações, consulte a seção Comentários.

time

Tipo: DWORD

O carimbo de data/hora do evento, em milissegundos. Se esse parâmetro for zero, o sistema fornecerá seu próprio carimbo de data/hora.

dwExtraInfo

Tipo: ULONG_PTR

Um valor adicional associado ao pressionamento de tecla. Use a função GetMessageExtraInfo para obter essas informações.

Comentários

INPUT_KEYBOARD dá suporte a métodos de entrada não chave, como reconhecimento de manuscrito ou reconhecimento de voz, como se fosse entrada de texto usando o sinalizador KEYEVENTF_UNICODE . Se KEYEVENTF_UNICODE for especificado, SendInput enviará uma mensagem WM_KEYDOWN ou WM_KEYUP para a fila de mensagens do thread em primeiro plano com wParam igual a VK_PACKET. Depois que GetMessage ou PeekMessage obtiver essa mensagem, passar a mensagem para TranslateMessage postará uma mensagem WM_CHAR com o caractere Unicode originalmente especificado pelo wScan. Esse caractere Unicode será convertido automaticamente no valor ANSI apropriado se ele for postado em uma janela ANSI.

Defina o sinalizador KEYEVENTF_SCANCODE para definir a entrada do teclado em termos do código de verificação. Isso é útil para simular um pressionamento de tecla físico, independentemente de qual teclado está sendo usado no momento. Você também poderá passar o sinalizador KEYEVENTF_EXTENDEDKEY se o código de verificação for uma chave estendida. O valor da tecla virtual de uma tecla pode ser alterado dependendo do layout do teclado atual ou de quais outras teclas foram pressionadas, mas o código de verificação sempre será o mesmo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho winuser.h (inclua Windows.h)

Confira também