ChildWindowFromPointEx 関数 (winuser.h)
指定した親ウィンドウに属する子ウィンドウのうち、指定したポイントを含む子ウィンドウが存在する場合はどれを指定します。 この関数は、非表示、無効、透明の子ウィンドウを無視できます。 検索は、直接の子ウィンドウに制限されます。 孫とより深い子孫は検索されません。
構文
HWND ChildWindowFromPointEx(
[in] HWND hwnd,
[in] POINT pt,
[in] UINT flags
);
パラメーター
[in] hwnd
型: HWND
親ウィンドウへのハンドル。
[in] pt
種類: POINT
チェックするポイントのクライアント座標 ( hwndParent に対する相対座標) を定義する構造体。
[in] flags
型: UINT
スキップする子ウィンドウ。 このパラメーターには、次の 1 つ以上の値を指定できます。
値 | 意味 |
---|---|
|
子ウィンドウをスキップしない |
|
無効な子ウィンドウをスキップします |
|
非表示の子ウィンドウをスキップします |
|
透明な子ウィンドウをスキップします |
戻り値
型: HWND
戻り値は、ポイントを含み、 uFlags で指定された条件を満たす最初の子ウィンドウへのハンドルです。 ポイントが親ウィンドウ内にあり、条件を満たす子ウィンドウ内にない場合、戻り値は親ウィンドウへのハンドルです。 ポイントが親ウィンドウの外側にある場合、または関数が失敗した場合、戻り値は NULL になります。
注釈
システムは、親ウィンドウに関連付けられている子ウィンドウのハンドルを含む内部リストを保持します。 リスト内のハンドルの順序は、子ウィンドウの Z 順序によって異なります。 複数の子ウィンドウに指定されたポイントが含まれている場合、システムは、ポイントを含むリストの最初のウィンドウにハンドルを返し、 uFlags で指定された条件を満たします。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | winuser.h (Windows.h を含む) |
Library | User32.lib |
[DLL] | User32.dll |
API セット | ext-ms-win-ntuser-window-l1-1-4 (Windows 10 バージョン 10.0.14393 で導入) |
関連項目
概念
その他のリソース
リファレンス