The EnumChildWindows function enumerates the child windows that belong to the specified parent window by passing the handle to each child window, in turn, to an application-defined callback function. EnumChildWindows continues until the last child window is enumerated or the callback function returns FALSE.
Syntax
BOOL EnumChildWindows(
HWND hWndParent, WNDENUMPROC lpEnumFunc, LPARAM lParam );
Parameters
hWndParent
- [in] Handle to the parent window whose child windows are to be enumerated. If this parameter is NULL, this function is equivalent to EnumWindows.
lpEnumFuncWindows 95/98/Me: hWndParent cannot be NULL.
- [in] Pointer to an application-defined callback function. For more information, see EnumChildProc.
lParam- [in] Specifies an application-defined value to be passed to the callback function.
Return Value
Remarks
If a child window has created child windows of its own, EnumChildWindows enumerates those windows as well.
A child window that is moved or repositioned in the Z order during the enumeration process will be properly enumerated. The function does not enumerate a child window that is destroyed before being enumerated or that is created during the enumeration process.
Example
For an example see Destroying a Window.