COleClientItem

└COleClientItem

COleClientItem类定义了OLE项的包容器界面。OLE项代表由服务器应用建立并维护的数据，它可以“无缝地”和文档合成一体，成为“复合文档”，而在用户看来就如同一个单一的文档一样。“复合文档”由OLE项和一包含文档组成。
OLE项可以嵌入或者是链接到复合文档中。当嵌入时，它作为复合文档的一部分进行存储。如果是链接的，数据存储在由服务器应用建立的分离的文件中，而仅把指向它的一个链接存到复合文档中。所有的OLE项包含有说明被调用来编辑它们的服务器应用的信息。
COleClientItem定义了一些可重载的函数，用以响应从服务器应用发出的请求；它们以通知的形式发生作用。这使得服务器应用能将用户编辑OLE项所作的修改通知包容器，或在用户编辑的同时获取相关的信息。COleClientItem能同COleDocument, COleLinkingDoc或COleServerDoc等类一起使用。使用COleClientItem时, 从COleClientItem 派生一个类，执行OnChange成员函数，定义怎样将对项的修改通知包容器。若要支持就地激活的功能，得重载OnGetItemPosition 成员函数。该函数提供了OLE项的显示位置的有关信息。
关于使用包容器界面的信息，请参阅联机文档《Visual C++ 程序员指南》中的“包容器：实现一个包容器”和“激活”。
注意：
OLE文档中，“对象（objects）”指的是嵌入或链接项本身；而“类（classes）”则指的是项的类型。本参考手册用“项”将OLE实体和C++的对象区分开来；用“类型”将OLE类同C++类区分开来。
#include <afxole.h>
请参阅：COleServerItem

COleClientItem成员函数

构造函数

COleClientItem

构造一个COleClientItem对象

创建

CreateFromClipboard	从剪贴板中创建一个嵌入项
CreateFromData	从一个数据对象创建一个嵌入项
CanCreateFromData	指示一个包容器应用是否能创建一个嵌入对象
CreateFromFile	从一个文件创建一个嵌入项
CreateStaticFromClipboard	从剪贴板创建一个静态项
CreateStaticFromData	从一个数据对象创建一个静态项
CreateLinkFromClipboard	从剪贴板创建一个链接项
CreateLinkFromData	从一个数据对象创建一个链接项
CanCreateLinkFromData	指示一个包容器应用是否能创建一个嵌入对象
CreateLinkFromFile	从一个文件创建一个链接项
CreateNewItem	启动服务器应用创建一个新的嵌入项
CreateCloneFrom	创建一个已经存在的项的拷贝

状态

GetLastStatus	返回上一次OLE操作的状态
GetIconFromRegistry	检索与特定CLSID服务器相关的图标的句柄
GetType	返回OLE项的类型(嵌入、链接或静态)
GetExtent	返回OLE项的矩形边界
GetCachedExtent	返回OLE项的矩形边界
GetClassID	获取给定项的类标识
GetUserType	获取描述项类型的字符串
GetIconicMetafile	获取用以描绘项的图标的元文件
SetIconicMetafile	将用以描绘项的图标的元文件存入缓存
GetDrawAspect	获取显示项的当前视图
SetDrawAspect	设置显示项的当前视图
GetItemState	获取项的当前状态
GetActiveView	获取项被就地激活的视图
IsModified	如果项在上次保存后被修改了，则返回TRUE
IsRunning	如果项的服务器应用正在运行，则返回TRUE
IsInPlaceActive	如果项处于就地激活状态，则返回TRUE
IsOpen	如果项在服务器应用中处于打开状态，则返回TRUE

数据存取

GetDocument	返回包含给定项的COleDocument对象
AttachDataObject	存取OLE对象中的数据

对象转换

ConvertTo	转换项到另一类型
ActivateAs	激活项为另一类型
Reload	在调用ActivateAs后重载项

剪贴板操作

CanPaste	指示剪贴板中是否包含有可重载或静态的OLE项
CanPasteLink	指示剪贴板中是否包含有可链接的OLE项
DoDragDrop	执行一次拖放操作
CopyToClipboard	将OLE项复制到剪贴板中
GetClipboardData	获取剪贴板中的数据。这些数据可能是调用CopyToClipboard成员函数后放置在剪贴板中的

一般操作

Close	关闭OLE项指向服务器的一个链接，但不销毁OLE项本身
Release	释放OLE链接项的链接，如果处于打开状态则关闭它。释放操作也不销毁客户项本身
Delete	如果是一个链接的OLE项，则删除或关闭它
Draw	绘制OLE项
Run	运行和项相关的应用
SetPrintDevice	设置该客户项的打印目标设备

激活

Activate	打开OLE项进行操作，并执行指定的动作
DoVerb	执行指定动作
Deactivate	释放激活项
DeactivateUI	恢复包容器应用的用户界面到初始状态
ReactivateAndUndo	重新激活项，并撤消上次的就地编辑操作
SetItemRects	设置项的矩形边界
GetInPlaceWindow	返回项的就地编辑窗口的指针

嵌入对象操作

SetHostNames	编辑OLE项，设置服务器显示的名字
SetExtent	设置OLE项的边界矩形

链接对象操作和状态

GetLinkUpdateOptions	返回链接项的更新模式 (高级特性)
SetLinkUpdateOptions	设置链接项的更新模式 (高级特性)
UpdateLink	更新项的描述缓存
IsLinkUpToDate	如果一个链接项和它的资源文档是最新的，则返回TRUE

重载函数

OnChange	服务器改变OLE项时调用。要求重实现
OnGetClipboardData	框架调用以获取复制到剪贴板的数据
OnInsertMenus	框架调用以创建一个混合菜单条
OnSetMenu	框架调用以安装和删除一个混合菜单
OnRemoveMenus	框架调用以从一个混合菜单中删除包容器菜单
OnUpdateFrameTitle	框架调用以更新框架窗口的标题栏
OnShowControlBars	框架调用以显示或隐藏控件条
OnGetItemPosition	框架调用以项的相对视图的位置
OnScrollBy	框架调用以滚动项到视图内
OnDeactivateUI	当服务器删除用户界面时，由框架调用
OnDiscardUndoState	框架调用以丢弃项的撤消操作状态信息
OnDeactivateAndUndo	框架调用以在激活后进行撤消操作
OnShowItem	框架调用以显示OLE项
CanActivate	框架调用以判定是否允许就地激活
OnActivate	框架调用以通知已经激活的项
OnActivateUI	框架调用以通知已经激活的并且需要显示用户界面的项
OnGetClipRect	框架调用以取得项的剪切矩形坐标
OnGetWindowContext	当项就地激活时，由框架调用
OnDeactivate	当项取消时，由框架调用
OnChangeItemPosition	当项位置改变时，由框架调用