Функция BeginDeferWindowPos (winuser.h)

Статья
08/27/2023

Выделяет память для структуры с несколькими окнами и возвращает дескриптор в структуру.

Синтаксис

HDWP BeginDeferWindowPos(
  [in] int nNumWindows
);

Параметры

[in] nNumWindows

Тип: int

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

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

Тип: HDWP

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-window-l1-1-4 (представлено в Windows 10 версии 10.0.14393)