Partager via


Fonction EnumChildWindows (winuser.h)

É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)

Voir aussi

Conceptuel

EnumChildProc

EnumThreadWindows

EnumWindows

GetWindow

Référence

Windows