Macro ON_UPDATE_COMMAND_UI
Para conectar um objeto de interface do usuário a um manipulador de atualização de comando em um objeto de destino de comando, abra o Modo de Exibição de Classe e clique com o botão direito do mouse na classe à qual o manipulador será adicionado e escolha Assistente de Classe. Localize a ID do objeto de interface do usuário na lista à esquerda e escolha UPDATE_COMMAND_UI no painel direito e clique em Adicionar Manipulador. Isso cria uma função de manipulador na classe e adiciona a entrada apropriada no mapa da mensagem. Confira Como mapear mensagens para funções para mais informações. Você pode especificar mensagens adicionais a serem tratadas no painel Mensagens.
Por exemplo, para atualizar um comando Limpar Tudo no menu Editar do programa, use o Assistente de Classe para adicionar uma entrada de mapa de mensagens na classe selecionada, uma declaração de função para um manipulador de atualização de comando chamado OnUpdateEditClearAll
na declaração de classe e um modelo de função vazio no arquivo de implementação da classe. O protótipo da função se parece com este:
afx_msg void OnUpdateEditClearAll(CCmdUI* pCmdUI);
Como todos os manipuladores, a declaração de função mostra a palavra-chave afx_msg. Como todos os manipuladores de atualização, é preciso um argumento, um ponteiro para um objeto CCmdUI
.