Функция BeginDeferWindowPos


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

Синтаксис

HDWP BeginDeferWindowPos(

int nNumWindows // число окон

);

Параметры

nNumWindows

[in] Определяет начальное число окон, для которых сохраняется информация о расположении. Функция DeferWindowPos, в случае необходимости, увеличивает размер структуры.

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

Если функция завершается успешно, возвращаемое значение идентифицирует структуру многооконного позиционирования. Если доступные ресурсы системы недостаточные, чтобы распределить структуру, возвращаемое значение ПУСТО (NULL).

Замечания

Структура многооконного позиционирования - внутренняя структура; прикладная программа не может обращаться к ней непосредственно.

Функция DeferWindowPos заполняет структуру многооконного позиционирования информацией о целевой позиции для одного или нескольких окон, которые будут перемещены. Функция EndDeferWindowPos принимает дескриптор этой структуры и снова устанавливает окна, используя информацию, сохраненную в структуре.

Если какое-либо из окон в структуре многооконного позиционирования имеет установленный флажок SWP_HIDEWINDOW или SWP_SHOWWINDOW, ни одно из окон снова не устанавливается.

Если система должна увеличить размер структуры многооконного позиционирования за пределы начального размера, определенного параметром nNumWindows, но не может выделить достаточно памяти, чтобы выполнить это, система завершает ошибкой позиционирование всего окна, а не в последовательности (BeginDeferWindowPos, DeferWindowPos, и EndDeferWindowPos). Определяя необходимый максимальный размер, прикладная программа может обнаружить это и обработать сбой в начале процесса.

Смотри также

Краткий обзор Окна, DeferWindowPos, EndDeferWindowPos, SetWindowPos

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

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

User32.lib

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

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

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

Не имеется

 

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

Hosted by uCoz