ICommandUI Interface

Gere comandos de interface de utilizador.

Sintaxe

interface class ICommandUI

Membros

Métodos Públicos

Observações

Esta interface fornece métodos e propriedades que gerem comandos da interface de utilizador. ICommandUI é semelhante ao CCmdUI Class, exceto que ICommandUI é usado para aplicações MFC que interoperam com componentes .NET.

ICommandUI é usado dentro de um handler de ON_UPDATE_COMMAND_UI numa classe derivada do ICommandTarget. Quando um utilizador de uma aplicação ativa (seleciona ou clica) num menu, cada item do menu é exibido como ativado ou desativado. O destino de cada comando de menu fornece esta informação ao implementar um ON_UPDATE_COMMAND_UI handler. Para cada um dos objetos da interface de utilizador de comandos na sua aplicação, use o Assistente de Classes para criar uma entrada de mapa de mensagens e um protótipo de função para cada handler.

Para mais informações sobre como a ICommandUI interface é usada no encaminhamento de comandos, veja Como: Adicionar Encaminhamento de Comandos ao Controlo de Formulários do Windows.

Para mais informações sobre o uso do Windows Forms, consulte Usar um Controlo de Utilizador do Windows Form no MFC.

Para mais informações sobre como os comandos da interface de utilizador são geridos no MFC, veja Classe CCmdUI.

ICommandUI::Check

Define o elemento da interface de utilizador deste comando para o estado de verificação apropriado.

property UICheckState Check;

Observações

Esta propriedade define o item da interface de utilizador para este comando no estado de verificação apropriado. Defina Check para os seguintes valores:

• 0 Desmarcar
• 1 Verificação
• 2 Set indeterminado

ICommandUI::ContinueRouting

Diz ao mecanismo de encaminhamento de comandos para continuar a encaminhar a mensagem atual pela cadeia de handlers.

void ContinueRouting();

Observações

Esta é uma função membro avançada que deve ser usada em conjunto com um handler de ON_COMMAND_EX que devolve FALSE. Para mais informações, consulte a Nota Técnica TN006: Mapas de Mensagens.

ICommandUI::Enabled

Ativa ou desativa o item da interface de utilizador para este comando.

property bool Enabled;

Observações

Esta propriedade ativa ou desativa o item da interface de utilizador para este comando. Defina Enabled para TRUE para ativar o item, FALSE para o desativar.

ICommandUI::ID

Obtém o ID do objeto da interface de utilizador representado pelo objeto ICommandUI.

property unsigned int ID;

Observações

Esta propriedade recebe o ID (um handle) do item do menu, botão da barra de ferramentas ou outro objeto da interface do utilizador representado pelo objeto ICommandUI.

ICommandUI::Index

Obtém o índice do objeto da interface do utilizador representado pelo objeto ICommandUI.

property unsigned int Index;

Observações

Esta propriedade recebe o índice (um handle) do item do menu, botão da barra de ferramentas ou outro objeto de interface de utilizador representado pelo objeto ICommandUI.

ICommandUI::Rádio

Define o elemento da interface de utilizador deste comando para o estado de verificação apropriado.

property bool Radio;

Observações

Esta propriedade define o item da interface de utilizador para este comando no estado de verificação apropriado. Defina o Rádio para TRUE para ativar o item; caso contrário, FALSO.

ICommandUI::Text

Define o texto do item da interface de utilizador para este comando.

property String^ Text;

Observações

Esta propriedade define o texto do item da interface de utilizador para este comando. Defina o Texto para um handle de cadeia de texto.

Requerimentos

Cabeçalho: afxwinforms.h (definido em assembly atlmfc\lib\mfcmifc80.dll)

Consulte também

Classe CCmdUI