CWnd::OnChar

Artigo
02/25/2013

A estrutura chama essa função de membro quando um pressionamento de tecla converte a um caractere de nonsystem.

afx_msg void OnChar(
   UINT nChar,
   UINT nRepCnt,
   UINT nFlags 
);

Parâmetros

nChar
Contém o valor de código de caractere de chave.
nRepCnt
Contém a contagem de repetição, o número de vezes que o pressionamento de tecla é repetido quando o usuário mantém pressionada a chave.

nFlags
Contém o código de verificação, o código de quadro-chave transição, o estado chave anterior, e o código de contexto, conforme mostrado na lista a seguir:

Valor	Significado
0-15	Especifica a contagem de repetição.O valor é o número de vezes que o pressionamento de tecla é repetido resultado do usuário que mantém pressionada a chave.
16-23	Especifica o código de verificação.O valor depende do fabricante de equipamento original (OEM)
24	Especifica se a chave é uma chave estendido, como as teclas ALT à direita do e CTRL que aparecem em um 101 - ou aprimorados o teclado 102 principal.O valor é 1 se é uma chave; estendido caso contrário, é 0.
25-28	Usado internamente pelo windows.
29	Especifica o código de contexto.O valor é 1 se a tecla ALT é mantido pressionado enquanto a chave está pressionada; caso contrário, o valor é 0.
30	Especifica o estado chave anterior.O valor é 1 se a chave está pressionada antes que a mensagem ser enviada, ou é 0 se a chave está acima.
31	Especifica o estado de transição.O valor é 1 se a chave está sendo laçada, ou é 0 se a chave está sendo pressionado.

Comentários

Essa função é chamada antes da função de membro de OnKeyUp e depois a função de membro de OnKeyDown é chamada.OnChar contém o valor da chave de teclado que está sendo pressionado ou liberado.

Porque não é necessariamente uma correspondência um-para-um entre as teclas pressionadas e chamadas de OnChar gerados, as informações em nFlags geralmente não é útil para aplicativos.Informações sobre nFlags se aplica somente a chamada mais recente para a função de membro de OnKeyUp ou à função de membro de OnKeyDown que precede a chamada a OnChar.

Para IBM recursos avançados 101 e 102 - teclados chave, chaves são aprimorados ALT direito e das teclas CTRL de direito na seção principal do teclado; INS o, o DEL, o HOME, a END, a PAGE UP, a PAGE DOWN, e as teclas de direção nos conjuntos à esquerda do teclado numérico; e a barra (/) e teclas ENTER no teclado numérico.Alguns outros teclados podem oferecer suporte a estender- chave mordida em nFlags.

Observação
Essa função de membro é chamada pela estrutura para permitir que seu aplicativo manipule uma mensagem do windows.Parâmetros passados à sua função refletem os parâmetros recebidos pela estrutura quando a mensagem foi colocada.Se você chamar a implementação da classe base de essa função, essa implementação usará parâmetros passados originalmente com a mensagem e não os parâmetros que você fornece para a função.

Essa função de membro é chamada pela estrutura para permitir que seu aplicativo manipule uma mensagem do windows.Parâmetros passados à sua função refletem os parâmetros recebidos pela estrutura quando a mensagem foi colocada.Se você chamar a implementação da classe base de essa função, essa implementação usará parâmetros passados originalmente com a mensagem e não os parâmetros que você fornece para a função.