ICommandSource (interfaz)

Administra los comandos enviados desde un objeto de origen de comandos hasta un control de usuario.

Sintaxis

interface class ICommandSource

Miembros

Métodos públicos

Nombre	Descripción
ICommandSource::AddCommandHandler	Agrega un controlador de comandos a un objeto de origen de comandos.
ICommandSource::AddCommandRangeHandler	Agrega un grupo de controladores de comandos a un objeto de origen de comandos.
ICommandSource::AddCommandRangeUIHandler	Agrega un grupo de controladores de mensajes de comandos de interfaz de usuario a un objeto de origen de comandos.
ICommandSource::AddCommandUIHandler	Agrega un controlador de mensajes de comando de interfaz de usuario a un objeto de origen de comandos.
ICommandSource::PostCommand	Publica un mensaje sin esperar a que se procese.
ICommandSource::RemoveCommandHandler	Quita un controlador de comandos de un objeto de origen de comandos.
ICommandSource::RemoveCommandRangeHandler	Quita un grupo de controladores de comandos de un objeto de origen de comandos.
ICommandSource::RemoveCommandRangeUIHandler	Quita un grupo de controladores de mensajes de comandos de interfaz de usuario de un objeto de origen de comandos.
ICommandSource::RemoveCommandUIHandler	Quita un controlador de mensajes de comandos de interfaz de usuario de un objeto de origen de comandos.
ICommandSource::SendCommand	Envía un mensaje y espera a que se procese antes de devolverlo.

Comentarios

Al hospedar un control de usuario en una vista de MFC, la clase CWinFormsView enruta los comandos y actualiza los mensajes de la interfaz de usuario con el control de usuario para permitir que controle los comandos de MFC (por ejemplo, los elementos de menú de marco y los botones de la barra de herramientas). Al implementar la interfaz ICommandTarget, se proporciona al usuario una referencia al objeto ICommandSource.

Consulte Procedimiento: adición de enrutamientos de comandos al control de Windows Forms para ver un ejemplo de cómo usar ICommandTarget.

Para más información sobre el uso de Windows Forms, consulte Utilizar un control de usuario de Windows Forms en MFC.

Requisitos

Encabezado: afxwinforms.h (definido en el ensamblado atlmfc\lib\mfcmifc80.dll)

ICommandSource::AddCommandHandler

Agrega un controlador de comandos a un objeto de origen de comandos.

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

Parámetros

cmdID
Identificador del comando. cmdHandler
Identificador del método de controlador de comandos.

Comentarios

Este método agrega el controlador de comandos cmdHandler al objeto de origen de comandos y asigna el controlador a cmdID. Consulte Cómo: Agregar enrutamientos de comandos al control de Windows Forms para ver un ejemplo de cómo usar AddCommandHandler.

ICommandSource::AddCommandRangeHandler

Agrega un grupo de controladores de comandos a un objeto de origen de comandos.

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

Parámetros

cmdIDMin
Índice inicial del intervalo de identificadores de comando. cmdIDMax
Índice final del intervalo de identificadores de comando. cmdHandler
Identificador del método de controlador de mensajes al que se asignan los comandos.

Comentarios

Este método asigna un intervalo contiguo de identificadores de comando a un único controlador de mensajes y lo agrega al objeto de origen de comandos. Se usa para controlar un grupo de botones relacionados con un método.

ICommandSource::AddCommandRangeUIHandler

Agrega un grupo de controladores de mensajes de comandos de interfaz de usuario a un objeto de origen de comandos.

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

Parámetros

cmdIDMin
Índice inicial del intervalo de identificadores de comando. cmdIDMax
Índice final del intervalo de identificadores de comando. cmdHandler
Identificador del método de controlador de mensajes al que se asignan los comandos.

Comentarios

Este método asigna un intervalo contiguo de identificadores de comandos a un único controlador de mensajes de comandos de interfaz de usuario y lo agrega al objeto de origen de comandos. Se usa para controlar un grupo de botones relacionados con un método.

ICommandSource::AddCommandUIHandler

Agrega un controlador de mensajes de comando de interfaz de usuario a un objeto de origen de comandos.

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

Parámetros

cmdID
Identificador del comando. cmdUIHandler
Identificador del método de controlador de mensajes de comandos de interfaz de usuario.

Comentarios

Este método agrega el controlador de mensajes de comandos de interfaz de usuario cmdHandler al objeto de origen de comandos y asigna el controlador a cmdID.

ICommandSource::PostCommand

Publica un mensaje sin esperar a que se procese.

void PostCommand(unsigned int command);

Parámetros

command
Identificador de comando del mensaje que se va a publicar.

Comentarios

Este método publica de forma asincrónica el mensaje asignado al identificador especificado por el comando . Llama a CWnd::PostMessage para colocar el mensaje en la cola de mensajes de la ventana y, luego, devuelve resultados sin esperar a que la ventana correspondiente procese el mensaje.

ICommandSource::RemoveCommandHandler

Quita un controlador de comandos de un objeto de origen de comandos.

void RemoveCommandHandler(unsigned int cmdID);

Parámetros

cmdID
Identificador del comando.

Comentarios

Este método quita el controlador de comandos asignado a cmdID del objeto de origen de comandos.

ICommandSource::RemoveCommandRangeHandler

Quita un grupo de controladores de comandos de un objeto de origen de comandos.

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

Parámetros

cmdIDMin
Índice inicial del intervalo de identificadores de comando. cmdIDMax
Índice final del intervalo de identificadores de comando.

Comentarios

Este método quita un grupo de controladores de mensajes, asignados a los identificadores de comando especificados por cmdIDMin y cmdIDMax, del objeto de origen de comandos.

ICommandSource::RemoveCommandRangeUIHandler

Quita un grupo de controladores de mensajes de comandos de interfaz de usuario de un objeto de origen de comandos.

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

Parámetros

cmdIDMin
Índice inicial del intervalo de identificadores de comando. cmdIDMax
Índice final del intervalo de identificadores de comando.

Comentarios

Este método quita un grupo de controladores de mensajes de comandos de interfaz de usuario, asignados a los identificadores de comando especificados por cmdIDMin y cmdIDMax, del objeto de origen de comandos.

ICommandSource::RemoveCommandUIHandler

Quita un controlador de mensajes de comandos de interfaz de usuario de un objeto de origen de comandos.

void RemoveCommandUIHandler(unsigned int cmdID);

Parámetros

cmdID
Identificador del comando.

Comentarios

Este método quita el controlador de mensajes de comandos de interfaz de usuario asignado a cmdID del objeto de origen de comandos.

ICommandSource::SendCommand

Envía un mensaje y espera a que se procese antes de devolverlo.

void SendCommand(unsigned int command);

Parámetros

command
Identificador de comando del mensaje que se va a enviar.

Comentarios

Este método envía de forma sincrónica el mensaje asignado al identificador especificado por el comando. Llama a CWnd::SendMessage para colocar el mensaje en la cola de mensajes de la ventana y espera a que ese procedimiento de ventana haya procesado el mensaje antes de devolver resultados.

Consulte también

Cómo: Agregar enrutamientos de comandos al control de Windows Forms
ICommandTarget (interfaz)