COleServerItem

└COleServerItem

COleServerItem类提供对OLE项的服务器接口。一个链接项可以表示某些或全部服务器文档。一个嵌入项则总是表示整个服务器文档。
COleServerItem类定义了几个可重载的成员函数，这些函数由OLE系统动态链接库（DLL）调用，通常用于响应来自容器应用程序的请求。这些成员函数允许容器应用程序以各种方式间接地对项进行操作，例如显示它，执行它的动词，或以各种格式获取它的数据。
要使用COleServerItem，可从COleServerItem中派生一个新类，并实现OnDraw和Serialize成员函数。OnDraw函数提供项的元文件表示，使它可在容器应用程序打开一个命令文档时显示。CObject的Serialize函数提供项的本机表示，使得一个嵌入项可在服务器应用程序和容器应用程序之间直接传输。OnGetExtent函数提供项的固有对象给容器应用程序，使得容器应用程序可以设置项的大小。
要获取更多有关服务器及其相关话题的信息，请参见“Visual C++程序员指南”中的文章“服务器：实现一个服务器”和文章“容器：高级特征”中的“创建一个容器/服务器应用程序”。
#include <afxole.h>\>
请参阅：COleClientItem, COleServerItem, COleTemplateServer

COleServerItem类成员

状态

GetDocument	返回包含此项的服务器文档
GetItemName	返回此项的名称。只用于链接项
SetItemName	设置此项的名称。只用于链接项
IsConnected	指示此项当前是否连接到一个活动的容器应用程序上
IsLinkedItem	指示此项是否表示一个链接式OLE项

操作

CopyToClipboard	将此项拷贝到剪贴板上
NotifyChanged	用自动链接更新来更新所有的容器
DoDragDrop	执行一次拖放操作
GetClipboardData	获取用于数据传输（拖放或剪贴）的数据源
GetEmbedSourceData	获取一个OLE项的CF_EMBEDSOURCE数据
AddOtherClipboardData	将显示和转换格式放进一个COleDataSource对象
GetLinkSourceData	获取一个OLE项的CF_LINKSOURCE数据
GetObjectDescriptorData	获取一个OLE项的CF_OBJECTDESCRIPTOR数据

构造

COleServerItem	构造一个COleServerItem对象
GetDataSource	获取用于存储转换格式的对象

可重载

OnDraw	当容器应用程序请求绘制此项时，调用该函数；需要实现
OnDrawEx	用于绘制专用化的项
OnUpdate	当此项所属的文档的某部分改变时，调用该函数
OnInitFromData	由框架调用该函数，该函数用指定的数据传输对象的内容来初始化一个OLE项
OnGetExtent	由框架调用此函数来获取此OLE项的大小
OnSetExtent	由框架调用此函数来设置此OLE项的大小
OnGetClipboardData	由框架调用此函数来获取将要拷贝到剪贴板中的数据
OnSetColorScheme	用于设置项的颜色表
OnSetData	用于设置项的数据
OnDoVerb	用于执行一个动词
OnQueryUpdateItems	用于确定是否有链接项需要更新
OnRenderData	获取数据为延迟提供的一部分
OnRenderFileData	将数据检取到一个CFile中，作为延迟提供的一部分
OnRenderGlobalData	将数据检取到一个HGLOBAL中，作为延迟提供的一部分
OnUpdateItems	用于更新服务器文档中所有项的显示高速缓存
OnOpen	由框架调用此函数来将此OLE项显示在它自己的顶层窗口中
OnShow	当容器应用程序请求显示此项时，调用该函数
OnHide	由框架调用该函数来隐藏此OLE项

数据成员

m_sizeExtent

通知服务器此OLE项有多少是可见的