Функция 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

Флаг каскада. Этот параметр может быть одним или несколькими из следующих значений.

Значение Значение
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

Если функция выполнена успешно, возвращаемым значением будет количество упорядоченных окон.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

По умолчанию CascadeWindows упорядочивает окна в порядке, указанном массивом lpKids , но сохраняет Z-порядок. Если вы укажете флаг MDITILE_ZORDER , CascadeWindows упорядочит окна в порядке Z.

Вызов CascadeWindows приводит к восстановлению всех развернутых окон до предыдущего размера.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll

См. также раздел

Обзор Windows