Win32 API. Функции окна
Страница 5. Функция BeginDeferWindowPos


Функция BeginDeferWindowPos

(НачалоЗадержкиПозиционирования Окна)

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

Синтаксис:

HDWP BeginDeferWindowPos
(
int nNumWindows // число окон
);

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

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

Замечания
Структура многооконной установки - внутренняя структура; прикладная программа не может обращаться к ней непосредственно. Функция DeferWindowPos заполняет структуру многооконной установки информацией о расположении объекта для одного или большего количества окон, собирающихся быть перемещенными. Функция EndDeferWindowPos принимает дескриптор для этой структуры и снова устанавливает окна, используя информацию, сохраненную в структуре. Если какоелибо из окон в структуре многооконной установки имеет набор флажков SWP_HIDEWINDOW или SWP_SHOWWINDOW, ни одно из окон снова не устанавливается. Если Windows должен увеличить размер структуры многооконной установки за пределы начального размера, определенного параметром nNumWindows, но не может выделить достаточно памяти, чтобы выполнить это, Windows не выполняет задачу установленным порядком для всего окна (BeginDeferWindowPos, DeferWindowPos, и EndDeferWindowPos). Определяя необходимый максимальный размер, прикладная программа может обнаруживать и обрабатывать сбой в начале процесса.

Смотри также
DeferWindowPos, EndDeferWindowPos, SetWindowPos

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

Windows NTДа
Win95Да
Win32sДа
Импортируемая библиотекаuser32.lib
Заголовочный файлwinuser.h
UnicodeНет
Замечания по платформеНе имеется

 

 
« Предыдущая статья   Следующая статья »