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
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)