ChildWindowFromPoint 関数 (winuser. h)

  • [アーティクル]

親ウィンドウに属する子ウィンドウのうち、指定したポイントを含む子ウィンドウが存在する場合はどれを指定します。 検索は、直接の子ウィンドウに制限されます。 孫、およびより深い子孫ウィンドウは検索されません。

特定の子ウィンドウをスキップするには、 ChildWindowFromPointEx 関数を使用します。

構文

HWND ChildWindowFromPoint(
  [in] HWND  hWndParent,
  [in] POINT Point
);

パラメーター

[in] hWndParent

型: HWND

親ウィンドウへのハンドル。

[in] Point

種類: POINT

チェックするポイントの hWndParent に対する相対的なクライアント座標を定義する構造体。

戻り値

型: HWND

戻り値は、子ウィンドウが非表示または無効になっている場合でも、ポイントを含む子ウィンドウへのハンドルです。 ポイントが親ウィンドウの外側にある場合、戻り値は NULL です。 ポイントが親ウィンドウ内にあり、子ウィンドウ内にない場合、戻り値は親ウィンドウへのハンドルです。

解説

システムは、親ウィンドウに関連付けられている子ウィンドウのハンドルを含む内部リストを保持します。 リスト内のハンドルの順序は、子ウィンドウの Z 順序によって異なります。 複数の子ウィンドウに指定されたポイントが含まれている場合、システムは、ポイントを含むリスト内の最初のウィンドウにハンドルを返します。

ChildWindowFromPoint は、標準コントロールの HTTRANSPARENT 領域をコントロールの他の部分と同じように扱います。 これに対し、 RealChildWindowFromPoint は HTTRANSPARENT 領域を異なる方法で扱います。コントロールの透明領域の背後にある子ウィンドウを返します。 たとえば、ポイントがグループボックスの透明領域にある場合、 ChildWindowFromPoint はグループボックスを返し、 RealChildWindowFromPoint はグループボックスの背後にある子ウィンドウを返します。 ただし、両方の API は静的フィールドを返しますが、 HTTRANSPARENT も返します。

例

例については、「コンボ ボックスの使用」の「 コンボ ボックス ツール バーの作成」を参照してください。

要件

   
サポートされている最小のクライアント 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 で導入)

関連項目

ChildWindowFromPointEx

概念

その他のリソース

ポイント

RealChildWindowFromPoint

リファレンス

WindowFromPoint

Windows