GetKeyNameText

A GetKeyNameText função recupera uma Cadeia de caracteres que representa o nome de uma chave.

int GetKeyNameText ( LONG  lParam, / / segundo parâmetro da mensagem de tecladoLPTSTRlpString, / / ponteiro para reserva nome de chaveintnSize / / string de comprimento máximo do nome de chave de comprimento);
 

Parâmetros

lParam

Especifica o segundo parâmetro da mensagem teclado (por exemplo, WM_KEYDOWN) para serem processados. A função interpreta as seguintes partes de lParam.

Bits de	Significado
16 — 23	Código de verificação.
24	Estendido-chave sinalizador. Distingue algumas teclas em um teclado avançado.
25	"Don ' t care" bit. O aplicativo chamado essa função define esse bit para indicar que a função não deve distinguir entre esquerda e direita teclas ctrl e shift, por exemplo.

lpString

Ponteiro para um buffer que receberá o nome da chave.

nSize

Especifica o comprimento máximo, em caracteres, o nome da chave, incluindo o caractere nulo de terminação. (Este parâmetro deve ser igual ao tamanho do buffer apontado pelo lpString parâmetro.)

Retornar valores

Se a função tiver êxito, uma Cadeia de caracteres terminada por caractere nulo é copiada para o buffer especificado e o valor de retorno é o comprimento da Cadeia de caracteres, em caracteres, não contando o caractere nulo final.

Se a função falhar, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

O formato da seqüência de caracteres de nome de chave depende o layout de teclado atual. O driver de teclado mantém uma lista de nomes na forma de seqüências de caracteres para chaves com nomes com mais de um único caractere. O nome da chave é convertido de acordo com o layout de teclado instalado. O nome de uma chave de caractere é o caractere em si. Os nomes das teclas mortas são detalhados na íntegra.

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

Index