Export (0) Print
Expand All

Graphics.SetClip Method (Rectangle)

Sets the clipping region of this Graphics to the rectangle specified by a Rectangle structure.

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

public void SetClip(
	Rectangle rect
)

Parameters

rect
Type: System.Drawing.Rectangle

Rectangle structure that represents the new clip region.

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 small rectangle for the clipping region.

  • Sets the clipping region to the rectangle.

  • Fills a large rectangle with a solid black brush.

The result is a small, filled, black rectangle.

private void SetClipRectangle(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    Rectangle clipRect = new Rectangle(0, 0, 100, 100);

    // Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft