IOleInPlaceSiteEx::OnInPlaceActivateEx メソッド (ocidl.h)

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

アクティブ化時にそれ自体を再描画する必要があるかどうかを判断するために、埋め込みオブジェクトによって呼び出されます。

構文

HRESULT OnInPlaceActivateEx(
  [out] BOOL  *pfNoRedraw,
  [in]  DWORD dwFlags
);

パラメーター

[out] pfNoRedraw

現在の再描画状態を受け取る変数へのポインター。アクティブ化時にオブジェクト自体を再描画する必要がない場合、状態は TRUE 、それ以外の場合は FALSE です。ウィンドウレスオブジェクトは通常、このパラメーターによって返される値を必要とせず、この値を計算する負担をコンテナーに保存するために NULL ポインターを渡すことができます。

[in] dwFlags

オブジェクトがウィンドウレスオブジェクトとしてアクティブ化されているかどうかを示します。このパラメーターは ACTIVATEFLAGS 列挙から値を受け取ります。ウィンドウレスオブジェクトの詳細については、「 IOleInPlaceSiteWindowless 」を参照してください。

戻り値

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

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

注釈

このメソッドは、IOleInPlaceSite::OnInPlaceActivate を置き換えます。古いメソッドを使用する場合、オブジェクトはアクティブ化時に常にそれ自体を再描画する必要があります。

ウィンドウレスオブジェクトをアクティブ化するかどうかをコンテナーに通知するには、 IOleInPlaceSite::OnInPlaceActivate の代わりにこのメソッドを使用する必要があります。

実装者へのメモ

コンテナーは、オブジェクトの無効化状態、z オーダー、クリッピング、およびその他の関連パラメーターを慎重にチェックして、pfNoRedraw で返される適切な値を決定する必要があります。

コンテナーは、IOleInPlaceObjectWindowless インターフェイスで GetWindow メソッドを繰り返し呼び出す代わりに、ACTIVATEFLAGS 列挙の値をキャッシュできます。

要件

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