IOleInPlaceSiteEx::OnInPlaceActivateEx メソッド (ocidl.h)
アクティブ化時にそれ自体を再描画する必要があるかどうかを判断するために、埋め込みオブジェクトによって呼び出されます。
構文
HRESULT OnInPlaceActivateEx(
[out] BOOL *pfNoRedraw,
[in] DWORD dwFlags
);
パラメーター
[out] pfNoRedraw
現在の再描画状態を受け取る変数へのポインター。 アクティブ化時にオブジェクト自体を再描画する必要がない場合、状態は TRUE 、それ以外の場合は FALSE です。 ウィンドウレス オブジェクトは通常、このパラメーターによって返される値を必要とせず、この値を計算する負担をコンテナーに保存するために NULL ポインターを渡すことができます。
[in] dwFlags
オブジェクトがウィンドウレス オブジェクトとしてアクティブ化されているかどうかを示します。 このパラメーターは ACTIVATEFLAGS 列挙から値を受け取ります。 ウィンドウレス オブジェクトの詳細については、「 IOleInPlaceSiteWindowless 」を参照してください。
戻り値
コンテナーでインプレース アクティブ化が許可されている場合、このメソッドはS_OKを返します。 その他の可能な戻り値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
予期しないエラーが発生しました。 |
注釈
このメソッドは 、IOleInPlaceSite::OnInPlaceActivate を置き換えます。 古いメソッドを使用する場合、オブジェクトはアクティブ化時に常にそれ自体を再描画する必要があります。
ウィンドウレス オブジェクトをアクティブ化するかどうかをコンテナーに通知するには、 IOleInPlaceSite::OnInPlaceActivate の代わりにこのメソッドを使用する必要があります。
実装者へのメモ
コンテナーは、オブジェクトの無効化状態、z オーダー、クリッピング、およびその他の関連パラメーターを慎重にチェックして、pfNoRedraw で返される適切な値を決定する必要があります。コンテナーは、IOleInPlaceObjectWindowless インターフェイスで GetWindow メソッドを繰り返し呼び出す代わりに、ACTIVATEFLAGS 列挙の値をキャッシュできます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ocidl.h |