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 Sub SetClip (
	g As Graphics
)

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 Sub SetClipGraphics(ByVal e As PaintEventArgs)

    ' Create temporary graphics object and set its clipping region.
    Dim newGraphics As Graphics = Me.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()
End Sub

.NET Framework
Available since 1.1
Return to top
Show: