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 WINAPI EnumChildWindows( _In_opt_ HWND hWndParent, _In_ WNDENUMPROC lpEnumFunc, _In_ LPARAM lParam );
Parameters
- hWndParent [in, optional]
-
Type: HWND
A handle to the parent window whose child windows are to be enumerated. If this parameter is NULL, this function is equivalent to EnumWindows.
- lpEnumFunc [in]
-
Type: WNDENUMPROC
A pointer to an application-defined callback function. For more information, see EnumChildProc.
- lParam [in]
-
Type: LPARAM
An application-defined value to be passed to the callback function.
Return value
Type: Type: BOOL
The return value is not used.
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.
Requirements
|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
- Reference
- EnumChildProc
- EnumThreadWindows
- EnumWindows
- GetWindow
- Conceptual
- Windows