Graphics：：SetClip (HRGN，CombineMode) 方法 (gdiplusgraphics.h)

项目
08/24/2023

Graphics：：SetClip 方法将此 Graphics 对象的剪辑区域更新为一个区域，该区域是自身与 Windows 图形设备接口 (GDI) 区域的组合。

语法

Status SetClip(
  [in] HRGN        hRgn,
  [in] CombineMode combineMode
);

parameters

[in] hRgn

类型： HRGN

要将此 Graphics 对象的剪裁区域组合在一起的 GDI 区域的句柄。这是为旧代码提供的。新应用程序应传递 Region 对象作为第一个参数。

[in] combineMode

类型： CombineMode

可选。 CombineMode 枚举的元素，指定 GDI 区域如何将此 Graphics 对象的剪辑区域组合在一起。默认值为 CombineModeReplace。

返回值

类型：状态

如果该方法成功，则返回 Ok，这是 Status 枚举的元素。

如果方法失败，它将返回 Status 枚举的其他元素之一。

注解

此方法假定 hRgn 指定的 GDI 区域已以设备单位表示，因此它不会转换 GDI 区域的坐标。

示例

以下示例使用 GDI 区域更新剪辑区域。

VOID Example_SetClip2(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a Region object, and get its handle.
   Region region(Rect(0, 0, 100, 100));
   HRGN hRegion = region.GetHRGN(&graphics);

   // Set the clipping region with hRegion.
   graphics.SetClip(hRegion);

   // Fill a rectangle to demonstrate the clipping region.
   graphics.FillRectangle(&SolidBrush(Color(255, 0, 0, 0)), 0, 0, 500, 500);
}

要求


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