Freigeben über


Graphics::ResetClip-Methode (gdiplusgraphics.h)

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

Weitere Informationen

Freistellen

Beschneiden mit einer Region

Grafiken

Graphics::GetClip

Graphics::IsClipEmpty

IntersectClip-Methoden

IsEmpty