Classe CCmdUI

Artigo
06/10/2015

É usado somente dentro uma manipulador em CCmdTarget- classe derivada de ON_UPDATE_COMMAND_UI .

class CCmdUI

Membros

Métodos públicos

Nome	Descrição
CCmdUI::ContinueRouting	Com o mecanismo de comando para roteamento continuar a rotear mensagens na atual de cadeia manipuladores.
CCmdUI::Enable	Habilita ou desabilita o item da interface do usuário para este comando.
CCmdUI::SetCheck	Define o estado da verificação de item da interface do usuário para este comando.
CCmdUI::SetRadio	Como a função de membro de SetCheck , mas opera nos grupos de rádio.
CCmdUI::SetText	Define o texto do item da interface do usuário para este comando.

Membros públicos de dados

Nome	Descrição
CCmdUI::m_nID	A identificação de O objeto de interface do usuário.
CCmdUI::m_nIndex	O índice do objeto de interface do usuário.
CCmdUI::m_pMenu	Os pontos ao menu representado por CCmdUI objeto.
CCmdUI::m_pOther	Os pontos a janela objeto que enviado a notificação.
CCmdUI::m_pSubMenu	Os pontos ao submenu contido representado por CCmdUI objeto.

Comentários

CCmdUI não tem uma classe base.

Quando um usuário de seu aplicativo recebe um menu para baixo, cada item de menu precisa saber se deve ser exibido como ativado ou desativado. O destino de comando de menu fornece essa informação implementando um manipulador de ON_UPDATE_COMMAND_UI . Para cada um dos objetos de interface de usuário de comando em seu aplicativo, use a janela propriedades para criar um protótipo de entrada e a função de mapa mensagem- para cada manipulador.

Quando o menu for recebido para baixo, a estrutura procura por e chama funções de membro de CCmdUI de cada manipulador de ON_UPDATE_COMMAND_UI , de chamadas de cada manipulador como Habilitar e Seleção, e então exibe a estrutura adequadamente cada item de menu.

Um item de menu pode ser substituído por um botão ou outro controle de barra de objeto de interface de usuário de comando sem alterar o código no manipulador de ON_UPDATE_COMMAND_UI .

A tabela a seguir resume as funções de membro de CCmdUI tem o efeito em vários itens da interface do usuário de comando.

Item da interface do usuário	Ativar	SetCheck	SetRadio	SetText
Item do menu	Habilita ou desativa verificação	Verifica (×) ou desmarque	Verifica usando o ponto (•)	Define o texto do item
Botão da barra de ferramentas	Habilita ou desativa verificação	Seleciona, de-seleciona, ou indefinido	Mesmo que SetCheck	(Não aplicável)
O painel statusbar	Torna o texto visível ou invisível	Define o PNF - out a borda normal	Mesmo que SetCheck	Define o texto do painel
Botão normal em CDialogBar	Habilita ou desativa verificação	Verifica ou desmarque a caixa de seleção	Mesmo que SetCheck	Texto do botão de conjuntos
Controle normal em CDialogBar	Habilita ou desativa verificação	(Não aplicável)	(Não aplicável)	Define o texto da janela