Graphics::ResetClip-Methode (gdiplusgraphics.h)

Artikel
02/29/2024

Die Graphics::ResetClip-Methode legt den Clippingbereich dieses Graphics-Objekts auf einen unendlichen Bereich fest.

Syntax

Status ResetClip();

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Wenn der Beschneidungsbereich eines Graphics-Objekts unendlich ist, werden von diesem Graphics-Objekt gezeichnete Elemente nicht beschnitten.

Beispiele

Im folgenden Beispiel wird ein Graphics-Objekt erstellt und dessen Beschneidungsbereich auf ein Rechteck festgelegt. Der Code füllt zwei Auslassungspunkte aus, die den rechteckigen Beschneidungsbereich überschneiden. Die erste Ellipse wird beschnitten, aber die zweite Ellipse wird nicht beschnitten, da sie nach einem Aufruf von Graphics::ResetClip gefüllt wird.

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);
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusgraphics.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll