CascadeWindows-Funktion (winuser.h)

Artikel
08/27/2023

Kaskadiert die angegebenen untergeordneten Fenster des angegebenen übergeordneten Fensters.

Syntax

WORD CascadeWindows(
  [in, optional] HWND       hwndParent,
  [in]           UINT       wHow,
  [in, optional] const RECT *lpRect,
  [in]           UINT       cKids,
  [in, optional] const HWND *lpKids
);

Parameter

[in, optional] hwndParent

Typ: HWND

Ein Handle für das übergeordnete Fenster. Wenn dieser Parameter NULL ist, wird das Desktopfenster angenommen.

[in] wHow

Typ: UINT

Ein kaskadierendes Flag. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert	Bedeutung
MDITILE_SKIPDISABLED 0x0002	Verhindert, dass deaktivierte untergeordnete MDI-Fenster kaskadiert werden.
MDITILE_ZORDER 0x0004	Ordnet die Fenster in der Z-Reihenfolge an. Wenn dieser Wert nicht angegeben wird, werden die Fenster in der im lpKids-Array angegebenen Reihenfolge angeordnet.

[in, optional] lpRect

Typ: const RECT*

Ein Zeiger auf eine Struktur, der den rechteckigen Bereich in Clientkoordinaten angibt, in dem die Fenster angeordnet sind. Dieser Parameter kann NULL sein. In diesem Fall wird der Clientbereich des übergeordneten Fensters verwendet.

[in] cKids

Typ: UINT

Die Anzahl der Elemente im Array, die durch den lpKids-Parameter angegeben wird. Dieser Parameter wird ignoriert, wenn lpKidsNULL ist.

[in, optional] lpKids

Typ: const HWND*

Ein Array von Handles für die untergeordneten Fenster, die angeordnet werden sollen. Wenn es sich bei einem angegebenen untergeordneten Fenster um ein Fenster auf oberster Ebene handelt, in dem die Formatvorlage WS_EX_TOPMOST oder WS_EX_TOOLWINDOW, ist das untergeordnete Fenster nicht angeordnet. Wenn dieser Parameter NULL ist, werden alle untergeordneten Fenster des angegebenen übergeordneten Fensters (oder des Desktopfensters) angeordnet.

Rückgabewert

Typ: WORD

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der angeordneten Fenster.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Standardmäßig ordnet CascadeWindows die Fenster in der vom lpKids-Array bereitgestellten Reihenfolge an, behält jedoch die Z-Order bei. Wenn Sie das MDITILE_ZORDER-Flag angeben, ordnet CascadeWindows die Fenster in der Z-Reihenfolge an.

Das Aufrufen von CascadeWindows bewirkt, dass alle maximierten Fenster auf ihre vorherige Größe wiederhergestellt werden.

Anforderungen


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 (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll

Weitere Informationen

Windows-Übersicht

Freigeben über