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を返します。 その他の可能な戻り値は次のとおりです。
リターン コード | 説明 |
---|---|
|
操作が失敗しました。 |
|
ppViewNew の値は NULL です。 |
|
ビュー オブジェクトは、このインターフェイスを実装しません。 |
解説
このメソッドは、複製するビューと同じビュー コンテキストを持つ、別のビューポートとビュー サイトを使用して新しいビューを作成する場合に便利です。 通常、MDI アプリケーションをホストするコンテナーでは、このメソッドを呼び出して "ウィンドウ/新しいウィンドウ" 機能を提供します。
要件
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | docobj.h |