描述
SetViewportExtEx函数通过使用指定的值设置设备上下文的视口的水平和垂直范围。
C++ 语法
BOOL SetViewportExtEx( __in HDC hdc, __in int nXExtent, __in int nYExtent, __out LPSIZE lpSize ); |
PowerBASIC 语法
FUNCTION SetViewportExtEx ( _ BYVAL hdc AS DWORD, _ BYVAL nXExtent AS LONG, _ BYVAL nYExtent AS LONG, _ BYREF lpSize AS SIZE _ ) AS LONG |
参数
hdc
[in]处理设备环境。
nXExtent
[in]指定视口的水平范围（以设备为单位）。
nYExtent
[in]指定视口的垂直范围（以设备为单位）。
lpPoint
[out]指向SIZE结构的指针，以设备为单位接收以前的视口范围。如果lpsiz到为NULL，则不使用此参数。
返回值
如果函数成功，返回值不为零。
如果函数失败，返回值为零。
Windows NT / 2000 / XP / Vista / Windows 7：要获取扩展错误信息，请调用GetLastError.
备注
视口是指设备空间的设备坐标系。范围是轴的最大值。此函数可以在设备坐标（或像素）中设置视口的水平和垂直轴的最大值。当在页面空间和设备空间之间进行映射时，SetWindowExtEx和SetViewportExtEx确定窗口和视口之间的缩放因子。
当设置以下映射模式时，将忽略对SetWindowExtEx和SetViewportExtEx功能的调用。
| · | MM_HIENGLISH |
| · | MM_HIMETRIC |
| · | MM_LOENGLISH |
| · | MM_LOMETRIC |
| · | MM_TEXT |
| · | MM_TWIPS |
当设置了MM_ISOTROPIC模式时，应用程序在调用SetViewportExtEx之前必须调用SetWindowExtEx函数。请注意，对于MM_ISOTROPIC模式，非正方形屏幕的某些部分可能不可用于显示，因为两个轴上的逻辑单元表示相等的物理距离。
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）