Graphics：：ResetClip 方法 (gdiplusgraphics.h)

项目
08/24/2023

Graphics：：ResetClip 方法将此 Graphics 对象的剪辑区域设置为无限区域。

语法

Status ResetClip();

返回值

类型：状态

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

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

注解

如果 Graphics 对象的剪裁区域是无限的，则不会剪裁该 Graphics 对象绘制的项目。

示例

以下示例创建一个 Graphics 对象，并将其剪裁区域设置为矩形。代码将填充与矩形剪裁区域相交的两个省略号。第一个椭圆被剪裁，但第二个椭圆不会剪裁，因为它是在调用 Graphics：：ResetClip 后填充的。

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

   // Set the clipping region, and draw its outline.
   graphics.SetClip(Rect(100, 50, 200, 120));
   Pen blackPen(Color(255, 0, 0, 0), 2.0f);
   graphics.DrawRectangle(&blackPen, 100, 50, 200, 120);

   // Fill a clipped ellipse in red.
   SolidBrush redBrush(Color(255, 255, 0, 0));
   graphics.FillEllipse(&redBrush, 80, 40, 100, 70);

   // Reset the clipping region.
   graphics.ResetClip();

   // Fill an unclipped ellipse with blue.
   SolidBrush blueBrush(Color(255, 0, 0, 255));
   graphics.FillEllipse(&blueBrush, 160, 150, 100, 60);
}

要求

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