LinearGradientBrush.TranslateTransform Méthode

Définition

Effectue la translation de la transformation géométrique locale selon les dimensions spécifiées.Translates the local geometric transform by the specified dimensions. Cette méthode ajoute la translation avant la transformation.This method prepends the translation to the transform.

Surcharges

TranslateTransform(Single, Single, MatrixOrder)

Effectue la translation de la transformation géométrique locale selon les dimensions spécifiées dans l'ordre donné.Translates the local geometric transform by the specified dimensions in the specified order.

TranslateTransform(Single, Single)

Effectue la translation de la transformation géométrique locale selon les dimensions spécifiées.Translates the local geometric transform by the specified dimensions. Cette méthode ajoute la translation avant la transformation.This method prepends the translation to the transform.

TranslateTransform(Single, Single, MatrixOrder)

Effectue la translation de la transformation géométrique locale selon les dimensions spécifiées dans l'ordre donné.Translates the local geometric transform by the specified dimensions in the specified order.

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)

Paramètres

dx
Single

Valeur de la translation sur l'axe x.The value of the translation in x.

dy
Single

Valeur de la translation sur l'axe y.The value of the translation in y.

order
MatrixOrder

Ordre (ajout au début ou à la fin) dans lequel la translation doit être appliquée.The order (prepend or append) in which to apply the translation.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms, et il requiert PaintEventArgs e un OnPaint objet d’événement.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, an OnPaint event object. Le code effectue les actions suivantes :The code performs the following actions:

  • Crée un LinearGradientBrush.Creates a new LinearGradientBrush.

  • Utilise ce pinceau pour dessiner un rectangle à l’écran qui a une transition linéaire de gauche à droite des couleurs.Uses this brush to draw a rectangle to the screen that has a linear, left-to-right transition of colors.

  • Fait pivoter LinearGradientBrush de par 90 degrés et met à l’échelle le dégradé.Rotates the LinearGradientBrush by 90 degrees and scales the gradient.

  • Dessine le rectangle, avec le dégradé pivoté et mis à l’échelle, à l’écran.Draws the rectangle, with the rotated and scaled gradient, to the screen.

  • Convertit le rectangle afin qu’il ait un dégradé linéaire s’exécutant de haut en bas.Translates the rectangle so that it has a linear gradient running from top to bottom.

  • Dessine le rectangle traduit à l’écran.Draws the translated rectangle to the screen.

Notez qu’il y a trois rectangles affichés en haut, affichant le dégradé de gauche à droite, le milieu le plus à l’autre, le dégradé pivoté et le dégradé mis à l’échelle, le plus bas représentant le dégradé final traduit.Notice that there are three rectangles displayed the top one showing the left-to-right gradient, the middle one showing the rotated and scaled gradient, and the bottom one showing the final, translated gradient.

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

S’applique à

TranslateTransform(Single, Single)

Effectue la translation de la transformation géométrique locale selon les dimensions spécifiées.Translates the local geometric transform by the specified dimensions. Cette méthode ajoute la translation avant la transformation.This method prepends the translation to the transform.

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)

Paramètres

dx
Single

Valeur de la translation sur l'axe x.The value of the translation in x.

dy
Single

Valeur de la translation sur l'axe y.The value of the translation in y.

Exemples

Pour obtenir un exemple, consultez TranslateTransform.For an example, see TranslateTransform.

S’applique à