ChildWindowFromPoint

親ウィンドウに属する子ウィンドウのうち、指定した点を含むものを判定する。検索は直下の子ウィンドウに限定され、孫やそれ以降の子孫は検索されない。

ChildWindowFromPoint hWndParent, Point

hWndParent : [intptr] 型: HWND 親ウィンドウへのハンドル。
Point : [int] 型: POINT hWndParent 相対の、検査する点のクライアント座標を定義する構造体。

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

解説

親ウィンドウに属する子ウィンドウのうち、指定した点を含むものを判定する。検索は直下の子ウィンドウに限定され、孫やそれ以降の子孫は検索されない。

[戻り値]
型: HWND
戻り値は、その点を含む子ウィンドウへのハンドル。子ウィンドウが非表示または無効でも返される。点が親ウィンドウの外にある場合、戻り値は
NULL。点が親ウィンドウ内にあるがどの子ウィンドウにも含まれない場合、戻り値は親ウィンドウへのハンドル。

[備考]
システムは親ウィンドウに関連付けられた子ウィンドウのハンドルを含む内部リストを保持する。リスト内のハンドルの順序は子ウィンドウの Z
オーダーに依存する。複数の子ウィンドウが指定された点を含む場合、システムはリスト内でその点を含む最初のウィンドウへのハンドルを返す。ChildWindowFromPoint
は標準コントロールの HTTRANSPARENT 領域をコントロールの他の部分と同じように扱う。これに対し
RealChildWindowFromPoint は HTTRANSPARENT
領域を異なる扱いとし、コントロールの透明領域の背後にある子ウィンドウを返す。たとえば点がグループボックスの透明領域内にある場合、ChildWindowFromPoint
はグループボックスを返すが、RealChildWindowFromPoint はグループボックスの背後にある子ウィンドウを返す。ただし両
API ともスタティックフィールドが HTTRANSPARENT を返す場合でもそれを返す。

情報