SetClip Method (Region, CombineMode)

Graphics.SetClip Method (Region, CombineMode)


Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the specified Region.

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

Public Sub SetClip (
	region As Region,
	combineMode As CombineMode


Type: System.Drawing.Region

Region to combine.

Type: System.Drawing.Drawing2D.CombineMode

Member from 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 SetClipRegionCombine(ByVal e As PaintEventArgs)

    ' Create region for clipping.
    Dim clipRegion As New [Region](New Rectangle(0, 0, 100, 100))

    ' Set clipping region of graphics to region.
    e.Graphics.SetClip(clipRegion, 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
© 2016 Microsoft