CDocObjectServerItem 类

实现特别针对 DocObject 服务器的 OLE 服务器谓词。

语法

class CDocObjectServerItem : public COleServerItem

成员

受保护构造函数

名称 描述
CDocObjectServerItem::CDocObjectServerItem 构造 CDocObjectServerItem 对象。

公共方法

名称 描述
CDocObjectServerItem::GetDocument 检索指向包含该项的文档的指针。

受保护方法

名称 描述
CDocObjectServerItem::OnDoVerb 调用以执行谓词。
CDocObjectServerItem::OnHide 如果框架试图隐藏 DocObject 项,则引发异常。
CDocObjectServerItem::OnShow 由框架调用以就地激活 DocObject 项。 如果该项不是 DocObject,则调用 COleServerItem::OnShow

注解

CDocObjectServerItem 定义了可覆盖的成员函数:OnHideOnDoVerbOnShow

若要使用 CDocObjectServerItem,请确保 COleServerDoc 派生类中的 OnGetEmbeddedItem 覆盖返回新的 CDocObjectServerItem 对象。 如果需要更改项中的任何功能,可以创建自己的 CDocObjectServerItem 派生类的新实例。

有关 DocObjects 的详细信息,请参阅 MFC 参考中的 CDocObjectServerCOleCmdUI

继承层次结构

CObject

CCmdTarget

CDocItem

COleServerItem

CDocObjectServerItem

要求

标头:afxdocob.h

CDocObjectServerItem::CDocObjectServerItem

构造 CDocObjectServerItem 对象。

CDocObjectServerItem(COleServerDoc* pServerDoc, BOOL bAutoDelete);

参数

pServerDoc
指向将包含新 DocObject 项的文档的指针。

bAutoDelete
指示在释放对象的链接时是否可以删除对象。 如果 CDocObjectServerItem 对象是文档数据的组成部分,请将参数设置为 FALSE。 如果对象是用于标识文档数据中可由框架删除的范围的辅助结构,则将其设置为 TRUE。

CDocObjectServerItem::GetDocument

检索指向包含该项的文档的指针。

COleServerDoc* GetDocument() const;

返回值

指向包含该项的文档的指针;如果项不是文档的一部分,则为 NULL。

备注

这样,就可以访问作为参数传递给 CDocObjectServerItem 构造函数的服务器文档。

CDocObjectServerItem::OnDoVerb

由框架调用以执行指定的谓词。

virtual void OnDoVerb(LONG iVerb);

参数

iVerb
指定要执行的谓词。 有关可能的值,请参阅 Windows SDK 中的 IOleObject::DoVerb

注解

如果项是 DocObject 并且指定了 OLEIVERB_INPLACEACTIVATE 或 OLEIVERB_SHOW,则默认实现调用 OnShow 成员函数。 如果项不是 DocObject 或指定了不同的谓词,则默认实现调用 COleServerItem::OnDoVerb

CDocObjectServerItem::OnHide

由框架调用以隐藏项。

virtual void OnHide();

备注

如果项是 DocObject,则默认实现会引发异常。 不能隐藏活动的 DocObject 项,因为它需要整个视图。 必须停用 DocObject 项以使其消失。 如果项不是 DocObject,则默认实现调用 COleServerItem::OnHide

CDocObjectServerItem::OnShow

由框架调用以指示服务器应用程序就地激活 DocObject 项。

virtual void OnShow();

备注

如果项不是 DocObject,则默认实现调用 COleServerItem::OnShow。 如果要在打开 DocObject 项时执行特殊处理,请覆盖此函数。

另请参阅

COleServerItem 类
层次结构图
CDocObjectServer 类
COleDocObjectItem 类