Graphics::TranslateClip Method (Single, Single)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com 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)

public:
void TranslateClip(
	float dx,
	float dy
)

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 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.

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

.NET Framework
Available since 1.1
Return to top
Show: