Expand Minimize

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

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Reference
EnumChildProc
EnumThreadWindows
EnumWindows
GetWindow
Conceptual
Windows

 

 

Community Additions

ADD
Show:
© 2014 Microsoft