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