Export (0) Print
Expand All

Graphics.TranslateClip Method (Single, Single)

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)

'Declaration
Public Sub TranslateClip ( _
	dx As Single, _
	dy As Single _
)

Parameters

dx
Type: System.Single

The x-coordinate of the translation.

dy
Type: System.Single

The y-coordinate of the translation.

The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, 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.0F, 50.0F).

  • Fills a large rectangle with a solid black brush.

The result is a translated, small, black rectangle.

Private Sub TranslateClipFloat(ByVal e As PaintEventArgs)

    ' Create rectangle for clipping region. 
    Dim clipRect As New RectangleF(0.0F, 0.0F, 100.0F, 100.0F)

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

    ' Translate clipping region. 
    Dim dx As Single = 50.0F
    Dim dy As Single = 50.0F
    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

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft