Funzione ChildWindowFromPoint (winuser.h)

Articolo
08/27/2023

Determina quale, se presente, delle finestre figlio appartenenti a una finestra padre contiene il punto specificato. La ricerca è limitata alle finestre figlio immediate. I nipoti e le finestre discendenti più profonde non vengono cercate.

Per ignorare determinate finestre figlio, usare la funzione ChildWindowFromPointEx .

Sintassi

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

Parametri

[in] hWndParent

Tipo: HWND

Handle per la finestra padre.

[in] Point

Tipo: POINT

Struttura che definisce le coordinate client, relative a hWndParent, del punto da controllare.

Valore restituito

Tipo: HWND

Il valore restituito è un handle per la finestra figlio che contiene il punto, anche se la finestra figlio è nascosta o disabilitata. Se il punto si trova all'esterno della finestra padre, il valore restituito è NULL. Se il punto si trova all'interno della finestra padre ma non all'interno di alcuna finestra figlio, il valore restituito è un handle per la finestra padre.

Commenti

Il sistema gestisce un elenco interno contenente gli handle delle finestre figlio associate a una finestra padre. L'ordine degli handle nell'elenco dipende dall'ordine Z delle finestre figlio. Se più finestre figlio contengono il punto specificato, il sistema restituisce un handle alla prima finestra dell'elenco che contiene il punto.

ChildWindowFromPoint gestisce un'area HTTRANSPARENT di un controllo standard come altre parti del controllo. Al contrario, RealChildWindowFromPoint tratta un'area HTTRANSPARENT in modo diverso; restituisce la finestra figlio dietro un'area trasparente di un controllo. Ad esempio, se il punto si trova in un'area trasparente di una casella di gruppo, ChildWindowFromPoint restituisce la casella di gruppo mentre RealChildWindowFromPoint restituisce la finestra figlio dietro la casella di gruppo. Tuttavia, entrambe le API restituiscono un campo statico, anche se anche questo restituisce HTTRANSPARENT.

Esempio

Per un esempio, vedere "Creazione di una barra degli strumenti casella combinata" in Uso di caselle combinate.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-window-l1-1-4 (introdotto in Windows 10 versione 10.0.14393)