VkKeyScan

A função VkKeyScan converte um caractere para o código de chave virtual correspondente e o estado de shift do teclado atual.

Esta função foi substituída pela função VkKeyScanEx . Você ainda pode usar VkKeyScan, no entanto, se você não precisará especificar um layout de teclado.

SHORT VkKeyScan ( TCHAR  ch / caractere para traduzir /);
 

Parâmetros

ch
Especifica o caractere a ser convertido em um código de chave virtual.

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.

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

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 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, SetKeyboardState, VkKeyScanEx, WM_KEYDOWN, WM_KEYUP

Index