通过

IOleDocumentView：：Clone 方法 (docobj.h)

  • 项目

创建内部状态与当前视图相同的重复视图对象。

语法

HRESULT Clone(
  [in]  IOleInPlaceSite  *pIPSiteNew,
  [out] IOleDocumentView **ppViewNew
);

参数

[in] pIPSiteNew

指向 IOleInPlaceSite 接口的指针，该接口表示将在其中激活新视图对象的视图站点。 接收此指针时，要克隆的视图应将其传递到新视图的 IOleDocumentView：：SetInPlaceSite 方法。 此指针可以为 NULL，在这种情况下，调用方负责直接在新视图上调用 IOleDocumentView：：SetInPlaceSite 。

[out] ppViewNew

指向 IOleDocumentView 指针变量的指针，该变量接收指向新视图对象的接口指针。 调用方负责在不再需要 ppViewNew 时发布它。

返回值

此方法在成功时返回S_OK。 其他可能的返回值包括以下内容。

返回代码 说明
E_FAIL
 此操作失败。
E_POINTER
 ppViewNew 中的值为 NULL。
E_NOTIMPL
 视图对象不实现此接口。

备注

此方法可用于创建具有不同视区和视图网站但视图上下文与要克隆的视图相同的新视图。 通常，托管 MDI 应用程序的容器将调用此方法以提供“窗口/新建窗口”功能。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 docobj.h

请参阅

IOleDocumentView

IOleDocumentView：：SetInPlaceSite