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

Статья
03/15/2023

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

Чтобы указать расширенный стиль окна, используйте функцию AdjustWindowRectEx .

Синтаксис

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

Параметры

[in, out] lpRect

Тип: LPRECT

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

[in] dwStyle

Тип: DWORD

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

[in] bMenu

Тип: BOOL

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

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

Тип: BOOL

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

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

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

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

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

Требования


Минимальная версия клиента	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)