Share via

ChildWindowFromPointEx, fonction (winuser.h)

  • Article

Détermine laquelle, le cas échéant, des fenêtres enfants appartenant à la fenêtre parente spécifiée contient le point spécifié. La fonction peut ignorer les fenêtres enfants invisibles, désactivées et transparentes. La recherche est limitée aux fenêtres enfants immédiates. Les petits-enfants et les descendants plus profonds ne sont pas recherchés.

Syntaxe

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

Paramètres

[in] hwnd

Type : HWND

Handle de la fenêtre parente.

[in] pt

Type : POINT

Structure qui définit les coordonnées du client (par rapport à hwndParent) du point à vérifier.

[in] flags

Type : UINT

Fenêtres enfants à ignorer. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.

Valeur Signification
CWP_ALL
0x0000
 N’ignore aucune fenêtre enfant
CWP_SKIPDISABLED
0x0002
 Ignore les fenêtres enfants désactivées
CWP_SKIPINVISIBLE
0x0001
 Ignore les fenêtres enfants invisibles
CWP_SKIPTRANSPARENT
0x0004
 Ignore les fenêtres enfants transparentes

Valeur retournée

Type : HWND

La valeur de retour est un handle de la première fenêtre enfant qui contient le point et répond aux critères spécifiés par uFlags. Si le point se trouve dans la fenêtre parente, mais pas dans une fenêtre enfant répondant aux critères, la valeur de retour est un handle pour la fenêtre parente. Si le point se trouve en dehors de la fenêtre parente ou si la fonction échoue, la valeur de retour est NULL.

Remarques

Le système gère une liste interne qui contient les handles des fenêtres enfants associées à une fenêtre parente. L’ordre des descripteurs 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 et répond aux critères spécifiés par uFlags.

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)

Voir aussi

Conceptuel

Autres ressources

POINT

Référence

WindowFromPoint

Windows