ICommandSource Interface

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

Syntax

interface class ICommandSource

Members

Public Methods

Remarks

When you host a user control in an MFC View, CWinFormsView Class routes commands and update command UI messages to the user control to allow it to handle MFC commands (for example, frame menu items and toolbar buttons). By implementing ICommandTarget Interface, you give the user control a reference to the ICommandSource object.

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.

Requirements

Header: afxwinforms.h (defined in 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);

Parameters

cmdID
A ID do comando.

cmdHandler
Um identificador para o método do manipulador de comandos.

Remarks

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);

Parameters

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.

Remarks

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);

Parameters

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.

Remarks

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);

Parameters

cmdID
A ID do comando.

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

Remarks

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);

Parameters

command
A ID de comando da mensagem a ser postada.

Remarks

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);

Parameters

cmdID
A ID do comando.

Remarks

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);

Parameters

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

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

Remarks

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);

Parameters

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

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

Remarks

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);

Parameters

cmdID
A ID do comando.

Remarks

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);

Parameters

command
A ID de comando da mensagem a ser enviada.

Remarks

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.

See also

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