Funzione EnumChildWindows (winuser.h)

Articolo
03/04/2024

Enumera le finestre figlio che appartengono alla finestra padre specificata passando l'handle a ogni finestra figlio, a sua volta, a una funzione di callback definita dall'applicazione. EnumChildWindows continua fino all'enumerazione dell'ultima finestra figlio oppure la funzione di callback restituisce FALSE.

Sintassi

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

Parametri

[in, optional] hWndParent

Tipo: HWND

Handle alla finestra padre la cui finestra figlio deve essere enumerata. Se questo parametro è NULL, questa funzione equivale a EnumWindows.

[in] lpEnumFunc

Tipo: WNDENUMPROC

Puntatore a una funzione di callback definita dall'applicazione. Per altre informazioni, vedere EnumChildProc.

[in] lParam

Tipo: LPARAM

Valore definito dall'applicazione da passare alla funzione di callback.

Valore restituito

Tipo: BOOL

Il valore restituito non viene usato.

Commenti

Se una finestra figlio ha creato finestre figlio personalizzate, EnumChildWindows enumera anche queste finestre.

Una finestra figlio spostata o riposizionata nell'ordine Z durante il processo di enumerazione verrà enumerata correttamente. La funzione non enumera una finestra figlio eliminata prima di essere enumerata o creata durante il processo di enumerazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-window-l1-1-0 (introdotto in Windows 8)