ChildWindowFromPoint, fonction (winuser.h)

Article
08/27/2023

Détermine laquelle, le cas échéant, des fenêtres enfants appartenant à une fenêtre parente contient le 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 sont pas recherchés.

Pour ignorer certaines fenêtres enfants, utilisez la fonction ChildWindowFromPointEx .

Syntaxe

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

Paramètres

[in] hWndParent

Type : HWND

Handle de la fenêtre parente.

[in] Point

Type : POINT

Structure qui définit les coordonnées du client, par rapport à hWndParent, 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, même si la fenêtre enfant est masquée ou désactivée. Si le point se trouve en dehors de la fenêtre parente, la valeur de retour est NULL. Si le point se trouve dans la fenêtre parente, mais pas dans une fenêtre enfant, la valeur de retour est un handle de la fenêtre parente.

Remarques

Le système gère une liste interne, contenant les handles des fenêtres enfants associées à une fenêtre parente. L’ordre des handles dans la liste dépend de l’ordre Z des fenêtres enfants. Si plusieurs fenêtres enfants contiennent le point spécifié, le système retourne un handle à la première fenêtre de la liste qui contient le point.

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

Exemples

Pour obtenir un exemple, consultez « Création d’une barre d’outils de zone de liste modifiable » dans Utilisation de zones de liste déroulante.

Configuration requise


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)