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

Статья
08/27/2023

Вычисляет требуемый размер прямоугольника окна на основе требуемого размера клиентского прямоугольника. Затем прямоугольник окна можно передать в функцию CreateWindowEx , чтобы создать окно с клиентской областью требуемого размера.

Синтаксис

BOOL AdjustWindowRectEx(
  [in, out] LPRECT lpRect,
  [in]      DWORD  dwStyle,
  [in]      BOOL   bMenu,
  [in]      DWORD  dwExStyle
);

Параметры

[in, out] lpRect

Тип: LPRECT

Указатель на структуру RECT , содержащую координаты левого верхнего и нижнего правых углов нужной клиентской области. Когда функция возвращается, структура содержит координаты верхнего левого и нижнего правых углов окна для размещения нужной клиентской области.

[in] dwStyle

Тип: DWORD

Стиль окна окна, требуемый размер которого необходимо вычислить. Обратите внимание, что вы не можете указать стиль WS_OVERLAPPED .

[in] bMenu

Тип: BOOL

Указывает, есть ли в окне меню.

[in] dwExStyle

Тип: DWORD

Расширенный стиль окна, требуемый размер которого необходимо вычислить.

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

Тип: BOOL

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

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

Клиентский прямоугольник — это наименьший прямоугольник, полностью охватывающий клиентную область. Прямоугольник окна — это самый маленький прямоугольник, полностью охватывающий окно, который включает в себя клиентская и неклиентская области.

Функция AdjustWindowRectEx не добавляет дополнительное пространство, если строка меню переносится в две или более строки.

Функция AdjustWindowRectEx не учитывает стили WS_VSCROLL или WS_HSCROLL . Чтобы учесть полосы прокрутки, вызовите функцию GetSystemMetrics с SM_CXVSCROLL или SM_CYHSCROLL.

Этот API не учитывает DPI и не следует использовать, если вызывающий поток учитывает DPI для каждого монитора. Версию этого API с поддержкой DPI см. в разделе AdjustWindowsRectExForDPI. Дополнительные сведения об уровне DPI см. в документации windows High DPI.

Требования

Требование	Значение
Минимальная версия клиента	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-0 (появилось в Windows 8)