Graphics::ResetClip Method ()

 

Resets the clip region of this Graphics to an infinite region.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public:
void ResetClip()

When the clipping region of a Graphics is infinite, items that this Graphics draws are not clipped.

The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. The code performs the following actions:

  • Creates a rectangle with upper-left corner at (0, 0) and sets the clipping region to this rectangle.

  • Creates a second rectangle with upper-left corner at (100, 100) and sets the clipping region to the intersection of this rectangle and the current clipping region (the first rectangle).

  • Fills a large rectangle that includes both previous rectangles with a solid blue brush.

  • Resets the clipping region to infinite.

  • Draws rectangles around the two clipping regions; it uses a black pen for the first clipping rectangle and a red pen for the second clipping region.

The result is that only the intersection of the two rectangles is filled with blue.

public:
   void IntersectClipRectangleF2( PaintEventArgs^ e )
   {
      // Set clipping region.
      Rectangle clipRect = Rectangle(0,0,200,200);
      e->Graphics->SetClip( clipRect );

      // Update clipping region to intersection of
      // existing region with specified rectangle.
      RectangleF intersectRectF = RectangleF(100.0F,100.0F,200.0F,200.0F);
      e->Graphics->IntersectClip( intersectRectF );

      // Fill rectangle to demonstrate effective clipping region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Blue ), 0, 0, 500, 500 );

      // Reset clipping region to infinite.
      e->Graphics->ResetClip();

      // Draw clipRect and intersectRect to screen.
      e->Graphics->DrawRectangle( gcnew Pen( Color::Black ), clipRect );
      e->Graphics->DrawRectangle( gcnew Pen( Color::Red ), Rectangle::Round( intersectRectF ) );
   }

.NET Framework
Available since 1.1
Return to top
Show: