CascadeWindows 函数 (winuser.h)

级联指定父窗口的指定子窗口。

语法

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

参数

[in, optional] hwndParent

类型:HWND

父窗口的句柄。 如果此参数为 NULL,则假定为桌面窗口。

[in] wHow

类型: UINT

级联标志。 此参数可使用以下一个或多个值。

含义
MDITILE_SKIPDISABLED
0x0002
防止级联禁用的 MDI 子窗口。
MDITILE_ZORDER
0x0004
按 Z 顺序排列窗口。 如果未指定此值,则使用 lpKids 数组中指定的顺序排列窗口。

[in, optional] lpRect

类型: const RECT*

指向 结构的指针,该结构指定以客户端坐标表示的矩形区域,在其中排列窗口。 此参数可以为 NULL,在这种情况下,将使用父窗口的工作区。

[in] cKids

类型: UINT

lpKids 参数指定的数组中的元素数。 如果 lpKidsNULL,则忽略此参数。

[in, optional] lpKids

类型: const HWND*

要排列的子窗口的句柄数组。 如果指定的子窗口是样式 WS_EX_TOPMOSTWS_EX_TOOLWINDOW的顶级窗口,则不会排列子窗口。 如果此参数为 NULL,则会排列指定父窗口 (或桌面窗口) 的所有子窗口。

返回值

类型: WORD

如果函数成功,则返回值为排列的窗口数。

如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。

注解

默认情况下, CascadeWindowslpKids 数组提供的顺序排列窗口,但保留 Z 顺序。 如果指定 MDITILE_ZORDER 标志, CascadeWindows 将按 Z 顺序排列窗口。

调用 CascadeWindows 会导致所有最大化的窗口还原到其以前的大小。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll

另请参阅

Windows 概述