RealChildWindowFromPoint, fonction (winuser.h)

Article
03/04/2024

Récupère un handle dans la fenêtre enfant au point spécifié. La recherche est limitée aux fenêtres enfants immédiates ; les petits-enfants et les fenêtres descendantes plus profondes ne font pas l’objet d’une recherche.

Syntaxe

HWND RealChildWindowFromPoint(
  [in] HWND  hwndParent,
  [in] POINT ptParentClientCoords
);

Paramètres

[in] hwndParent

Type : HWND

Handle de la fenêtre dont l’enfant doit être récupéré.

[in] ptParentClientCoords

Type : POINT

Structure POINT qui définit les coordonnées client du point à vérifier.

Valeur retournée

Type : HWND

La valeur de retour est un handle de la fenêtre enfant qui contient le point spécifié.

Remarques

RealChildWindowFromPoint traite les zones HTTRANSPARENT d’un contrôle standard différemment des autres zones du contrôle ; il retourne la fenêtre enfant derrière une partie transparente d’un contrôle. En revanche, ChildWindowFromPoint traite les zones HTTRANSPARENT d’un contrôle de la même façon que les autres zones. Par exemple, si le point se trouve dans une zone transparente d’une groupbox, RealChildWindowFromPoint retourne la fenêtre enfant derrière une groupbox, tandis que ChildWindowFromPoint renvoie la groupbox. Toutefois, les deux API retournent un champ statique, même s’ils retournent également HTTRANSPARENT.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-window-l1-1-4 (introduit dans Windows 10, version 10.0.14393)