Compartilhar via


CWnd::OnChar

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.

Dica

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.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico da hierarquia

WM_CHAR

CWnd::OnKeyDown

CWnd::OnKeyUp