COleClientItem选件类

项目
03/01/2013

定义容器接口OLE项。

class COleClientItem : public CDocItem

成员

公共构造函数

名称	说明
COleClientItem::COleClientItem	构造 COleClientItem 对象。

公共方法

名称	说明
COleClientItem::Activate	打开操作的OLE项并执行指定的谓词。
COleClientItem::ActivateAs	激活该项目为其他类型。
COleClientItem::AttachDataObject	访问OLE对象的数据。
COleClientItem::CanCreateFromData	指示容器应用程序是否可以创建嵌入对象。
COleClientItem::CanCreateLinkFromData	指示容器应用程序是否可以创建链接对象。
COleClientItem::CanPaste	指示剪贴板是否包含可嵌入或静态OLE项。
COleClientItem::CanPasteLink	指示剪贴板是否包含一个可连接的OLE项。
COleClientItem::Close	关闭一个到服务器的链接，但不销毁OLE项。
COleClientItem::ConvertTo	转换项目转换为另一种类型。
COleClientItem::CopyToClipboard	OLE项复制到剪贴板。
COleClientItem::CreateCloneFrom	创建现有项目的副本。
COleClientItem::CreateFromClipboard	创建从剪贴板中嵌入项。
COleClientItem::CreateFromData	创建从数据对象的一个嵌入项。
COleClientItem::CreateFromFile	创建嵌入项从文件。
COleClientItem::CreateLinkFromClipboard	创建从剪贴板中链接的项目。
COleClientItem::CreateLinkFromData	创建从数据对象中链接的项目。
COleClientItem::CreateLinkFromFile	创建链接的项将从文件。
COleClientItem::CreateNewItem	通过生成服务器应用程序创建一个新的嵌入项。
COleClientItem::CreateStaticFromClipboard	创建从剪贴板的静态项。
COleClientItem::CreateStaticFromData	创建从数据对象的静态项。
COleClientItem::Deactivate	停用该项目。
COleClientItem::DeactivateUI	还原容器应用程序的用户界面到其原始状态。
COleClientItem::Delete	如果它是链接的项目中，删除或关闭OLE项。
COleClientItem::DoDragDrop	执行拖放操作。
COleClientItem::DoVerb	执行指定的谓词。
COleClientItem::Draw	绘制OLE项。
COleClientItem::GetActiveView	获取项目就地激活的视图。
COleClientItem::GetCachedExtent	返回OLE项的矩形区域。
COleClientItem::GetClassID	获取当前项目的选件类ID.
COleClientItem::GetClipboardData	获取在剪贴板将放在通过调用 CopyToClipboard 成员函数的数据。
COleClientItem::GetDocument	返回包含当前项目的 COleDocument 对象。
COleClientItem::GetDrawAspect	获取呈现的项目的当前视图。
COleClientItem::GetExtent	返回OLE项的矩形区域。
COleClientItem::GetIconFromRegistry	Retrives到图标的句柄与特定CLSID的服务器。
COleClientItem::GetIconicMetafile	获取该图元文件用于绘制项的图标。
COleClientItem::GetInPlaceWindow	返回指向项目的就地编辑窗口。
COleClientItem::GetItemState	获取项的当前状态。
COleClientItem::GetLastStatus	返回最后OLE操作的状态。
COleClientItem::GetLinkUpdateOptions	返回一个链接的项目(高级功能)更新模式。
COleClientItem::GetType	返回类型(嵌入链接，或静态)的OLE项。
COleClientItem::GetUserType	获取描述项类型的字符串。
COleClientItem::IsInPlaceActive	如果项目是就地活动状态，返回 TRUE。
COleClientItem::IsLinkUpToDate	如果链接项的最新与其源文档，返回 TRUE。
COleClientItem::IsModified	返回 TRUE，如果修改项目，则它上次保存了。
COleClientItem::IsOpen	如果项目中当前打开服务器应用程序，返回 TRUE。
COleClientItem::IsRunning	如果项目的服务器应用程序运行，返回 TRUE。
COleClientItem::OnActivate	调用由框架通知项目激活它。
COleClientItem::OnActivateUI	调用由框架通知项目激活它应显示其用户界面。
COleClientItem::OnChange	调用，当服务器更改OLE项。需要的实现。
COleClientItem::OnDeactivate	调用由结构，当停用项目。
COleClientItem::OnDeactivateUI	调用由结构，当服务器移除了就地用户界面。
COleClientItem::OnGetClipboardData	调用由框架获取要复制的数据保存到剪贴板。
COleClientItem::OnInsertMenus	调用由框架创建复合菜单。
COleClientItem::OnRemoveMenus	调用由框架从复合菜单移除容器的菜单。
COleClientItem::OnSetMenu	调用framework安装和移除复合菜单。
COleClientItem::OnShowControlBars	调用由结构显示和隐藏控件条。
COleClientItem::OnUpdateFrameTitle	调用由框架更新框架窗口的标题栏。
COleClientItem::ReactivateAndUndo	重新激活项和移除最后就地编辑操作。
COleClientItem::Release	如果它是打开的，随OLE链接项的连接并将其关闭。不销毁客户端项目。
COleClientItem::Reload	在调用后重新加载项目。ActivateAs。
COleClientItem::Run	运行应用程序与该项目。
COleClientItem::SetDrawAspect	设置呈现的项目的当前视图。
COleClientItem::SetExtent	设置OLE项的边框。
COleClientItem::SetHostNames	设置服务器显示，编辑OLE项时的名称。
COleClientItem::SetIconicMetafile	该图元文件用于绘制项的图标使用的缓存。
COleClientItem::SetItemRects	设置项目的边框。
COleClientItem::SetLinkUpdateOptions	设置一个链接的项目(高级功能)更新模式。
COleClientItem::SetPrintDevice	将此客户端项目的输出目标设备。
COleClientItem::UpdateLink	更新项目的表示缓存。

