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

Статья
08/27/2023

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

Синтаксис

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

Параметры

[in] hdc

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

[in] x

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

[in] y

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

[out] lpsz

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

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

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

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

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

Если заданы следующие режимы сопоставления, вызовы функций 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