Share via

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參數所指定陣列中的元素數目。 如果 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

另請參閱

Windows 概觀