ChildWindowFromPoint 函式 (winuser.h)

發行項
08/27/2023

判斷屬於父視窗的子視窗是否包含指定的點。搜尋僅限於立即子視窗。不會搜尋子系和更深的子系視窗。

若要略過特定子視窗，請使用 ChildWindowFromPointEx 函式。

語法

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

參數

[in] hWndParent

類型： HWND

父視窗的控制碼。

[in] Point

類型： POINT

結構，定義所要檢查點之 相對於 hWndParent的用戶端座標。

傳回值

類型： HWND

傳回值是包含點的子視窗控制碼，即使隱藏或停用子視窗也一樣。如果點位於父視窗之外，則傳回值為 Null。如果點位於父視窗內，但不在任何子視窗內，則傳回值是父視窗的控制碼。

備註

系統會維護內部清單，其中包含與父視窗相關聯之子視窗的控制碼。清單中的控制碼順序取決於子視窗的 Z 順序。如果多個子視窗包含指定的點，系統會將控制碼傳回至清單中包含該點的第一個視窗。

ChildWindowFromPoint 會將標準控制項的 HTTRANSPARENT 區域視為控制項的其他部分。相反地， RealChildWindowFromPoint 會以不同的方式處理 HTTRANSPARENT 區域;它會傳回控制項透明區域後方的子視窗。例如，如果點位於 groupbox 的透明區域中， ChildWindowFromPoint 會傳回 groupbox，而 RealChildWindowFromPoint 則會傳回 groupbox 背後的子視窗。不過，這兩個 API 都會傳回靜態欄位，即使它也會傳回 HTTRANSPARENT。

範例

如需範例，請參閱使用下拉式方塊中的。

規格需求


最低支援的用戶端	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 版)