Partilhar via


ICommandTarget Interface

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Fornece um controlo de utilizador com uma interface para receber comandos de um objeto fonte de comandos.

Sintaxe

interface class ICommandTarget

Membros

Métodos Públicos

Nome Description
ICommandTarget::Inicialize Inicializa o objeto alvo de comando.

Observações

Quando hospeda um controlo de utilizador numa Vista MFC, o CWinFormsView encaminha comandos e atualiza as mensagens da interface de comandos para o controlo do utilizador, permitindo que este gere comandos MFC (por exemplo, itens do menu de frames e botões da barra de ferramentas). Ao implementar ICommandTarget, dá ao utilizador uma referência ao objeto ICommandSource .

Veja Como: Adicionar Encaminhamento de Comandos ao Controlo de Formulários do Windows para um exemplo de como usar ICommandTarget.

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

Requerimentos

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

ICommandTarget::Inicialize

Inicializa o objeto alvo de comando.

void Initialize(ICommandSource^ cmdSource);

Parâmetros

cmdSource
Um handle para o objeto de origem do comando.

Observações

Quando hospeda um controlo de utilizador numa Vista MFC, o CWinFormsView encaminha comandos e atualiza mensagens da interface de comandos para o controlo de utilizador para permitir que este gere comandos MFC.

Este método inicializa o objeto destino de comando e associa-o ao objeto de origem de comando especificado cmdSource. Deve ser chamado na implementação da classe de controlo do utilizador. Na inicialização, deve registar os manipuladores de comandos com o objeto fonte de comandos chamando ICommandSource::AddCommandHandler na implementação Initialize. Veja Como: Adicionar o Encaminhamento de Comandos ao Controlo de Formulários do Windows para um exemplo de como usar o Inicializar para fazer isto.

Consulte também

Como: Adicionar o Encaminhamento de Comandos ao Controlo do Windows Forms
ICommandSource Interface