Clase CDocObjectServerItem

Implementa verbos de servidor OLE específicamente para servidores de DocObject.

Sintaxis

class CDocObjectServerItem : public COleServerItem

Miembros

Constructores protegidos

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

Métodos públicos

Nombre	Descripción
CDocObjectServerItem::GetDocument	Recupera un puntero al documento que contiene el elemento.

Métodos protegidos

Nombre	Descripción
CDocObjectServerItem::OnDoVerb	Se le llama para ejecutar un verbo.
CDocObjectServerItem::OnHide	Genera una excepción si el marco intenta ocultar un elemento DocObject.
CDocObjectServerItem::OnShow	El marco lo llama para activar el elemento DocObject en contexto. Si el elemento no es DocObject, llama a COleServerItem::OnShow.

Comentarios

CDocObjectServerItem define funciones miembro que se pueden invalidar: OnHide, OnDoVerb y OnShow.

Para usar CDocObjectServerItem, asegúrese de que la invalidación OnGetEmbeddedItem en la clase derivada de COleServerDoc devuelve un objeto CDocObjectServerItem nuevo. Si necesita cambiar cualquier funcionalidad del elemento, puede crear una instancia de su propia clase derivada de CDocObjectServerItem.

Para más información sobre DocObjects, consulte CDocObjectServer y COleCmdUI en la referencia de MFC.

Jerarquía de herencia

CObject

CCmdTarget

CDocItem

COleServerItem

CDocObjectServerItem

Requisitos

Encabezado: afxdocob.h

CDocObjectServerItem::CDocObjectServerItem

Construye un objeto CDocObjectServerItem.

CDocObjectServerItem(COleServerDoc* pServerDoc, BOOL bAutoDelete);

Parámetros

pServerDoc
Puntero al documento que contendrá el elemento DocObject nuevo.

bAutoDelete
Indica si el objeto se puede eliminar cuando se libera un vínculo dirigido a él. Establezca el argumento en FALSE si el documento CDocObjectServerItem es parte integral de los datos del documento. Establézcalo en TRUE si el objeto es una estructura secundaria que se usa para identificar un intervalo de los datos del documento que el marco puede eliminar.

CDocObjectServerItem::GetDocument

Recupera un puntero al documento que contiene el elemento.

COleServerDoc* GetDocument() const;

Valor devuelto

Puntero al documento que contiene el elemento; será un valor NULL si el elemento no forma parte de un documento.

Comentarios

Esto permite el acceso al documento de servidor que se pasó como argumento al constructor CDocObjectServerItem.

CDocObjectServerItem::OnDoVerb

El marco de trabajo llama a este método para ejecutar el verbo especificado.

virtual void OnDoVerb(LONG iVerb);

Parámetros

iVerb
Especifica el verbo que se va a ejecutar. Para los valores posibles, consulte IOleObject::DoVerb en Windows SDK.

Comentarios

La implementación predeterminada llama a la función miembro OnShow si el elemento es DocObject y se especifica OLEIVERB_INPLACEACTIVATE o OLEIVERB_SHOW. Si el elemento no es DocObject o se especifica otro verbo, la implementación predeterminada llama a COleServerItem::OnDoVerb.

CDocObjectServerItem::OnHide

El marco llama a este método para ocultar el elemento.

virtual void OnHide();

Comentarios

La implementación predeterminada genera una excepción si el elemento es DocObject. No se puede ocultar un elemento DocObject activo porque toma toda la vista. Debe desactivar el elemento DocObject para que desaparezca. Si el elemento no es DocObject, la implementación predeterminada llama a COleServerItem::OnHide.

CDocObjectServerItem::OnShow

El marco lo llama para indicar a la aplicación de servidor que active el elemento DocObject en contexto.

virtual void OnShow();

Comentarios

Si el elemento no es DocObject, la implementación predeterminada llama a COleServerItem::OnShow. Invalide esta función si desea realizar un procesamiento especial al abrir un objeto DocObject.

Consulte también

COleServerItem (clase)
Gráfico de jerarquías
CDocObjectServer (clase)
COleDocObjectItem (clase)