Compartir a través de

Función CascadeWindows (winuser.h)

  • Artículo

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.

Value Significado
MDITILE_SKIPDISABLED
0x0002
 Impide que las ventanas secundarias MDI deshabilitadas se estén en cascada.
MDITILE_ZORDER
0x0004
 Organiza las ventanas en orden Z. Si no se especifica este valor, las ventanas se organizan utilizando el orden especificado en la matriz lpKids .

[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

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluir Windows.h)
Library User32.lib
Archivo DLL User32.dll

Consulte también

Información general de Windows