Objeto Commands (interfaz ICommands)

Visual Components se implementan en FRE para Windows.

Este objeto proporciona acceso a los comandos de un componente visual. Estos comandos pueden aparecer en el menú contextual de un componente y en su barra de herramientas (si existe). Puede habilitar o deshabilitar comandos, así como agregar comandos personalizados para Visual Components. Consulte Personalización del menú contextual y la barra de herramientas de un componente visual para obtener más detalles.

Los siguientes Visual Components le permiten administrar sus comandos: ImageViewer, ZoomViewer, DocumentViewer, TextEditor. Consulte la lista de comandos disponibles y las formas en que pueden utilizarse en cada componente:

• Comandos de Image Viewer
• Comandos de Zoom Viewer
• Comandos de Document Viewer
• Comandos de Text Editor

La información sobre la ejecución de comandos se transmite a través de interfaces salientes especiales. Estas interfaces son ICommandEvents (para C++) y una dispinterface DICommandEvents (para Visual Basic).

Cabe señalar que los usuarios de Visual Basic no deben preocuparse por los detalles de implementación de las interfaces de eventos, ya que esta plataforma de desarrollo proporciona medios sencillos para controlarlas. Este objeto puede declararse con WithEvents en Visual Basic.

Para el usuario de C++, esto significa que admite la interfaz IConnectionPointContainer. Para recibir notificaciones de eventos, un usuario de C++ debe crear un objeto derivado de la interfaz ICommandEvents y, a continuación, establecer la conexión entre este objeto y el origen de eventos implementado en el objeto Commands mediante los mecanismos COM estándar.

​

Propiedades

Nombre	Tipo	Descripción
Count	int, de solo lectura	Obtiene el número de comandos disponibles en el componente visual.
Element	MenuItemEnum, de solo lectura	Devuelve el identificador del comando correspondiente al índice especificado.

​

Métodos

Nombre	Descripción
DisableCommand	Deshabilita el comando especificado.
DoCommand	Ejecuta el comando especificado en modo síncrono o asíncrono.
EnableCommand	Habilita el comando especificado.
HasHotKey	Indica si alguna tecla de acceso rápido está asignada a algún comando.
IsUserCommandRegistered	Indica si el comando definido por el usuario especificado está registrado.
RegisterUserCommand	Registra un comando definido por el usuario.
UnregisterUserCommand	Anula el registro del comando definido por el usuario especificado.

​

Ejemplos

Este objeto se utiliza en los siguientes ejemplos de código: VisualComponents.

​

Consulte también

IImageViewer::Commands

IZoomViewer::Commands

IDocumentViewer::Commands

ITextEditor::Commands

ICommandEvents

Personalización del menú contextual y de la barra de herramientas de un componente visual