Matrix.Translate Méthode

Définition

Applique le vecteur de translation spécifié à ce Matrix en l'ajoutant au début.Applies the specified translation vector to this Matrix by prepending the translation vector.

Surcharges

Translate(Single, Single)

Applique le vecteur de translation spécifié (offsetX et offsetY) à ce Matrix en l'ajoutant au début.Applies the specified translation vector (offsetX and offsetY) to this Matrix by prepending the translation vector.

Translate(Single, Single, MatrixOrder)

Applique le vecteur de translation spécifié à ce Matrix dans l'ordre spécifié.Applies the specified translation vector to this Matrix in the specified order.

Translate(Single, Single)

Applique le vecteur de translation spécifié (offsetX et offsetY) à ce Matrix en l'ajoutant au début.Applies the specified translation vector (offsetX and offsetY) to this Matrix by prepending the translation vector.

public:
 void Translate(float offsetX, float offsetY);
public void Translate (float offsetX, float offsetY);
member this.Translate : single * single -> unit
Public Sub Translate (offsetX As Single, offsetY As Single)

Paramètres

offsetX
Single

Valeur de translation x de ce Matrix.The x value by which to translate this Matrix.

offsetY
Single

Valeur de translation y de ce Matrix.The y value by which to translate this Matrix.

Exemples

Pour obtenir un exemple, consultez Translate(Single, Single, MatrixOrder).For an example, see Translate(Single, Single, MatrixOrder).

Translate(Single, Single, MatrixOrder)

Applique le vecteur de translation spécifié à ce Matrix dans l'ordre spécifié.Applies the specified translation vector to this Matrix in the specified order.

public:
 void Translate(float offsetX, float offsetY, System::Drawing::Drawing2D::MatrixOrder order);
public void Translate (float offsetX, float offsetY, System.Drawing.Drawing2D.MatrixOrder order);
member this.Translate : single * single * System.Drawing.Drawing2D.MatrixOrder -> unit
Public Sub Translate (offsetX As Single, offsetY As Single, order As MatrixOrder)

Paramètres

offsetX
Single

Valeur de translation x de ce Matrix.The x value by which to translate this Matrix.

offsetY
Single

Valeur de translation y de ce Matrix.The y value by which to translate this Matrix.

order
MatrixOrder

MatrixOrder qui spécifie l'ordre (ajout au début ou à la fin) dans lequel la translation est appliquée à ce Matrix.A MatrixOrder that specifies the order (append or prepend) in which the translation is applied to this Matrix.

Exemples

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

  • Dessine un rectangle à l’écran avant l’application d’une transformation de translation (rectangle bleu).Draws a rectangle to the screen prior to applying a translate transform (the blue rectangle).

  • Crée une matrice et la convertit par 100 dans les deux axes.Creates a matrix and translates it by 100 in both axes.

  • Applique cette transformation de matrice au rectangle,Applies this matrix transform to the rectangle,

  • Dessine le rectangle transformé à l’écran (rectangle rouge).Draws the transformed rectangle to the screen (the red rectangle).

Notez que le début du rectangle rouge se trouve à 100 points dans les deux axes, à partir du début du triangle bleu.Notice that the beginning of the red rectangle is located 100 points in both axes from the beginning of the blue triangle.

public:
   void TranslateExample( PaintEventArgs^ e )
   {
      Pen^ myPen = gcnew Pen( Color::Blue,1.0f );
      Pen^ myPen2 = gcnew Pen( Color::Red,1.0f );

      // Draw a rectangle to the screen before applying the
      // transform.
      e->Graphics->DrawRectangle( myPen, 20, 20, 100, 50 );

      // Create a matrix and translate it.
      Matrix^ myMatrix = gcnew Matrix;
      myMatrix->Translate( 100, 100, MatrixOrder::Append );

      // Draw the Points to the screen again after applying the
      // transform.
      e->Graphics->Transform = myMatrix;
      e->Graphics->DrawRectangle( myPen2, 20, 20, 100, 50 );
   }
public void TranslateExample(PaintEventArgs e)
{
    Pen myPen = new Pen(Color.Blue, 1);
    Pen myPen2 = new Pen(Color.Red, 1);
             
    // Draw a rectangle to the screen before applying the
    // transform.
    e.Graphics.DrawRectangle(myPen, 20, 20, 100, 50);
             
    // Create a matrix and translate it.
    Matrix myMatrix = new Matrix();
    myMatrix.Translate(100, 100, MatrixOrder.Append);
             
    // Draw the Points to the screen again after applying the
    // transform.
    e.Graphics.Transform = myMatrix;
    e.Graphics.DrawRectangle(myPen2, 20, 20, 100, 50);
}
Public Sub TranslateExample(ByVal e As PaintEventArgs)
    Dim myPen As New Pen(Color.Blue, 1)
    Dim myPen2 As New Pen(Color.Red, 1)

    ' Draw a rectangle to the screen before applying the
    ' transform.
    e.Graphics.DrawRectangle(myPen, 20, 20, 100, 50)

    ' Create a matrix and translate it.
    Dim myMatrix As New Matrix
    myMatrix.Translate(100, 100, MatrixOrder.Append)

    ' Draw the Points to the screen again after applying the
    ' transform.
    e.Graphics.Transform = myMatrix
    e.Graphics.DrawRectangle(myPen2, 20, 20, 100, 50)
End Sub

S’applique à