プラットフォーム SDK
FindWindow

指定された文字列と一致するクラス名とウィンドウ名を持つトップレベルウィンドウ（ 親を持たないウィンドウ）のハンドルを返します。この関数は、子ウィンドウは探しません。検索では、大文字小文字は区別されません。

子ウィンドウを探すには、FindWindowEx 関数を使ってください。FindWindowEx 関数による検索は、指定した子ウィンドウから開始されます。

HWND FindWindow(
  LPCTSTR lpClassName,  // クラス名
  LPCTSTR lpWindowName  // ウィンドウ名
);

パラメータ

lpClassName
NULL で終わる文字列へのポインタか、クラスアトムを指定します。クラスアトムを指定する場合は、RegisterClass 関数または RegisterClassEx 関数の呼び出しにより作成したものを使用します。lpClassName パラメータの下位ワードにアトムを格納し、上位ワードに 0 を格納します。

文字列を指定する場合は、ウィンドウクラスの名前を指定します。クラス名には、RegisterClass 関数または RegisterClassEx 関数で登録した名前か、定義済みのコントロールクラス名を指定できます。

lpWindowName
ウィンドウ名（ ウィンドウのタイトル）が入った NULL で終わる文字列へのポインタを指定します。NULL を指定すると、あらゆるウィンドウ名が該当するものとみなされます。

戻り値

関数が成功すると、指定したクラス名とウィンドウ名を持つウィンドウのハンドルが返ります。

関数が失敗すると、NULL が返ります。拡張エラー情報を取得するには、 関数を使います。

解説

lpWindowName パラメータが NULL でない場合、FindWindow 関数は、GetWindowText 関数を呼び出して、比較に使用するウィンドウ名を取得します。この処理で発生する可能性のある問題について、GetWindowText 関数の解説を参照してください。

対応情報

Windows NT/2000：Windows NT 3.1 以降
Windows 95/98：Windows 95 以降
ヘッダー：Winuser.h で宣言、Windows.h をインクルード
インポートライブラリ：User32.lib を使用
Unicode：Windows NT/2000 は Unicode 版と ANSI 版を実装

参照

EnumWindows, FindWindowEx, GetClassName, GetWindowText, RegisterClass, RegisterClassEx

Page view tracker