Graphics：：ResetClip 方法 (gdiplusgraphics.h)

發行項
02/29/2024

Graphics：：ResetClip 方法會將這個 Graphics 物件的裁剪區域設定為無限區域。

Syntax

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)
程式庫	Gdiplus.lib
Dll	Gdiplus.dll