Graphics.SetClip Method (Graphics)

 

Sets the clipping region of this Graphics to the Clip property of the specified Graphics.

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

public void SetClip(
	Graphics g
)

Parameters

g
Type: System.Drawing.Graphics

Graphics from which to take 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, as well as thisForm, the Form for the example. The code performs the following actions:

  • Creates a temporary Graphics from the thisFormForm of the example.

  • Sets the clipping region of the temporary Graphics to a small square.

  • Updates the clipping region of the form's graphic object to that of the temporary Graphics.

  • Fills a large rectangle with a solid black brush.

The result is a small, filled, black square.

private void SetClipGraphics(PaintEventArgs e)
{

    // Create temporary graphics object and set its clipping region.
    Graphics newGraphics = this.CreateGraphics();
    newGraphics.SetClip(new Rectangle(0, 0, 100, 100));

    // Update clipping region of graphics to clipping region of new

    // graphics.
    e.Graphics.SetClip(newGraphics);

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

    // Release new graphics.
    newGraphics.Dispose();
}

.NET Framework
Available since 1.1
Return to top
Show: