Compartilhar via


Interface ICommandTarget

Fornece um controle de usuário com uma interface para receber os comandos de um objeto de origem de comando.

Sintaxe

interface class ICommandTarget

Membros

Métodos públicos

Nome Descrição
ICommandTarget::Initialize Inicializa o objeto de destino do comando.

Comentários

Ao hospedar um controle de usuário em um Modo de Exibição do MFC, o CWinFormsView roteia os comandos e atualiza as mensagens de interface do usuário de comando para o controle de usuário para permitir que manipule os comandos do MFC (por exemplo, os itens de menu do quadro e os botões da barra de ferramentas). Ao implementar ICommandTarget, você fornece ao controle de usuário uma referência ao objeto ICommandSource.

Consulte: Como adicionar roteamento de comando ao controle do Windows Forms para obter um exemplo de como usar ICommandTarget.

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

Requisitos

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

ICommandTarget::Initialize

Inicializa o objeto de destino do comando.

void Initialize(ICommandSource^ cmdSource);

Parâmetros

cmdSource
Um identificador para o objeto de origem do comando.

Comentários

Quando você hospeda um controle de usuário em um Modo de Exibição do MFC, o CWinFormsView roteia os comandos e atualiza as mensagens de interface do usuário de comando para o controle de usuário para permitir que manipule os comandos do MFC.

Esse método inicializa o objeto de destino de comando e o associa ao objeto de origem de comando especificado cmdSource. Ele deve ser chamado na implementação da classe de controle de usuário. Na inicialização, é necessário registrar os manipuladores de comando com o objeto de origem do comando chamando ICommandSource::AddCommandHandler na implementação Inicializar. Consulte: Como adicionar roteamento de comando ao controle do Windows Forms para obter um exemplo de como usar Inicializar para fazer isso.

Confira também

Como adicionar roteamento de comando ao controle do Windows Forms
Interface ICommandSource