FindWindowExW

クラス名およびウィンドウ名が指定した文字列と一致するウィンドウへのハンドルを取得する。関数は指定した子ウィンドウの次のウィンドウから子ウィンドウを検索する。この関数は大文字小文字を区別しない検索を行う。(Unicode)

FindWindowExW hWndParent, hWndChildAfter, lpszClass, lpszWindow

hWndParent : [intptr] 型: HWND 子ウィンドウを検索する親ウィンドウへのハンドル。hwndParent が NULL の場合、関数はデスクトップウィンドウを親ウィンドウとして使用する。hwndParent が HWND_MESSAGE の場合、関数はすべてのメッセージ専用ウィンドウを検索する。
hWndChildAfter : [intptr] 型: HWND 子ウィンドウへのハンドル。検索は Z オーダー内の次の子ウィンドウから開始される。子ウィンドウは hwndParent の直接の子ウィンドウでなければならず、単なる子孫ウィンドウではない。hwndChildAfter が NULL の場合、検索は hwndParent の最初の子ウィンドウから開始される。hwndParent と hwndChildAfter の両方が NULL の場合、関数はすべてのトップレベルおよびメッセージ専用ウィンドウを検索する。
lpszClass : [wstr] 型: LPCTSTR クラス名または直前の RegisterClass や RegisterClassEx 関数の呼び出しで作成されたクラスアトム。アトムは lpszClass の下位ワードに配置しなければならず、上位ワードは 0 でなければならない。
lpszWindow : [wstr] 型: LPCTSTR ウィンドウ名 (ウィンドウのタイトル)。このパラメータが NULL の場合、すべてのウィンドウ名が一致する。

(プラグイン / モジュール : user32.dll)

解説

クラス名およびウィンドウ名が指定した文字列と一致するウィンドウへのハンドルを取得する。関数は指定した子ウィンドウの次のウィンドウから子ウィンドウを検索する。この関数は大文字小文字を区別しない検索を行う。(Unicode)

[戻り値]
型: HWND
関数が成功した場合、戻り値は指定したクラス名およびウィンドウ名を持つウィンドウへのハンドルとなる。関数が失敗した場合、戻り値は NULL
となる。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
FindWindowEx 関数は直接の子ウィンドウのみを検索する。他の子孫は検索しない。lpszWindow パラメータが NULL
でない場合、FindWindowEx は GetWindowText 関数を呼び出して比較用にウィンドウ名を取得する。

情報

プラグイン / モジュールuser32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の user32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_user32_gen2.hs