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

カスケード フラグ。 このパラメーターには、次の 1 つ以上の値を指定できます。

[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

関数が成功した場合、戻り値は配置されたウィンドウの数です。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

既定では、 CascadeWindows はlpKids 配列によって提供される順序でウィンドウを並べ替えますが、 Z オーダーは保持されます。 MDITILE_ZORDER フラグを指定すると、CascadeWindows によってウィンドウが Z 順に配置されます。

CascadeWindows を呼び出すと、最大化されたすべてのウィンドウが以前のサイズに復元されます。

要件

関連項目

Windows の概要