ChildWindowFromPoint, fonction (winuser.h)
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) |
Voir aussi
Conceptuel
Autres ressources
Référence