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

Статья
08/27/2023

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

Синтаксис

BOOL SetViewportOrgEx(
  [in]  HDC     hdc,
  [in]  int     x,
  [in]  int     y,
  [out] LPPOINT lppt
);

Параметры

[in] hdc

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

[in] x

Координата X (в единицах устройства) нового источника окна просмотра.

[in] y

Координата Y (в единицах устройства) нового источника окна просмотра.

[out] lppt

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

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

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

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

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


//map the logical point (0,0) to the device point (xViewOrg, yViewOrg) 
SetViewportOrgEx ( hdc, xViewOrg, yViewOrg, NULL)

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

Примеры

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

Требования


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