Función CascadeWindows (winuser.h)

Aplica en cascada las ventanas secundarias especificadas de la ventana primaria especificada.

Sintaxis

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

Parámetros

[in, optional] hwndParent

Tipo: HWND

Identificador de la ventana primaria. Si este parámetro es NULL, se asume la ventana de escritorio.

[in] wHow

Tipo: UINT

Una marca en cascada. Este parámetro puede ser uno o más de los siguientes valores.

[in, optional] lpRect

Tipo: const RECT*

Puntero a una estructura que especifica el área rectangular, en coordenadas de cliente, dentro de la cual se organizan las ventanas. Este parámetro puede ser NULL, en cuyo caso se usa el área cliente de la ventana primaria.

[in] cKids

Tipo: UINT

Número de elementos de la matriz especificada por el parámetro lpKids . Este parámetro se omite si lpKids es NULL.

[in, optional] lpKids

Tipo: const HWND*

Matriz de identificadores en las ventanas secundarias que se van a organizar. Si una ventana secundaria especificada es una ventana de nivel superior con el estilo WS_EX_TOPMOST o WS_EX_TOOLWINDOW, la ventana secundaria no se organiza. Si este parámetro es NULL, se organizan todas las ventanas secundarias de la ventana primaria especificada (o de la ventana de escritorio).

Valor devuelto

Tipo: WORD

Si la función se realiza correctamente, el valor devuelto es el número de ventanas organizadas.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

De forma predeterminada, CascadeWindows organiza las ventanas en el orden proporcionado por la matriz lpKids , pero conserva el orden Z. Si especifica la marca MDITILE_ZORDER , CascadeWindows organiza las ventanas en orden Z.

Llamar a CascadeWindows hace que todas las ventanas maximizadas se restauren a su tamaño anterior.

Requisitos

Consulte también

Información general de Windows