Функция SetWindowExtEx


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

Синтаксис

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

Параметры

hdc

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

nXExtent

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

nYExtent

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

lpSize

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

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

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

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

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

Замечания

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

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

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

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

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

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

Смотри также

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

Размещение и совместимость SetWindowExtEx 

К 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