Graphics.SetClip Method (Rectangle, CombineMode)

 

Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the rectangle specified by a Rectangle structure.

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

Public Sub SetClip (
	rect As Rectangle,
	combineMode As CombineMode
)

Parameters

rect
Type: System.Drawing.Rectangle

Rectangle structure to combine.

combineMode
Type: System.Drawing.Drawing2D.CombineMode

Member of the CombineMode enumeration that specifies the combining operation to use.

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 with the Replace member.

  • Fills a large rectangle with a solid black brush.

The result is a small, filled, black rectangle.

Private Sub SetClipRectangleCombine(ByVal e As PaintEventArgs)

    ' Create rectangle for clipping region.
    Dim clipRect As New Rectangle(0, 0, 100, 100)

    ' Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect, CombineMode.Replace)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

.NET Framework
Available since 1.1
Return to top
Show: