COleCmdUI (clase)

Implementa un método para que MFC actualice el estado de los objetos relacionados con características de la aplicación orientadas a IOleCommandTarget.

Sintaxis

class COleCmdUI : public CCmdUI

Miembros

Constructores públicos

Nombre	Descripción
COleCmdUI::COleCmdUI	Construye un objeto COleCmdUI.

Métodos públicos

Nombre	Descripción
COleCmdUI::Enable	Establece o borra la marca de comando de habilitación.
COleCmdUI::SetCheck	Establece el estado de un comando de alternancia de activación/desactivación.
COleCmdUI::SetText	Devuelve un nombre de texto o una cadena de estado de un comando.

Comentarios

En una aplicación que no está habilitada para DocObjects, cuando el usuario ve un menú en la aplicación, MFC procesa UPDATE_COMMAND_UI notificaciones. Cada notificación recibe un objeto CCmdUI que se puede manipular para reflejar el estado de un comando determinado. Pero si la aplicación está habilitada para DocObjects, MFC procesa notificaciones UPDATE_OLE_COMMAND_UI y asigna objetos COleCmdUI.

COleCmdUI permite que DocObject reciba comandos que se originan en la interfaz de usuario de su contenedor (como FileNew, Open, Print, etc.) y que un contenedor reciba comandos que se originan en la interfaz de usuario de DocObject. Aunque IDispatch se podría usar para enviar los mismos comandos, IOleCommandTarget proporciona una manera más sencilla de consultar y ejecutar, ya que se basa en un conjunto estándar de comandos, normalmente sin argumentos, y no hay información de tipo implicada. COleCmdUI se puede usar para habilitar, actualizar y establecer otras propiedades de los comandos de la interfaz de usuario docObject. Si quiere invocar al comando, llame a COleServerDoc::OnExecOleCmd.

Para obtener más información sobre DocObjects, vea CDocObjectServer y CDocObjectServerItem.

Jerarquía de herencia

CCmdUI

COleCmdUI

Requisitos

Encabezado: afxdocob.h

COleCmdUI::COleCmdUI

Construye un objeto COleCmdUI asociado a un comando de interfaz de usuario determinado.

COleCmdUI(
    OLECMD* rgCmds,
    ULONG cCmds,
    const GUID* m_pGroup);

Parámetros

rgCmds
Lista de comandos admitidos asociados al GUID especificado. La estructura OLECMD asocia comandos a marcas de comandos.

cCmds
Recuento de comandos de rgCmds.

pGroup
Puntero a un GUID que identifica un conjunto de comandos.

Comentarios

El objeto COleCmdUI proporciona una interfaz programática para actualizar objetos de interfaz de usuario de DocObject, como elementos de menú o botones de barra de control. Los objetos de interfaz de usuario se pueden habilitar, deshabilitar, activar o borrar mediante el objeto COleCmdUI.

COleCmdUI::Enable

Llame a esta función para establecer la marca de comando del objeto COleCmdUI en OLECOMDF_ENABLED, que indica a la interfaz que el comando está disponible y habilitado, o para borrar la marca de comando.

virtual void Enable(BOOL bOn);

Parámetros

bOn
Indica si el comando asociado al objeto COleCmdUI debe estar habilitado o deshabilitado. Un valor distinto de cero habilita el comando; 0 lo deshabilita.

COleCmdUI::SetCheck

Llame a esta función para establecer el estado de un comando de alternancia de activación/desactivación.

virtual void SetCheck(int nCheck);

Parámetros

nCheck
Valor que determina el estado para establecer un comando de alternancia de activación/desactivación. Los valores son:

Valor	Description
1	Establece que el comando en activado.
2	Establece el comando en indeterminado; no se puede determinar el estado porque el atributo de este comando está en los estados activado y desactivado de la selección correspondiente.
cualquier otro valor	Establece que el comando en desactivado.

COleCmdUI::SetText

Llame a esta función para devolver un nombre de texto o una cadena de estado de un comando.

virtual void SetText(LPCTSTR lpszText);

Parámetros

lpszText
Puntero al texto que se va a usar con el comando.

Consulte también

CCmdUI (clase)
Gráfico de jerarquías