Compartilhar via


CWnd::OnMenuChar

A estrutura chama essa função de membro quando o usuário pressiona um caractere mnemônico de menu que não coincide com algumas das mnemônicos predefinidas no menu atual.

afx_msg LRESULT OnMenuChar( 
   UINT nChar, 
   UINT nFlags, 
   CMenu* pMenu  
);

Parâmetros

  • nChar
    Dependendo das configurações de compilação, especifica o caractere ANSI ou Unicode que o usuário pressionou.

  • nFlags
    Contém o sinalizador de MF_POPUP se o menu é um menu pop-up. Contém o sinalizador de MF_SYSMENU se o menu é um menu de controle.

  • pMenu
    Contém um ponteiro para CMenuselecionado. O ponteiro pode ser temporário e não deve ser armazenado.

Valor de retorno

A palavra de alta-ordem do valor de retorno deve conter um dos seguintes códigos de comando:

Valor

Descrição

0

Informa o windows para descartar o caractere que o usuário pressionou e cria um aviso sonoro curto no alto-falante do sistema.

1

Informa o windows para fechar o menu atual.

2

Informa o windows que a palavra de ordem baixa do valor de retorno contém o número de itens para um item específico. Este item é selecionado pelo windows.

A palavra de ordem baixa são ignoradas se a palavra de alta-ordem contêm 0 ou 1. Os aplicativos devem processar esta mensagem quando as teclas de aceleração (atalho) são usadas para selecionar bitmaps colocados em um menu.

Comentários

é enviado a CWnd que possui o menu. OnMenuChar também é chamado quando o usuário pressiona a tecla ALT e a qualquer outra chave, mesmo se a chave não corresponde a um caractere mnemônico. Em esse caso, os pontos de pMenu o menu possuído por CWnd, e nFlags é 0.

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

CWnd::OnMenuChar