SetViewporExtEx

小甲鱼

函数功能：

SetWindowExtEx 函数用于设置指定设备环境的视口的范围。


API 函数原型：

BOOL SetViewportExtEx(
  _In_  HDC    hdc,
  _In_  int    nXExtent,
  _In_  int    nYExtent,
  _Out_ LPSIZE lpSize
);

参数解析：

参数	含义
hdc	指定设备环境句柄
nXExtent	指定视口的水平范围，设备单位
nYExtent	指定视口的垂直范围，设备单位
lpSize	1. 指向一个 POINT 结构的指针，用于存放原先的视口范围（设备单位） 2. 如果该值为 NULL，则表示忽略此参数

返回值：

1. 如果函数调用成功，返回值是非 0；

2. 如果函数调用失败，返回值是 0。


备注：

1. 这里的视口是指设备空间的设备坐标系，设置的范围是轴的最大值。这个函数分别设置视口（设备坐标系）的水平、垂直轴的最大值。当在页面空间和设备空间之间映射时，SetViewporExtEx 和 SetWindowExtEx 函数决定了窗口和视口之间的比例。

2. 当使用下方的映射模式时，SetViewporExtEx 和 SetWindowExtEx 函数的调用无效。

• MM_HIENGLISH
• MM_HIMETRIC
• MM_LOENGLISH
• MM_LOMETRIC
• MM_TEXT
• MM_TWIPS
  

3. 当使用 MM_ISOTROPIC 映射模式时，应用程序应该在调用 SetViewportExtEx 函数之前先调用 SetWindowExtEx 函数。注意，对于 MM_ISOTROPIC 映射模式，当 Windows 调整范围时，它必须让逻辑窗口可以容纳在对应的物理视口之内，这就有可能导致一部分的客户区落在逻辑窗口外面。

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。