| 词条 | COleClientItem |
| 释义 | COleClientItem类定义了OLE项的包容器界面。OLE项代表由服务器应用建立并维护的数据，它可以“无缝地”和文档合成一体，成为“复合文档”，而在用户看来就如同一个单一的文档一样。“复合文档”由OLE项和一包含文档组成。 OLE项可以嵌入或者是链接到复合文档中。当嵌入时，它作为复合文档的一部分进行存储。如果是链接的，数据存储在由服务器应用建立的分离的文件中，而仅把指向它的一个链接存到复合文档中。所有的OLE项包含有说明被调用来编辑它们的服务器应用的信息。 COleClientItem定义了一些可重载的函数，用以响应从服务器应用发出的请求；它们以通知的形式发生作用。这使得服务器应用能将用户编辑OLE项所作的修改通知包容器，或在用户编辑的同时获取相关的信息。COleClientItem能同COleDocument, COleLinkingDoc或COleServerDoc等类一起使用。使用COleClientItem时, 从COleClientItem 派生一个类，执行OnChange成员函数，定义怎样将对项的修改通知包容器。若要支持就地激活的功能，得重载OnGetItemPosition 成员函数。该函数提供了OLE项的显示位置的有关信息。 注意： OLE文档中，“对象（objects）”指的是嵌入或链接项本身；而“类（classes）”则指的是项的类型。 #include <afxole.h> 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 当项位置改变时，由框架调用 |
| 随便看 |
百科全书收录4421916条中文百科知识，基本涵盖了大多数领域的百科知识，是一部内容开放、自由的电子版百科全书。