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
串聯旗標。 此參數可以是下列一或多個值。
值 | 意義 |
---|---|
|
防止停用的 MDI 子視窗串聯。 |
|
依 Z 順序排列視窗。 如果未指定此值,則會使用 lpKids 陣列中指定的順序排列視窗。 |
[in, optional] lpRect
類型:const RECT*
結構的指標,指定在用戶端座標中排列視窗的矩形區域。 此參數可以是 Null,在此情況下會使用父視窗的工作區。
[in] cKids
類型: UINT
lpKids參數所指定陣列中的元素數目。 如果 lpKids 為 Null,則會忽略此參數。
[in, optional] lpKids
類型: const HWND*
要排列之子視窗的控制碼陣列。 如果指定的子視窗是具有樣式 WS_EX_TOPMOST 或 WS_EX_TOOLWINDOW的最上層視窗,則子視窗不會排列。 如果此參數為 Null,則會排列指定父視窗 (或桌面視窗的所有子視窗) 。
傳回值
類型: WORD
如果函式成功,則傳回值是排列的視窗數目。
如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
CascadeWindows 預設會依lpKids陣列所提供的順序排列視窗,但會保留Z 順序。 如果您指定 MDITILE_ZORDER 旗標, CascadeWindows 會依 Z 順序排列視窗。
呼叫 CascadeWindows 會導致所有最大化的視窗還原為其先前的大小。
規格需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winuser.h (包括 Windows.h) |
程式庫 | User32.lib |
Dll | User32.dll |