Compartilhar via


Interface ICommandSource

Gerencia comandos enviados de um objeto de origem de comando para um controle de usuário.

Sintaxe

interface class ICommandSource

Membros

Métodos públicos

Nome Descrição
ICommandSource::AddCommandHandler Adiciona um manipulador de comando a um objeto de origem de comando.
ICommandSource::AddCommandRangeHandler Adiciona um grupo de manipuladores de comando a um objeto de origem de comando.
ICommandSource::AddCommandRangeUIHandler Adiciona um grupo de manipuladores de mensagens de comando de interface do usuário a um objeto de origem de comando.
ICommandSource::AddCommandUIHandler Adiciona um manipulador de mensagens de comando de interface do usuário a um objeto de origem de comando.
ICommandSource::PostCommand Posta uma mensagem sem esperar que ela seja processada.
ICommandSource::RemoveCommandHandler Remove um manipulador de comando de um objeto de origem de comando.
ICommandSource::RemoveCommandRangeHandler Remove um grupo de manipuladores de comando de um objeto de origem de comando.
ICommandSource::RemoveCommandRangeUIHandler Remove um grupo de manipuladores de mensagens de comando de interface do usuário de um objeto de origem de comando.
ICommandSource::RemoveCommandUIHandler Remove um manipulador de mensagens de comando de interface do usuário de um objeto de origem de comando.
ICommandSource::SendCommand Envia uma mensagem e aguarda que ela seja processada antes de retornar.

Comentários

Ao hospedar um controle de usuário em um Modo de Exibição do MFC, o CWinFormsView Class 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 a Interface ICommandTarget, você fornece ao controle do 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)

ICommandSource::AddCommandHandler

Adiciona um manipulador de comando a um objeto de origem de comando.

void AddCommandHandler(
    unsigned int cmdID,
    CommandHandler^ cmdHandler);

Parâmetros

cmdID
A ID do comando. cmdHandler
Um identificador para o método do manipulador de comandos.

Comentários

Esse método adiciona o cmdHandler do manipulador de comando ao objeto de origem de comando e mapeia o manipulador para cmdID. Consulte:Como adicionar roteamento de comando ao controle do Windows Forms para obter um exemplo de como usar AddCommandHandler.

ICommandSource::AddCommandRangeHandler

Adiciona um grupo de manipuladores de comando a um objeto de origem de comando.

void AddCommandRangeHandler(
    unsigned int cmdIDMin,
    unsigned int cmdIDMax,
    CommandHandler^ cmdHandler);

Parâmetros

cmdIDMin
O índice inicial do intervalo de ID de comando. cmdIDMax
O índice final do intervalo de ID de comando. cmdHandler
Um identificador para o método do manipulador de mensagens para o qual os comandos são mapeados.

Comentários

Esse método mapeia um intervalo contíguo de IDs de comando para um único manipulador de mensagens e o adiciona ao objeto de origem do comando. Isso é usado para lidar com um grupo de botões relacionados com um método.

ICommandSource::AddCommandRangeUIHandler

Adiciona um grupo de manipuladores de mensagens de comando de interface do usuário a um objeto de origem de comando.

void AddCommandRangeUIHandler(
    unsigned int cmdIDMin,
    unsigned int cmdIDMax,
    CommandUIHandler^ cmdUIHandler);

Parâmetros

cmdIDMin
O índice inicial do intervalo de ID de comando. cmdIDMax
O índice final do intervalo de ID de comando. cmdHandler
Um identificador para o método do manipulador de mensagens para o qual os comandos são mapeados.

Comentários

Esse método mapeia um intervalo contíguo de IDs de comando para um único manipulador de mensagens de comando da interface do usuário e o adiciona ao objeto de origem do comando. Isso é usado para lidar com um grupo de botões relacionados com um método.

ICommandSource::AddCommandUIHandler

Adiciona um manipulador de mensagens de comando de interface do usuário a um objeto de origem de comando.

void AddCommandUIHandler(
    unsigned int cmdID,
    CommandUIHandler^ cmdUIHandler);

Parâmetros

cmdID
A ID de comando. cmdUIHandler
Um identificador para o método do manipulador de mensagens de comando da interface do usuário.

Comentários

Esse método adiciona o cmdHandler do manipulador de mensagens de comando da interface do usuário ao objeto de origem de comando e mapeia o manipulador para cmdID.

ICommandSource::PostCommand

Posta uma mensagem sem esperar que ela seja processada.

void PostCommand(unsigned int command);

Parâmetros

command
A ID de comando da mensagem a ser postada.

Comentários

Esse método posta de forma assíncrona a mensagem mapeada para a ID especificada pelo comando. Ele chama CWnd::PostMessage para colocar a mensagem na fila de mensagens da janela e, em seguida, retorna sem aguardar a janela correspondente processar a mensagem.

ICommandSource::RemoveCommandHandler

Remove um manipulador de comando de um objeto de origem de comando.

void RemoveCommandHandler(unsigned int cmdID);

Parâmetros

cmdID
A ID do comando.

Comentários

Esse método remove o manipulador de comando mapeado para cmdID do objeto de origem do comando.

ICommandSource::RemoveCommandRangeHandler

Remove um grupo de manipuladores de comando de um objeto de origem de comando.

void RemoveCommandRangeUIHandler(
    unsigned int cmdIDMin,
    unsigned int cmdIDMax);

Parâmetros

cmdIDMin
O índice inicial do intervalo de ID de comando. cmdIDMax
O índice final do intervalo de ID de comando.

Comentários

Esse método remove um grupo de manipuladores de mensagens, mapeados para as IDs de comando especificadas por cmdIDMin e cmdIDMax, do objeto de origem do comando.

ICommandSource::RemoveCommandRangeUIHandler

Remove um grupo de manipuladores de mensagens de comando de interface do usuário de um objeto de origem de comando.

void RemoveCommandRangeUIHandler(
    unsigned int cmdIDMin,
    unsigned int cmdIDMax);

Parâmetros

cmdIDMin
O índice inicial do intervalo de ID de comando. cmdIDMax
O índice final do intervalo de ID de comando.

Comentários

Esse método remove um grupo de manipuladores de mensagens de comando da interface do usuário, mapeados para as IDs de comando especificadas por cmdIDMin e cmdIDMax, do objeto de origem do comando.

ICommandSource::RemoveCommandUIHandler

Remove um manipulador de mensagens de comando de interface do usuário de um objeto de origem de comando.

void RemoveCommandUIHandler(unsigned int cmdID);

Parâmetros

cmdID
A ID do comando.

Comentários

Esse método remove o manipulador de mensagens de comando da interface do usuário mapeado para cmdID do objeto de origem do comando.

ICommandSource::SendCommand

Envia uma mensagem e aguarda que ela seja processada antes de retornar.

void SendCommand(unsigned int command);

Parâmetros

command
A ID de comando da mensagem a ser enviada.

Comentários

Esse método envia de forma síncrona a mensagem mapeada para a ID especificada pelo comando. Ele chama CWnd::SendMessage para colocar a mensagem na fila de mensagens da janela e aguarda até que o procedimento da janela tenha processado a mensagem antes de retornar.

Confira também

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