| 释义 |
COleClientItem
| CObject | | └CCmdTarget | | └CDocItem | | └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 | 当项位置改变时，由框架调用 |
|