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 Windows Forms para obter um exemplo de como usar ICommandTargeto .

Para obter mais informações sobre como usar o Windows Forms, consulte Usando 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
O ID do comando.

cmdHandler
Um identificador para o método manipulador de comando.

Remarks

Esse método adiciona o manipulador de comandos cmdHandler ao objeto de origem do comando e mapeia o manipulador para cmdID. Consulte Como: Adicionar roteamento de comando ao controle 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 do comando.

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

cmdHandler
Um identificador para o método 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 da 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 do comando.

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

cmdHandler
Um identificador para o método 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 da interface do usuário a um objeto de origem de comando.

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

Parameters

cmdID
O ID do comando.

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

Remarks

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

ICommandSource::PostCommand

Publica uma mensagem sem esperar que ela seja processada.

void PostCommand(unsigned int command);

Parameters

command
O 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::P ostMessage para colocar a mensagem na fila de mensagens da janela e, em seguida, retorna sem esperar pela janela correspondente para processar a mensagem.

ICommandSource::RemoveCommandHandler

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

void RemoveCommandHandler(unsigned int cmdID);

Parameters

cmdID
O ID do comando.

Remarks

Esse método remove o manipulador de comandos 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 do comando.

cmdIDMax
O índice final do intervalo de ID do 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 da 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 do comando.

cmdIDMax
O índice final do intervalo de ID do 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 da interface do usuário de um objeto de origem de comando.

void RemoveCommandUIHandler(unsigned int cmdID);

Parameters

cmdID
O 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
O 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 Windows Forms
ICommandTarget Interface