Funzione CascadeWindows (winuser.h)

Articolo
08/27/2023

Catena le finestre figlio specificate della finestra padre specificata.

Sintassi

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

Parametri

[in, optional] hwndParent

Tipo: HWND

Handle alla finestra padre. Se questo parametro è NULL, si presuppone che la finestra desktop.

[in] wHow

Tipo: UINT

Flag a cascata. Questo parametro può essere uno o più dei valori seguenti.

Valore	Significato
MDITILE_SKIPDISABLED 0x0002	Impedisce l'esecuzione a catena di finestre figlio MDI disabilitate.
MDITILE_ZORDER 0x0004	Dispone le finestre nell'ordine Z. Se questo valore non è specificato, le finestre vengono disposte usando l'ordine specificato nella matrice lpKids .

[in, optional] lpRect

Tipo: const RECT*

Puntatore a una struttura che specifica l'area rettangolare, nelle coordinate client, in cui sono disposte le finestre. Questo parametro può essere NULL, nel qual caso viene usata l'area client della finestra padre.

[in] cKids

Tipo: UINT

Numero di elementi nella matrice specificata dal parametro lpKids . Questo parametro viene ignorato se lpKids è NULL.

[in, optional] lpKids

Tipo: const HWND*

Matrice di handle nelle finestre figlio da disporre. Se una finestra figlio specificata è una finestra di primo livello con lo stile WS_EX_TOPMOST o WS_EX_TOOLWINDOW, la finestra figlio non è disposta. Se questo parametro è NULL, vengono disposte tutte le finestre figlio della finestra padre specificata (o della finestra desktop).

Valore restituito

Tipo: WORD

Se la funzione ha esito positivo, il valore restituito è il numero di finestre disposte.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Per impostazione predefinita, CascadeWindows dispone le finestre nell'ordine fornito dalla matrice lpKids , ma mantiene l'ordine Z. Se si specifica il flag MDITILE_ZORDER , CascadeWindows dispone le finestre nell'ordine Z.

La chiamata a CascadeWindows causa il ripristino di tutte le finestre ingrandita alle dimensioni precedenti.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll

Vedi anche

Panoramica di Windows

Condividi tramite