Função EnumChildWindows (winuser.h)

Artigo
03/13/2024

Enumera as janelas filho que pertencem à janela pai especificada passando o identificador para cada janela filho, por sua vez, para uma função de retorno de chamada definida pelo aplicativo. EnumChildWindows continua até que a última janela filho seja enumerada ou a função de retorno de chamada retorne FALSE.

Sintaxe

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

Parâmetros

[in, optional] hWndParent

Digite: HWND

Um identificador para a janela pai cujas janelas filho devem ser enumeradas. Se esse parâmetro for NULL, essa função será equivalente a EnumWindows.

[in] lpEnumFunc

Tipo: WNDENUMPROC

Um ponteiro para uma função de retorno de chamada definida pelo aplicativo. Para obter mais informações, consulte EnumChildProc.

[in] lParam

Tipo: LPARAM

Um valor definido pelo aplicativo a ser passado para a função de retorno de chamada.

Retornar valor

Tipo: BOOL

O valor retornado não é usado.

Comentários

Se uma janela filho tiver criado janelas filho próprias, EnumChildWindows também enumerará essas janelas.

Uma janela filho movida ou reposicionada na ordem Z durante o processo de enumeração será enumerada corretamente. A função não enumera uma janela filho que é destruída antes de ser enumerada ou criada durante o processo de enumeração.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-window-l1-1-0 (introduzido no Windows 8)