ChildWindowFromPointEx 函式 (winuser.h)

  • 發行項

判斷屬於指定父視窗的子視窗是否包含指定的點。 函式可以忽略不可見、已停用和透明的子視窗。 搜尋僅限於立即子視窗。 不會搜尋子系和更深的子系。

語法

HWND ChildWindowFromPointEx(
  [in] HWND  hwnd,
  [in] POINT pt,
  [in] UINT  flags
);

參數

[in] hwnd

類型： HWND

父視窗的句柄。

[in] pt

類型： POINT

結構，定義相對於要檢查點) hwndParent (的用戶端座標。

[in] flags

類型： UINT

要略過的子視窗。 此參數可以是下列一或多個值。

值 意義
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)
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-ntuser-window-l1-1-4 (Windows 10 10.0.14393 版)

另請參閱

概念

其他資源

點

參考

WindowFromPoint

Windows