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 つ以上の値を指定できます。

値 意味
CWP_ALL
0x0000
 子ウィンドウをスキップしない
CWP_SKIPDISABLED
0x0002
 無効な子ウィンドウをスキップします
CWP_SKIPINVISIBLE
0x0001
 非表示の子ウィンドウをスキップします
CWP_SKIPTRANSPARENT
0x0004
 透明な子ウィンドウをスキップします

戻り値

型: 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 で導入)

関連項目

概念

その他のリソース

ポイント

リファレンス

WindowFromPoint

Windows