共用方式為

(docobj.h) IOleDocumentView：：Clone 方法

  • 發行項

建立與目前檢視相同之內部狀態的重複檢視物件。

語法

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