Compartilhar via


ON_COMMAND

Essa macro mapeia uma mensagem de comando para uma função de membro.

ON_COMMAND(id, memberFxn )

Parâmetros

  • id
    A identificação de comando.

  • memberFxn
    O nome da função de manipulador de mensagens para o qual o comando é mapeado.

Comentários

Indica qual função manipulará uma mensagem de comando de um objeto de comando de interface de usuário como um botão de barra de ferramentas ou item de menu.

Quando um objeto de destino de comando recebe um Windows WM_COMMAND mensagem com o ID especificado, ON_COMMAND chamará a função de membro memberFxn para manipular a mensagem.

Use ON_COMMAND para mapear um único comando para uma função de membro.Use ON_COMMAND_RANGE para mapear um intervalo de ids de comando para a função de um membro.Apenas uma entrada de mapa de mensagens pode corresponder a uma identificação de determinado comando.Ou seja, você não pode mapear um comando para mais de um manipulador.Para obter mais informações e exemplos, consulte manipulação de mensagens e tópicos de mapeamento de.

Exemplo

BEGIN_MESSAGE_MAP(CMFCListViewDoc, CDocument)
   ON_COMMAND(ID_MYCOMMAND, &CMFCListViewDoc::OnMycommand)
END_MESSAGE_MAP()

Requisitos

Cabeçalho: afxmsg_.h

Consulte também

Referência

ON_UPDATE_COMMAND_UI

Conceitos

Globais e Macros do MFC