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)

void SetClip(
	Rectangle 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 PaintEventArgse, 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.

   void SetClipRectangle( PaintEventArgs^ e )
      // Create rectangle for clipping region.
      Rectangle clipRect = 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( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );

.NET Framework
Available since 1.1
Return to top