受保护的方法

名称	说明
COleClientItem::CanActivate	调用由框架确定就地激活是否允许。
COleClientItem::OnChangeItemPosition	调用由框架，该项目的位置更改。
COleClientItem::OnDeactivateAndUndo	调用由框架在启动后取消。
COleClientItem::OnDiscardUndoState	调用由框架放弃该项的撤消状态信息。
COleClientItem::OnGetClipRect	调用由框架获取项目的矩形剪辑协调。
COleClientItem::OnGetItemPosition	调用由框架获取项的位置相对于视图。
COleClientItem::OnGetWindowContext	调用由结构，当就地激活项目。
COleClientItem::OnScrollBy	调用由框架移动项到视图。
COleClientItem::OnShowItem	调用由结构显示OLE项。

备注

OLE项表示数据，创建，并维护由服务器应用程序，可以“无缝”合并到文档中，以便向用户显示单文件。结果为“多文档”组成的OLE项，并包含文档。

可以嵌入到OLE项或链接。如果嵌入它，为复合文档的一部分，其数据存储区。如果该链接，其数据存储为服务器应用程序创建的一个单独的文件中，因此，该文件的一个链接在多个文档存储。任何OLE项包含指定应调用编辑这些服务器应用程序的信息。

COleClientItem 定义调用以响应来自服务器应用程序的请求的若干可重写的函数;这些overridables通常作为通知。这允许服务器应用程序通知用户进行，编辑OLE项的容器更改，或者检索在编辑过程中所需的信息。

COleClientItem 可用于 COleDocument、 COleLinkingDoc或 COleServerDoc 选件类。若要使用 COleClientItem，从中派生选件类并实现 OnChange 成员函数，定义容器如何响应所做的更改到项目。若要支持就地激活，请重写 OnGetItemPosition 成员函数。此功能提供有关OLE项的显示位置的信息。

有关使用容器接口的更多信息，请参见位于容器:实现容器和启动。

备注

Windows SDK 引用嵌入的资源和链接的项目为“对象”是指项类型为“选件类”。此引用使用术语“项”与相应的C++对象区分OLE实体和该术语“type”的C++选件类区分OLE类别。