setViewportOrgEx 函数 (wingdi.h)

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 结构的指针,该结构接收上一个视区原点(以设备坐标表示)。 如果 lpPointNULL,则不使用此参数。

返回值

如果该函数成功,则返回值为非零值。

如果函数失败,则返回值为零。

注解

此函数 (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 函数相关。 通常,你将使用一个函数或另一个函数,但不能同时使用这两个函数。 无论使用 SetWindowOrgExSetViewportOrgEx, (0,0) 的设备点始终位于左上角。

示例

有关示例,请参阅 在更新区域中重绘

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

坐标空间和转换函数

坐标空间和转换概述

GetViewportOrgEx

SetWindowOrgEx