Graphics.TranslateClip Method (Int32, Int32)


Translates the clipping region of this Graphics by specified amounts in the horizontal and vertical directions.

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

Public Sub TranslateClip (
	dx As Integer,
	dy As Integer


Type: System.Int32

The x-coordinate of the translation.

Type: System.Int32

The y-coordinate of the translation.

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 rectangle for the clipping region.

  • Sets the clipping region to the rectangle.

  • Translates the clipping region by a vector (50, 50).

  • Fills a large rectangle with a solid black brush.

The result is a translated, small, black rectangle.

Private Sub TranslateClipInt(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.

    ' Translate clipping region.
    Dim dx As Integer = 50
    Dim dy As Integer = 50
    e.Graphics.TranslateClip(dx, dy)

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

.NET Framework
Available since 1.1
Return to top