Функция SetWindowExtEx (wingdi.h)

Статья
03/04/2024

Функция SetWindowExtEx задает горизонтальные и вертикальные экстенты окна для контекста устройства, используя указанные значения.

Синтаксис

BOOL SetWindowExtEx(
  [in]  HDC    hdc,
  [in]  int    x,
  [in]  int    y,
  [out] LPSIZE lpsz
);

Параметры

[in] hdc

Дескриптор контекста устройства.

[in] x

Горизонтальный экстент окна в логических единицах.

[in] y

Вертикальный экстент окна в логических единицах.

[out] lpsz

Указатель на структуру SIZE , которая получает предыдущие экстенты окна в логических единицах. Если lpSize имеет значение NULL, этот параметр не используется.

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

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

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

Окно ссылается на логическую систему координат пространства страницы. Экстент — это максимальное значение оси. Эта функция задает максимальные значения для горизонтальных и вертикальных осей окна (в логических координатах). При сопоставлении пространства страницы и пространства устройства SetViewportExtEx иSetWindowExtEx определяют коэффициент масштабирования между окном и окном просмотра. Дополнительные сведения см. в разделе Преобразование координатных пространств.

Если заданы следующие режимы сопоставления, вызовы функций SetWindowExtEx иSetViewportExtEx игнорируются:

MM_HIENGLISH
MM_HIMETRIC
MM_LOENGLISH
MM_LOMETRIC
MM_TEXT
MM_TWIPS

Если задан режим MM_ISOTROPIC, приложение должно вызвать функцию SetWindowExtEx перед вызовом SetViewportExtEx. Обратите внимание, что в режиме MM_ISOTROPIC некоторые части экрана без квадрата могут быть недоступны для отображения, так как логические единицы на обеих осях представляют равные физические расстояния.

Примеры

Пример см. в разделе О недопустимости клиентской области.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll