IOleDocumentView::SetInPlaceSite メソッド (docobj.h)

[アーティクル]
08/23/2023

コンテナーのドキュメントビューサイトをドキュメントのビューオブジェクトに関連付けます。

構文

HRESULT SetInPlaceSite(
  [in] IOleInPlaceSite *pIPSite
);

パラメーター

[in] pIPSite

ドキュメントビューサイトの IOleInPlaceSite インターフェイスへのポインター。このパラメーターには NULL を指定できます。この場合、ドキュメントビューオブジェクトはコンテナーに対するすべての asociation を失います。

戻り値

このメソッドは、ドキュメントビューサイトがドキュメントビューオブジェクトに正常に関連付けられた場合 ( または pIPSite が NULL の場合は関連付けが解除された場合) にS_OKを返します。その他の可能な戻り値は次のとおりです。

リターンコード	説明
E_FAIL	操作が失敗しました。

注釈

ドキュメントオブジェクトのアクティブ化の一環として、コンテナーはオブジェクトに IOleInPlaceSite のコンテナーの実装へのポインターを渡す必要があります。このポインターは、このメソッドが呼び出されるビューに関連付けられるドキュメントビューサイトを指定します。

コンテナーは通常、ドキュメントのアクティブ化要求に応答してこのポインターを渡します。ドキュメントは、 IOleDocumentSite::ActivateMe を呼び出し、アクティブ化するビューへのポインターをコンテナーに渡すことによって、このような要求を行います。次に、コンテナーはこのポインターを使用して IOleDocumentView::SetInPlaceSite を呼び出します。

呼び出し元へのメモ

コンテナーがドキュメントオブジェクトの読み込まれたインスタンスの単なるアクティブ化ではなく、ドキュメントオブジェクトの新しいインスタンスの作成とアクティブ化を要求している場合、ビューサイトは IOleDocument::CreateView の pIPSite 引数で渡されます。そのため、 IOleDocumentView::SetInPlaceSite の明示的な呼び出しは不要です。

実装者へのメモ

ビューサイトに既に関連付けられているビューでこのメソッドが呼び出された場合、ビューは新しいサイトで自身をアクティブ化する準備として、いくつかのハウスキーピングを実行する必要があります。最初に、ビューは現在のサイトでそれ自体を非アクティブ化し、そのサイトへのポインターを解放する必要があります。次に、新しい IOleInPlaceSite ポインターが NULL でない場合、ビューはポインターを保存し、その上で IUnknown::AddRef を呼び出す必要があります。その後、ビューは、コンテナーが新しいビューサイトでアクティブ化するタイミングを通知するまで待つ必要があります。

ドキュメントビューでは、このメソッドを完全に実装する必要があります。E_NOTIMPLは許容される戻り値ではありません。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	docobj.h

こちらもご覧ください

IOleDocumentView

IOleDocumentView::SetInPlaceSite

Share via