IOleInPlaceSite::OnInPlaceActivate メソッド (oleidl.h)

オブジェクトの 1 つがインプレースでアクティブ化されていることをコンテナーに通知します。

構文

HRESULT OnInPlaceActivate();

戻り値

コンテナーでインプレース アクティブ化が許可されている場合、このメソッドはS_OKを返します。 その他の可能な戻り値は次のとおりです。

リターン コード	説明
E_UNEXPECTED	予期しないエラーが発生しました。

解説

呼び出し元へのメモ

OnInPlaceActivate は、アクティブな埋め込みオブジェクトが初めてインプレースでアクティブ化されるときに呼び出されます。 コンテナーは、オブジェクトがアクティブになっていることに注意する必要があります。

実装者へのメモ

埋め込みオブジェクトへのリンクをサポートするコンテナーは、UI 非アクティブで非表示状態で実行されている場合に、インプレース オブジェクトの実行を適切に管理する必要があります。 インプレース オブジェクトをすばやく再アクティブ化するには、コンテナーの IOleInPlaceSite::D eactivateAndUndo メソッドが呼び出されるまで、コンテナーで IOleObject::Close を呼び出さないでください。 リンク クライアントがサイレント に更新された場合に、オブジェクトが不安定な状態のままになることを防ぎ、コンテナーで OleLockRunning を呼び出して実行中の状態のオブジェクトをロックする必要があります。 これにより、非表示のインプレース オブジェクトをコンテナーに保存する前にシャットダウンできなくなります。

要件

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

関連項目

IOleInPlaceSite