Graphics.TranslateClip Method

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

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

Overloads

TranslateClip(Int32, Int32)	Translates the clipping region of this Graphics by specified amounts in the horizontal and vertical directions.
TranslateClip(Single, Single)	Translates the clipping region of this Graphics by specified amounts in the horizontal and vertical directions.

TranslateClip(Int32, Int32)

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

public:
 void TranslateClip(int dx, int dy);

public void TranslateClip (int dx, int dy);

member this.TranslateClip : int * int -> unit

Public Sub TranslateClip (dx As Integer, dy As Integer)

Parameters

dx

Int32

The x-coordinate of the translation.

dy

Int32

The y-coordinate of the translation.

Examples

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, 50).

• Fills a large rectangle with a solid black brush.

The result is a translated, small, black rectangle.

public:
   void TranslateClipInt( PaintEventArgs^ e )
   {
      // Create rectangle for clipping region.
      Rectangle clipRect = Rectangle(0,0,100,100);

      // Set clipping region of graphics to rectangle.
      e->Graphics->SetClip( clipRect );

      // Translate clipping region.
      int dx = 50;
      int dy = 50;
      e->Graphics->TranslateClip( dx, dy );

      // Fill rectangle to demonstrate translated clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }

private void TranslateClipInt(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    Rectangle clipRect = new Rectangle(0, 0, 100, 100);

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

    // Translate clipping region.
    int dx = 50;
    int dy = 50;
    e.Graphics.TranslateClip(dx, dy);

    // Fill rectangle to demonstrate translated clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}

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.
    e.Graphics.SetClip(clipRect)

    ' 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

TranslateClip(Single, Single)

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

public:
 void TranslateClip(float dx, float dy);

public void TranslateClip (float dx, float dy);

member this.TranslateClip : single * single -> unit

Public Sub TranslateClip (dx As Single, dy As Single)

Parameters

dx

Single

The x-coordinate of the translation.

dy

Single

The y-coordinate of the translation.

Examples

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.

public:
   void TranslateClipFloat( PaintEventArgs^ e )
   {
      // Create rectangle for clipping region.
      RectangleF clipRect = RectangleF(0.0F,0.0F,100.0F,100.0F);

      // Set clipping region of graphics to rectangle.
      e->Graphics->SetClip( clipRect );

      // Translate clipping region.
      float dx = 50.0F;
      float dy = 50.0F;
      e->Graphics->TranslateClip( dx, dy );

      // Fill rectangle to demonstrate translated clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }

private void TranslateClipFloat(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    RectangleF clipRect = new RectangleF(0.0F, 0.0F, 100.0F, 100.0F);

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

    // Translate clipping region.
    float dx = 50.0F;
    float dy = 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);
}

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