Функция CascadeWindows


Функция CascadeWindows располагает каскадом заданные окна или дочерние окна определенного родительского окна.

Синтаксис

WORD CascadeWindows(

HWND hwndParent,    // дескриптор родительского окна
UINT
wHow,          // типы окон, которые не упорядочиваются
CONST RECT*
lpRect, // прямоугольник, в котором упорядочиваются окна
UINT
cKids,         // число окон для упорядочивания
const HWND*
lpKids  // массив дескрипторов окна

);

Параметры

hwndParent

[in] Дескриптор родительского окна. Если этот параметр имеет значение ПУСТО (NULL), принимается окно рабочего стола.

wHow

[in] Определяет флажок каскада. Этот параметр может состоять из одного или нескольких ниже перечисленных значений.

Значение Предназначение
MDITILE_SKIPDISABLED

Предотвращает блокирование дочерних окон многодокументного интерфейса MDI от каскадирования. 

MDITILE_ZORDER

Windows 2000/XP: Упорядочивает окна в Z - последовательности. Если это значение не определено, окна выстраиваются, используя порядок, заданный в массиве lpKids. 

lpRect

[in] Указатель на структуру RECT, которая определяет прямоугольную область, в рабочих координатах, внутри которой выстраиваются окна. Этот параметр может быть значением ПУСТО (NULL), в таком случае используется рабочая область родительского окна.

cKids

[in] Определяет число элементов в массиве, определенном параметром lpKids. Этот параметр игнорируется, если lpKids имеет значение ПУСТО (NULL).

pKids

[in] Указатель на массив дескрипторов дочерних окон, которые упорядочиваются. Если этот параметр имеют значение ПУСТО (NULL), все дочерние окна размещаются в заданном родительском окне (или окне рабочего стола).

Возвращаемые значения

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

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

Замечания

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

Вызов функции CascadeWindows заставляет все развернутые окна быть восстановленными в их предшествующих размерах.

Смотри также

Краткий обзор Окна, RECT

Размещение и совместимость CascadeWindows

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и старше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

User32.lib

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz