Graphics.ResetClip Method

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Source:

Graphics.cs

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

C#

public void ResetClip();

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, 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.

C#

private void IntersectClipRectangleF2(PaintEventArgs e)
{

    // Set clipping region.
    Rectangle clipRect = new Rectangle(0, 0, 200, 200);
    e.Graphics.SetClip(clipRect);

    // Update clipping region to intersection of

    // existing region with specified rectangle.
    RectangleF intersectRectF = new RectangleF(100.0F, 100.0F, 200.0F, 200.0F);
    e.Graphics.IntersectClip(intersectRectF);

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

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

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

Remarks

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

Applies to