SetViewportExtEx 函数 (wingdi.h)

SetViewportExtEx 函数使用指定值为设备上下文设置视区的水平和垂直范围。

语法

BOOL SetViewportExtEx(
  [in]  HDC    hdc,
  [in]  int    x,
  [in]  int    y,
  [out] LPSIZE lpsz
);

[in] hdc

设备上下文的句柄。

[in] x

视区的水平范围（以设备单位为单位）。

[in] y

视区的垂直范围（以设备单位为单位）。

[out] lpsz

指向接收上一个视区范围的 SIZE 结构的指针，以设备单位表示。如果 lpSize 为 NULL，则不使用此参数。

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

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

视区是指设备空间的设备坐标系。范围是轴的最大值。此函数设置视区的水平轴和垂直轴的最大值，以设备坐标 (或像素) 。在页面空间和设备空间之间进行映射时， SetWindowExtEx 和 SetViewportExtEx 确定窗口与视区之间的缩放因子。有关详细信息，请参阅坐标空间的转换。

设置以下映射模式后，将忽略对 SetWindowExtEx 和 SetViewportExtEx 函数的调用。

设置MM_ISOTROPIC模式后，应用程序必须在调用 SetViewportExtEx 之前调用 SetWindowExtEx 函数。请注意，对于MM_ISOTROPIC模式，非方位屏幕的某些部分可能无法显示，因为两个轴上的逻辑单元表示相等的物理距离。

有关示例，请参阅使工作区失效。


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