Функция SetViewportOrgEx

Функция SetViewportOrgEx определяет, какая точка устройства отображает начало координат окна (0,0).

Синтаксис

BOOL SetViewportOrgEx(
  HDC hdc,        // дескриптор контекста устройства
  int X,          // новая координата x начала координат области просмотра
  int Y,          // новая координата y начала координат области просмотра
  LPPOINT lpPoint // первоначальное начало координат области просмотра
);

Параметры

hdc

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

X

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

Y

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

lpPoint

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

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

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

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

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

Замечания

Эта функция (наряду с функциями SetViewportExtEx и SetWindowExtEx) помогает определять отображение из логического координатного пространства (также известное как окно (window)) в координатное пространство устройства (область просмотра (viewport)). SetViewportOrgEx определяет, какая точка устройства отображает логическую точку (0,0). В результате  она сдвигает оси так, что логическая точка (0,0) больше не соответствует левому верхнему углу.

//отображение логической точки  (0,0) в точку устройства (xViewOrg, yViewOrg)
SetViewportOrgEx ( hdc, xViewOrg, yViewOrg, NULL)

Она связана с функцией SetWindowOrgEx. Как правило, Вы будете использовать ту или другой функцию, но не обе. Независимо от вашего использования функций SetWindowOrgEx и SetViewportOrgEx, точка устройства (0,0) - всегда левый верхний угол.

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

Пример смотри в статье Перерисовка в регионе обновления.

Смотри также

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

Размещение и совместимость SetViewportOrgEx 
К 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