次の方法で共有

FindWindowExW 関数 (winuser.h)

  • [アーティクル]

クラス名とウィンドウ名が指定した文字列と一致するウィンドウへのハンドルを取得します。 この関数は、指定された子ウィンドウの後の子ウィンドウから始まる子ウィンドウを検索します。 この関数では、大文字と小文字が区別される検索は実行されません。

構文

HWND FindWindowExW(
  [in, optional] HWND    hWndParent,
  [in, optional] HWND    hWndChildAfter,
  [in, optional] LPCWSTR lpszClass,
  [in, optional] LPCWSTR lpszWindow
);

パラメーター

[in, optional] hWndParent

型: HWND

子ウィンドウを検索する親ウィンドウへのハンドル。

hwndParent が NULL場合、関数はデスクトップ ウィンドウを親ウィンドウとして使用します。 この関数は、デスクトップの子ウィンドウであるウィンドウを検索します。

hwndParent が HWND_MESSAGE場合、この関数はメッセージのみのウィンドウすべて検索します。

[in, optional] hWndChildAfter

型: HWND

子ウィンドウへのハンドル。 検索は、Z オーダーの次の子ウィンドウで始まります。 子ウィンドウは、子孫ウィンドウだけでなく、hwndParentの直接の子ウィンドウである必要があります。

hwndChildAfter NULL場合、検索は hwndParentの最初の子ウィンドウ 開始します。

hwndParent と hwndChildAfter の両方が NULL場合、関数はすべての最上位ウィンドウとメッセージのみのウィンドウを検索します。

[in, optional] lpszClass

型: LPCWSTR

RegisterClass または RegisterClassEx 関数の前回の呼び出しによって作成されたクラス名またはクラス アトム。 atom は、lpszClassの下位ワード 配置する必要があります。高次ワードはゼロでなければなりません。

lpszClass が文字列の場合は、ウィンドウ クラス名を指定します。 クラス名には、RegisterClass または RegisterClassExに登録されている任意の名前、または定義済みのコントロール クラス名を指定するか、MAKEINTATOM(0x8000)できます。 後者の場合、0x8000はメニュー クラスのアトムです。 詳細については、このトピックの「解説」セクションを参照してください。

[in, optional] lpszWindow

型: LPCWSTR

ウィンドウ名 (ウィンドウのタイトル)。 このパラメーターが NULL場合、すべてのウィンドウ名が一致します。

戻り値

型: HWND

関数が成功した場合、戻り値は、指定されたクラスとウィンドウ名を持つウィンドウへのハンドルです。

関数が失敗した場合、戻り値は NULL。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

FindWindowEx 関数は、直接の子ウィンドウのみを検索します。 他の子孫は検索されません。

lpszWindow パラメーターが NULLでない場合は、FindWindowEx は、GetWindowText 関数を呼び出して比較用のウィンドウ名を取得します。 発生する可能性がある問題の詳細については、GetWindowTextの「解説」セクション 参照してください。

アプリケーションは、次の方法でこの関数を呼び出すことができます。

FindWindowEx( NULL, NULL, MAKEINTATOM(0x8000), NULL );

0x8000はメニュー クラスのアトムであることに注意してください。 アプリケーションがこの関数を呼び出すと、アプリケーションによって作成されたコンテキスト メニューが表示されているかどうかを確認します。

手記

winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして FindWindowEx を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winuser.h (Windows.h を含む)
ライブラリ User32.lib
DLL User32.dll
API セットの ext-ms-win-ntuser-window-l1-1-1 (Windows 8.1 で導入)

関連項目

概念

EnumWindows の

FindWindow の

GetClassName を する

GetWindowText の

リファレンス

RegisterClass の

RegisterClassEx の

Windows の