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
标头	wingdi.h (包括 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll