Поделиться через


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

Вычисляет требуемый размер прямоугольника окна на основе требуемого размера клиентского прямоугольника. Затем прямоугольник окна можно передать в функцию 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)

См. также раздел

AdjustWindowsRectExForDPI

Основные понятия

CreateWindowEx

Другие ресурсы

RECT

Справочные материалы

Windows