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

[アーティクル]
03/05/2024

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

構文

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 以降)

次の方法で共有