CDocObjectServerItem 类

项目
10/18/2023

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

语法

class CDocObjectServerItem : public COleServerItem

成员

受保护构造函数

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

公共方法

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

受保护方法

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

注解

CDocObjectServerItem 定义了可覆盖的成员函数：OnHide、OnDoVerb 和 OnShow。

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

有关 DocObjects 的详细信息，请参阅 MFC 参考中的 CDocObjectServer 和 COleCmdUI。

继承层次结构

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 类

通过