描述
ExtSelectClipRgn功能使用指定的模式将指定的区域与当前的剪切区域进行组合。
C++ 语法
int ExtSelectClipRgn( __in HDC hdc, __in HRGN hrgn, __in int fnMode ); |
PowerBASIC 语法
FUNCTION ExtSelectClipRgn ( _ BYVAL hdc AS DWORD, _ BYVAL hrgn AS DWORD, _ BYVAL fnMode AS LONG _ ) AS LONG |
参数
hdc
[in]处理设备上下文。
hrgn
[in]处理要选择的区域。当指定RGN_COPY模式时，此句柄只能为NULL。
nTopRect
[in]指定矩形左上角的y坐标（以逻辑为单位）。
fnMode
[in]指定要执行的操作。它必须是以下值之一。
值 |
含义 |
RGN_AND |
新剪辑区域组合当前剪辑区域的重叠区域和由HRGN标识的区域。 |
RGN_COPY |
新剪辑区域是由HRGN标识的区域的副本。这与SelectClipRgn相同。如果由hrgn标识的区域为NULL，则新的剪切区域是默认剪切区域（默认剪切区域为空区域）。 |
RGN_DIFF |
新剪辑区域将当前裁剪区域的区域与从HRGN标识的区域排除的区域进行组合。 |
RGN_OR |
新的剪辑区域结合了当前剪辑区域和由HRGN标识的区域。 |
RGN_XOR |
新剪辑区域结合了当前剪辑区域和由HRGN标识的区域，但不包括任何重叠区域。 |
返回值
返回值指定新的裁剪区域的复杂度;它可以是以下值之一。
NULLREGION |
区域是空的 |
SIMPLEREGION |
区域是单个矩形。 |
COMPLEXREGION |
区域是多个矩形。 |
ERROR |
发生错误 |
备注
如果调用此函数时发生错误，则不会影响指定设备上下文的上一个剪裁区域。
ExtSelectClipRgn函数假设以设备为单位指定指定区域的坐标。
仅使用由hrgn参数标识的区域的副本。该地区本身可以在此呼叫后重用，也可以删除。
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）