VkKeyScanEx

A função VkKeyScanEx converte um caractere para o código de chave virtual correspondente e o estado de mudança. A função converte o caractere usando o idioma de entrada e o layout de teclado físico identificado pelo identificador de layout de teclado fornecido.

SHORT VkKeyScanEx ( TCHAR  ch, / caractere para traduzir /HKLdwhkl / / identificador layout de teclado);

Parâmetros

ch: Especifica o caractere a ser convertido em um código de chave virtual.
dwhkl: Identificador para o layout de teclado para usar para traduzir o carácter. Este parâmetro pode ser qualquer identificador de layout de teclado anteriormente retornado por LoadKeyboardLayout função.

Retornar valores

Se a função for bem-sucedido, a baixa byte de ordem o valor de retorno contém o virtual-código de chave e o alto byte ordem contém o estado de shift, que pode ser uma combinação dos seguintes bits sinalizador.

Bit		Significado
1		Qualquer tecla shift está pressionada.
2		Qualquer tecla CTRL está pressionada.
4		Qualquer tecla ALT está pressionada.
8	A chave Hankaku é pressionada
16	Reservado (definido pelo driver de layout do teclado).
32	Reservado (definido pelo driver de layout do teclado).

Se a função não encontrar nenhuma chave que é convertida para o código do caractere passado, os bytes de ordem baixa e alta ordem contêm – 1.

Observações

Para layouts de teclado que usam a tecla alt da direita como uma tecla de shift (por exemplo, o layout de teclado francês), o estado shift é representado pelo valor de 6, porque o direito alt chave é convertido internamente em ctrl + alt.

Traduções para o teclado numérico (VK_NUMPAD0 através de VK_DIVIDE) são ignoradas. Essa função destina-se a traduzir caracteres pressionamentos de teclas na seção principal do teclado apenas. Por exemplo, o caractere "7" é convertido em VK_7, não VK_NUMPAD7.

VkKeyScanEx é usado por aplicativos que enviar caracteres usando as mensagens WM_KEYUP e WM_KEYDOWN.

QuickInfo

nbsp; Windows &NT: requer a versão 4.0 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.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral de entrada de teclado, funções de entrada de teclado, GetAsyncKeyState, GetKeyboardState, GetKeyNameText, GetKeyState, LoadKeyboardLayout, SetKeyboardState, ToAsciiEx

Index