Fonction EnumChildWindows (winuser.h)

Article
03/06/2024

Énumère les fenêtres enfants qui appartiennent à la fenêtre parente spécifiée en passant le handle à chaque fenêtre enfant, à son tour, à une fonction de rappel définie par l’application. EnumChildWindows continue jusqu’à ce que la dernière fenêtre enfant soit énumérée ou que la fonction de rappel retourne FALSE.

Syntaxe

BOOL EnumChildWindows(
  [in, optional] HWND        hWndParent,
  [in]           WNDENUMPROC lpEnumFunc,
  [in]           LPARAM      lParam
);

Paramètres

[in, optional] hWndParent

Type : HWND

Handle de la fenêtre parente dont les fenêtres enfants doivent être énumérées. Si ce paramètre a la valeur NULL, cette fonction équivaut à EnumWindows.

[in] lpEnumFunc

Type : WNDENUMPROC

Pointeur vers une fonction de rappel définie par l’application. Pour plus d’informations, consultez EnumChildProc.

[in] lParam

Type : LPARAM

Valeur définie par l’application à passer à la fonction de rappel.

Valeur retournée

Type : BOOL

La valeur de retour n’est pas utilisée.

Remarques

Si une fenêtre enfant a créé ses propres fenêtres enfants, EnumChildWindows énumère également ces fenêtres.

Une fenêtre enfant déplacée ou repositionnée dans l’ordre Z pendant le processus d’énumération sera correctement énumérée. La fonction n’énumère pas une fenêtre enfant qui est détruite avant d’être énumérée ou qui est créée pendant le processus d’énumération.

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-0 (introduit dans Windows 8)