Funzione ChildWindowFromPointEx (winuser.h)

Articolo
03/13/2024

Determina quale delle finestre figlio appartenenti alla finestra padre specificata contiene il punto specificato. La funzione può ignorare le finestre figlio invisibili, disabilitate e trasparenti. La ricerca è limitata alle finestre figlio immediate. I nipoti e i discendenti più profondi non vengono cercati.

Sintassi

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

Parametri

[in] hwnd

Tipo: HWND

Handle per la finestra padre.

[in] pt

Tipo: POINT

Struttura che definisce le coordinate client (relative a hwndParent) del punto da controllare.

[in] flags

Tipo: UINT

Finestre figlio da ignorare. Questo parametro può essere uno o più dei valori seguenti.

Valore	Significato
CWP_ALL 0x0000	Non ignora le finestre figlio
CWP_SKIPDISABLED 0x0002	Ignora le finestre figlio disabilitate
CWP_SKIPINVISIBLE 0x0001	Ignora le finestre figlio invisibili
CWP_SKIPTRANSPARENT 0x0004	Ignora le finestre figlio trasparenti

Valore restituito

Tipo: HWND

Il valore restituito è un handle per la prima finestra figlio che contiene il punto e soddisfa i criteri specificati da uFlags. Se il punto si trova all'interno della finestra padre ma non all'interno di una finestra figlio che soddisfa i criteri, il valore restituito è un handle per la finestra padre. Se il punto si trova all'esterno della finestra padre o se la funzione ha esito negativo, il valore restituito è NULL.

Commenti

Il sistema gestisce un elenco interno che contiene 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 e soddisfa i criteri specificati da uFlags.

Requisiti

Requisito	Valore
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)