CDC::SelectClipRgn

项目
03/01/2013

选择该特定区域为当前剪辑区域的设备上下文。

int SelectClipRgn(
   CRgn* pRgn 
);
int SelectClipRgn(
   CRgn* pRgn,
   int nMode 
);

参数

pRgn
标识要选择的区域。
- 对于此函数的第一个版本，因此，如果该值为 NULL，整个工作区中选择，然后输出仍剪辑到窗口。
- 对此函数的第二个版本，仅当 RGN_COPY 模式指定时，此句柄，可以是 NULL。
nMode
指定要执行的操作。它必须是下列值之一：
- RGN_AND 新的剪辑区域合并 pRgn和该区域的定位复盖率区域当前剪辑区域。
- RGN_COPY 新的剪辑区域是 pRgn确定的区域的副本。这是函数与 SelectClipRgn的第一个版本相同。如果 pRgn 确定的区域是 NULL，新的剪辑区域是剪辑区域(空区域)的默认设置。
- RGN_DIFF 新的剪辑区域合并当前剪辑区域的区域与该区域排除的某些区域由标识 pRgn。
- RGN_OR 新的剪辑区域合并 pRgn和该区域确定的当前剪辑区域。
- RGN_XOR 新的剪辑区域合并 pRgn 和该区域确定的当前剪辑区域，但排除所有复盖率区域。

返回值

区域的类型。它可以是下列值中的任何一项:

COMPLEXREGION 新的剪辑区域存在重叠的边框。
ERROR 设备上下文或区域无效。
NULLREGION 新的剪辑区域是空。
SIMPLEREGION 新的剪辑区域不存在重叠的边框。

备注

使用所选区域的副本。该区域可用于任意数量的其他设备上下文中选择，也可以删除。

该函数，假设给定区域的坐标。组件单位指定。有些打印机比图形输出支持文本输出在高分辨率以便保留必要的精度表示文本指标。这些设备报告组件单位高分辨率，也就是说，在文本单元。这些设备和缩放图像的坐标，以便虚拟内存组件单位映射到1个图像单元报告。使用文本单元，应始终调用 SelectClipRgn 功能。

必须对图形对象缩放在GDI的应用程序可以使用 GETSCALINGFACTOR 打印机转义确定比例因子。此比例因子影响剪裁。如果区域用于剪辑image，GDI按比例因子部件坐标。如果区域用于剪辑文本，GDI不进行缩放调整。比例因子1后坐标除了2;2个原因比例因子4将除的坐标;等等。