COleServerDoc

CObject
 └CCmdTarget
    └CDocument
       └COleDocument
          └COleLinkingDoc
             └COleServerDoc


COleServerDoc是OLE服务器文档的基类。服务器文档可包含COleServerItem对象，这些对象表示提供给嵌入或链接项的服务器接口。当服务器应用程序由容器应用程序启动来编辑嵌入项时，则将该项加载为服务器自己的服务器文档；COleServerDoc对象只包含一个COleServerItem对象，构成了整个文档。
当服务器应用程序由容器应用程序启动来编辑链接项时，则从磁盘装载一个现有的文档，一部分文档内容被加亮以指示链接项。
COleServerDoc对象也可包含COleClientItem类的项。这使得你可以创建容器－服务器应用程序。框架在为COleServerDoc对象提供服务的同时，也提供了用于存储COleClientItem项的函数。
如果服务器应用程序不支持链接，则服务器程序文档将总是只包含一个服务器项，该项将整个嵌入对象表示为一个文档。如果服务器应用程序支持链接，则每当将一个选择拷贝到剪贴板中时，它都必须创建一个服务器项。
要使用COleServerDoc，可从COleServerDoc类派生一个新类，并实现OnGetEmbeddedItem成员函数，该函数使得服务器应用程序能够支持嵌入项。你可以从COleServerItem派生一个新类来实现文档中的嵌入项，并从OnGetEmbeddedItem函数返回该类的这些对象。
为支持链接项，COleServerDoc提供了OnGetLinkedItem成员函数。应用程序可以利用该函数的缺省实现，或者当应用程序有自己的管理文档项的方式时，可以重载这个函数。
应用程序需要为它所支持的每种服务器文档类型派生一个COleServerDoc派生类。例如，如果服务器应用程序支持工作表格和图表，则它需要两个COleServerDoc派生类。
#include <afxole.h>
请参阅：COleDocument, COleLinkingDoc, COleTemplateServer


COleServerDoc类成员

构造
COleServerDoc构造一个COleServerDoc对象

属性
IsEmbedded表明文档是嵌入在一个容器文档中的还是独立运行的
IsInPlaceActive如果此项是当前现场被激活的则返回TRUE
GetEmbeddedItem返回一个指向代表整个文档的项的指针
GetItemPosition返回当前位置矩形用于现场编辑，该矩形是相对于容器应用程序的客户区的
GetItemClipRect返回当前用于现场编辑的剪贴板矩形
GetZoomFactor返回用像素表示的缩放因子

操作
OnExecOleCmd执行一个指定的命令或显示与该命令相关的帮助
NotifyChanged通知容器应用程序用户已经改变了文档
NotifyRename通知容器应用程序用户已经将文档改名了
NotifySaved通知容器应用程序用户已经保存了文档
NotifyClosed通知容器应用程序用户已经关闭了文档
SaveEmbedding通知容器应用程序保存文档
ActivateInPlace激活文档用于现场编辑
DeactivateAndUndo使服务器的用户界面不再是活动的
DiscardUndoState丢弃取消状态信息
RequestPositionChange改变现场可编辑框架的位置
ScrollContainerBy滚动容器程序文档
UpdateAllItems通知容器应用程序用户已经改变了文档

可重载
GetDocObjectServer重载这个函数可以创建一个新的CDocObjectServer对象，并表明这个文档是一个DocObject容器
OnUpdateDocument当保存一个作为嵌入项的服务器文档时，框架调用该函数来更新此项的容器应用程序的备份
OnGetEmbeddedItem调用此函数可获取一个表示整个文档的COleServerItem；此函数可用来获取一个嵌入项。需要实现
OnClose当容器应用程序请求关闭文档时，框架调用这个函数
OnSetHostNames当一个容器为一个嵌入对象设置窗口标题时，框架调用这个函数
OnShowDocument框架调用此函数来显示或隐藏文档
OnDeactivate当用户使一个现场被激活的项变为不活动时，框架调用此函数
OnDeactivateUI框架调用此函数来销毁控件和其它为现场激活所创建的用户界面元素。
OnSetItemRects框架调用此函数来定位现场编辑框架窗口在容器应用程序窗口中的位置
OnReactivateAndUndo框架调用此函数来取消在现场编辑期间所做的改变
OnFrameWindowActivate当容器的框架窗口被激活或成为不活动时，框架调用这个函数
OnDocWindowActivate当容器应用程序的文档框架窗口被激活或成为不活动时，框架调用这个函数
OnShowControlBars框架调用此函数来显示或隐藏用于现场编辑的控制条
OnResizeBorder当容器应用程序的框架窗口或文档窗口被改变大小时，框架调用这个函数
CreateInPlaceFrame框架调用此函数来创建一个用于现场编辑的框架窗口
DestroyInPlaceFrame框架调用此函数来销毁一个用于现场编辑的框架窗口