LinearGradientBrush.TranslateTransform Methode

Definition

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v9.0.0-preview.6.24327.6

Übersetzt die lokale geometrische Transformation durch die angegebenen Dimensionen. Diese Methode stellt die Übersetzung der Transformation voran.

Überlädt

TranslateTransform(Single, Single, MatrixOrder)	Übersetzt die lokale geometrische Transformation durch die angegebenen Dimensionen in der angegebenen Reihenfolge.
TranslateTransform(Single, Single)	Übersetzt die lokale geometrische Transformation durch die angegebenen Dimensionen. Diese Methode stellt die Übersetzung der Transformation voran.

TranslateTransform(Single, Single, MatrixOrder)

Quelle:

LinearGradientBrush.cs

Übersetzt die lokale geometrische Transformation durch die angegebenen Dimensionen in der angegebenen Reihenfolge.

public:
 void TranslateTransform(float dx, float dy, System::Drawing::Drawing2D::MatrixOrder order);

public void TranslateTransform (float dx, float dy, System.Drawing.Drawing2D.MatrixOrder order);

member this.TranslateTransform : single * single * System.Drawing.Drawing2D.MatrixOrder -> unit

Public Sub TranslateTransform (dx As Single, dy As Single, order As MatrixOrder)

Parameter

dx

Single

Der Wert der Übersetzung in x.

dy

Single

Der Wert der Übersetzung in y.

order

MatrixOrder

Die Reihenfolge (vorangestellt oder angefügt), in der die Übersetzung angewendet werden soll.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, ein OnPaint-Ereignisobjekt. Der Code führt die folgenden Aktionen aus:

• Erstellt eine neue LinearGradientBrush.

• Verwendet diesen Pinsel, um ein Rechteck auf den Bildschirm zu zeichnen, das einen linearen, links-nach-rechts-Übergang von Farben aufweist.

• Dreht die LinearGradientBrush um 90 Grad und skaliert den Farbverlauf.

• Zeichnet das Rechteck mit dem gedrehten und skalierten Farbverlauf auf den Bildschirm.

• Übersetzt das Rechteck so, dass es einen linearen Farbverlauf von oben nach unten aufweist.

• Zeichnet das übersetzte Rechteck auf den Bildschirm.

Beachten Sie, dass drei Rechtecke oben angezeigt werden, die den links-nach-rechts-Farbverlauf, die mitte mit dem gedrehten und skalierten Farbverlauf und am unteren Rand mit dem endgültigen übersetzten Farbverlauf angezeigt wird.

private:
   void TranslateTransformExample( PaintEventArgs^ e )
   {
      // Create a LinearGradientBrush.
      Rectangle myRect = Rectangle(20,20,200,100);
      LinearGradientBrush^ myLGBrush = gcnew LinearGradientBrush( myRect,Color::Blue,Color::Red,0.0f,true );

      // Draw a rectangle to the screen using the LinearGradientBrush.
      e->Graphics->FillRectangle( myLGBrush, myRect );

      // Rotate the LinearGradientBrush.
      myLGBrush->RotateTransform( 90.0f );

      // Scale the gradient for the height of the rectangle.
      myLGBrush->ScaleTransform( 0.5f, 1.0f );

      // Draw to the screen, the rotated and scaled gradient.
      e->Graphics->FillRectangle( myLGBrush, 20, 150, 200, 100 );

      // Rejustify the brush to start at the top edge of the
      // rectangle.
      myLGBrush->TranslateTransform(  -20.0f, 0.0f );

      // Draw a third rectangle to the screen using the translated
      // brush.
      e->Graphics->FillRectangle( myLGBrush, 20, 300, 200, 100 );
   }

private void TranslateTransformExample(PaintEventArgs e)
{
             
    // Create a LinearGradientBrush.
    Rectangle myRect = new Rectangle(20, 20, 200, 100);
    LinearGradientBrush myLGBrush = new LinearGradientBrush(
        myRect, Color.Blue, Color.Red,  0.0f, true);
             
    // Draw a rectangle to the screen using the LinearGradientBrush.
    e.Graphics.FillRectangle(myLGBrush, myRect);
             
    // Rotate the LinearGradientBrush.
    myLGBrush.RotateTransform(90.0f);
             
    // Scale the gradient for the height of the rectangle.
    myLGBrush.ScaleTransform(0.5f, 1.0f);
             
    // Draw to the screen, the rotated and scaled gradient.
    e.Graphics.FillRectangle(myLGBrush, 20, 150, 200, 100);
             
    // Rejustify the brush to start at the top edge of the
    // rectangle.
    myLGBrush.TranslateTransform(-20.0f, 0.0f);
             
    // Draw a third rectangle to the screen using the translated
    // brush.
    e.Graphics.FillRectangle(myLGBrush, 20, 300, 200, 100);
}

Public Sub TranslateTransformExample(ByVal e As PaintEventArgs)

    ' Create a LinearGradientBrush.
    Dim myRect As New Rectangle(20, 20, 200, 100)
    Dim myLGBrush As New LinearGradientBrush(myRect, Color.Blue, _
    Color.Red, 0.0F, True)

    ' Draw a rectangle to the screen using the LinearGradientBrush.
    e.Graphics.FillRectangle(myLGBrush, myRect)

    ' Rotate the LinearGradientBrush.
    myLGBrush.RotateTransform(90.0F)

    ' Scale the gradient for the height of the rectangle.
    myLGBrush.ScaleTransform(0.5F, 1.0F)

    ' Draw to the screen, the rotated and scaled gradient.
    e.Graphics.FillRectangle(myLGBrush, 20, 150, 200, 100)

    ' Rejustify the brush to start at the top edge of the rectangle.
    myLGBrush.TranslateTransform(-20.0F, 0.0F)

    ' Draw a third rectangle to the screen using the translated brush.
    e.Graphics.FillRectangle(myLGBrush, 20, 300, 200, 100)
End Sub

TranslateTransform(Single, Single)

Quelle:

LinearGradientBrush.cs

Übersetzt die lokale geometrische Transformation durch die angegebenen Dimensionen. Diese Methode stellt die Übersetzung der Transformation voran.

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

public void TranslateTransform (float dx, float dy);

member this.TranslateTransform : single * single -> unit

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

Parameter

dx

Single

Der Wert der Übersetzung in x.

dy

Single

Der Wert der Übersetzung in y.

Beispiele

Ein Beispiel finden Sie unter TranslateTransform.