IShellView::UIActivate メソッド (shobjidl_core.h)

シェルビュー自体によって発生しないイベントによってビューウィンドウのアクティブ化状態が変更されたときに呼び出されます。たとえば、ツリーにフォーカスがあるときに TAB キーを押すと、ビューにフォーカスが与えられる必要があります。

構文

HRESULT UIActivate(
  UINT uState
);

uState

型: UINT

ウィンドウのアクティブ化状態を指定するフラグ。このパラメーターには、次の値のいずれかを指定できます。

Windows エクスプローラーでは、入力フォーカスを持つビューウィンドウが作成されました。つまり、シェルビューは、フォーカスされた状態に適したメニュー項目を設定できる必要があります。

シェルビューで入力フォーカスが失われているか、入力フォーカスなしで作成されたばかりです。シェルビューでは、フォーカスされていない状態に適したメニュー項目を設定できる必要があります。つまり、選択固有の項目を追加する必要はありません。

Windows エクスプローラーでは、シェルビューウィンドウが破棄されようとしています。シェルビューでは、すべての拡張ユーザーインターフェイスを削除する必要があります。これらは通常、マージされたメニューとマージされたモードレスポップアップウィンドウです。

シェルビューはフォーカスなしでアクティブです。このフラグは、 UIActivate が IShellView2 インターフェイスを介して公開されている場合にのみ使用されます。

型: HRESULT

成功 した場合はS_OK を返し、それ以外の場合は COM 定義のエラー値を返します。

メニュー項目を再調整する前に、シェルビューは通常、WM_SETFOCUS メッセージをフックし、 OnViewWindowActive メソッドを呼び出します。シェルビューは、メニュー項目を再結合するために NM_KILLFOCUS メッセージをフックしないようにする必要があります。

アクティブ化状態の変更をビューに通知するには、このメソッドを呼び出します。

アクティブ化の状態を追跡し、必要に応じて動作を変更するには、このメソッドを使用します。

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)
[DLL]	Shell32.dll (バージョン 4.0 以降)