Функция SetViewportExtEx

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

Синтаксис

BOOL SetViewportExtEx(
  HDC hdc,       // дескриптор контекста устройства
  int nXExtent,  // новый горизонтальный размер области просмотра
  int nYExtent,  // новый вертикальный размер области просмотра
  LPSIZE lpSize  // первоначальный размер области просмотра
);

Параметры

hdc

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

nXExtent

[in] Определяет горизонтальный размер области просмотра, в единицах устройства.

nYExtent

[in] Определяет вертикальный размер области просмотра, в единицах устройства.

lpSize

[out] Указатель на структуру SIZE, которая получает предыдущие размеры области просмотра, в единицах устройства. Если параметр lpSize - НУЛЬ (NULL), этот параметр не используется.

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

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

Если функция завершается ошибкой, возвращаемое значение - нуль.

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

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

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

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

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

Демонстрационный код

Пример смотри в статье Признание недействительной рабочей области.

Смотри также

Обзор Координатные пространства и преобразования, Функции, используемые координатными пространствами и преобразованиями, GetViewportExtEx, SetWindowExtEx, SIZE

Размещение и совместимость SetViewportExtEx 
К Windows XP Да 
л Windows 2000 Professional Да
и Windows NT Workstation Да версии 3.1 и старше
е Windows Me Да
н Windows 98 Да
т Windows 95 Да
 
С Windows Server 2003 Нет
е Windows 2000 Server Да
р Windows NT Server Да
в    
е    
р    
Используемая библиотека Gdi32.lib
Используемая DLL -
 Заголовочный файл  
- объявлено в Wingdi.h
 - включено в Windows.h
 Unicode Нет
 Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz