EnumChildWindows-Funktion (winuser.h)

Artikel
03/04/2024

Listet die untergeordneten Fenster auf, die zum angegebenen übergeordneten Fenster gehören, indem das Handle wiederum an jedes untergeordnete Fenster an eine anwendungsdefinierte Rückruffunktion übergeben wird. EnumChildWindows wird so lange fortgesetzt, bis das letzte untergeordnete Fenster aufgezählt wurde oder die Rückruffunktion FALSE zurückgibt.

Syntax

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

Parameter

[in, optional] hWndParent

Typ: HWND

Ein Handle für das übergeordnete Fenster, dessen untergeordnete Fenster aufgelistet werden sollen. Wenn dieser Parameter NULL ist, entspricht diese Funktion EnumWindows.

[in] lpEnumFunc

Typ: WNDENUMPROC

Ein Zeiger auf eine anwendungsdefinierte Rückruffunktion. Weitere Informationen finden Sie unter EnumChildProc.

[in] lParam

Typ: LPARAM

Ein anwendungsdefinierter Wert, der an die Rückruffunktion übergeben werden soll.

Rückgabewert

Typ: BOOL

Der Rückgabewert wird nicht verwendet.

Hinweise

Wenn ein untergeordnetes Fenster selbst untergeordnete Fenster erstellt hat, listet EnumChildWindows auch diese Fenster auf.

Ein untergeordnetes Fenster, das während des Enumerationsprozesses in der Reihenfolge Z verschoben oder neu positioniert wird, wird ordnungsgemäß aufgezählt. Die Funktion listet kein untergeordnetes Fenster auf, das vor dem Aufzählen zerstört wird oder das während des Enumerationsprozesses erstellt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-window-l1-1-0 (eingeführt in Windows 8)