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 つ以上の値を指定できます。

値 説明
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

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

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

解説

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

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

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll

関連項目

Windows の概要