Graphics::TranslateClip Method (Single, Single)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

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)

void TranslateClip(
	float dx,
	float dy


Type: System::Single

The x-coordinate of the translation.

Type: System::Single

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.0F, 50.0F).

  • Fills a large rectangle with a solid black brush.

The result is a translated, small, black rectangle.

   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 );

.NET Framework
Available since 1.1
Return to top