IShellBrowser::GetControlWindow メソッド (shobjidl_core.h)

ブラウザー コントロールへのウィンドウ ハンドルを取得します。

構文

HRESULT GetControlWindow(
  UINT id,
  HWND *phwnd
);

パラメーター

id

型: UINT

要求されているコントロール ハンドル。 このパラメーターには、次のいずれかの値を指定できます。

FCW_TOOLBAR

ブラウザーのツール バーへのウィンドウ ハンドルを取得します。

FCW_STATUS

ブラウザーのステータス バーへのウィンドウ ハンドルを取得します。

FCW_TREE

ブラウザーのツリー ビューへのウィンドウ ハンドルを取得します。

FCW_PROGRESS

ブラウザーの進行状況バーへのウィンドウ ハンドルを取得します。

phwnd

種類: HWND*

Windows エクスプローラー コントロールへのウィンドウ ハンドルのアドレス。

戻り値

種類: HRESULT

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

注釈

ビューがブラウザーのコントロールを直接操作できるように、GetControlWindow が使用されます。 FCW_TREE は、ツリーが存在するかどうかを判断するためにのみ使用する必要があります。

呼び出し元のアプリケーションに関する注意事項

GetControlWindow は、コントロール ウィンドウの状態を操作およびテストするために使用されます。 これらのコントロールにメッセージを直接送信しないでください。代わりに、 IShellBrowser::SendControlMsg を使用します。 このメソッドが NULL を返すように準備してください。 それ以降のバージョンの Windows エクスプローラーには、ツール バー、ステータス バー、またはツリー ウィンドウが含まれていない場合があります。

実装者へのメモ

GetControlWindow は、実装にウィンドウ ハンドルが存在する場合、これらのコントロールにウィンドウ ハンドルを返します。

IShellBrowser も参照してください

要件

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