Функция BeginDeferWindowPos распределяет память для структуры многооконной установки и возвращает значение дескриптора структуры.
Синтаксис:
HDWP BeginDeferWindowPos
(
int nNumWindows // число окон
);
Параметры: nNumWindows определяет начальное число окон, для которых сохраняется информация о расположении. Функция DeferWindowPos, в случае необходимости, увеличивает размер структуры.
Возвращаемые значения: Если функция завершается успешно, возвращаемое значение идентифицирует структуру многооконной установки. Если доступные ресурсы системы недостаточные, чтобы распределить структуру, возвращаемое значение - NULL.
Замечания: Структура многооконной установки- внутренняя структура, прикладная программа не может обращаться к ней непосредственно.
Функция DeferWindowPos заполняет структуру многооконной установки информацией о расположении объекта для одного или большего количества окон, собирающихся быть перемещенными.
Функция EndDeferWindowPos принимает дескриптор для этой структуры и снова устанавливает окна, используя информацию, сохраненную в структуре. Если какое-либо из окон в структуре многооконной установки имеет набор флажков SWP_HIDEWINDOW или SWP_SHOWWINDOW, ни одно из окон снова не устанавливается. Если Windows должен увеличить размер структуры многооконной установки за пределы начального размера, определенного параметром nNumWindows, но не может выделить достаточно памяти, чтобы выполнить это, Windows не выполняет задачу установленным порядком для всего окна (BeginDeferWindowPos, DeferWindowPos, и EndDeferWindowPos). Определяя необходимый максимальный размер, прикладная программа может обнаруживать и обрабатывать сбой в начале процесса.
Информация:
Минимальные DLL версия |
user32.dll |
Заголовок |
Объявленный в Winuser.h, включают Windows.h |
Импорт библиотеки |
User32.lib |
Минимальные операционные системы |
Windows 95, Windows NT 3,1 |
Unicode |
Выполнена в Unicode версии. |
|