Compartilhar via


Interface ICommandUI

Gerencia comandos de interface do usuário.

Sintaxe

interface class ICommandUI

Membros

Métodos públicos

Nome Descrição
icommandui__Check Define o item de interface do usuário deste comando como o estado de verificação apropriado.
ICommandUI::ContinueRouting Informa ao mecanismo de roteamento de comandos para continuar roteando a mensagem atual para baixo na cadeia de manipuladores.
ICommandUI::Enabled Habilita ou desabilita o item de interface do usuário para este comando.
ICommandUI::ID Obtém a ID do objeto de interface do usuário representado pelo objeto ICommandUI.
ICommandUI::Index Obtém o índice do objeto de interface do usuário representado pelo objeto ICommandUI.
ICommandUI::Radio Define o item de interface do usuário deste comando como o estado de verificação apropriado.
ICommandUI::Text Define o texto do item de interface do usuário para este comando.

Comentários

Essa interface fornece métodos e propriedades que gerenciam comandos de interface do usuário. ICommandUI é semelhante à Classe CCmdUI, exceto que ICommandUI é usado para aplicativos MFC que interoperam com componentes .NET.

ICommandUI é usado em um manipulador ON_UPDATE_COMMAND_UI em uma classe derivada de ICommandTarget. Quando um usuário de um aplicativo ativa (clica ou seleciona) um menu, cada item de menu é exibido como habilitado ou desabilitado. O destino de cada comando de menu fornece essas informações implementando um manipulador ON_UPDATE_COMMAND_UI. Para cada um dos objetos de interface do usuário de comando em seu aplicativo, use o Assistente de Classe para criar uma entrada de mapa de mensagens e um protótipo de função para cada manipulador.

Para obter mais informações sobre como a interface ICommandUI é usada no roteamento de comandos, consulte Como adicionar o roteamento de comandos ao controle do Windows Forms.

Para mais informações sobre como usar Windows Forms, confira Como usar um controle de usuário do Windows Form no MFC.

Para obter mais informações sobre como os comandos de interface do usuário são gerenciados no MFC, consulte a Classe CCmdUI.

ICommandUI::Check

Define o item de interface do usuário deste comando como o estado de verificação apropriado.

property UICheckState Check;

Comentários

Esta propriedade define o item de interface do usuário deste comando como o estado de verificação apropriado. Defina a marcação para os seguintes valores:

  • 0 Desmarcar
  • 1 Marcar
  • 2 Definir como indeterminado

ICommandUI::ContinueRouting

Informa ao mecanismo de roteamento de comandos para continuar roteando a mensagem atual para baixo na cadeia de manipuladores.

void ContinueRouting();

Comentários

Essa é uma função membro avançada, que deve ser usada em conjunto com um manipulador ON_COMMAND_EX que retorna FALSE. Para mais informações, confira Nota Técnica TN006: Mapas de Mensagem.

ICommandUI::Enabled

Habilita ou desabilita o item de interface do usuário para este comando.

property bool Enabled;

Comentários

Esta propriedade habilita ou desabilita o item de interface do usuário para este comando. Defina Habilitado como TRUE para habilitar o item, FALSE para desabilitá-lo.

ICommandUI::ID

Obtém a ID do objeto de interface do usuário representado pelo objeto ICommandUI.

property unsigned int ID;

Comentários

Essa propriedade obtém a ID (um identificador) do item de menu, botão da barra de ferramentas ou outro objeto de interface do usuário representado pelo objeto ICommandUI.

ICommandUI::Index

Obtém o índice do objeto de interface do usuário representado pelo objeto ICommandUI.

property unsigned int Index;

Comentários

Essa propriedade obtém o índice (um identificador) do item de menu, botão da barra de ferramentas ou outro objeto de interface do usuário representado pelo objeto ICommandUI.

ICommandUI::Radio

Define o item de interface do usuário deste comando como o estado de verificação apropriado.

property bool Radio;

Comentários

Esta propriedade define o item de interface do usuário deste comando como o estado de verificação apropriado. Defina a Opção como TRUE para habilitar o item; caso contrário, FALSE.

ICommandUI::Text

Define o texto do item de interface do usuário para este comando.

property String^ Text;

Comentários

Esta propriedade define o texto do item de interface do usuário para este comando. Defina Texto como um identificador de cadeia de caracteres de texto.

Requisitos

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

Confira também

Classe CCmdUI