Graphics.ScaleTransform Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

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

Applique l’opération de mise à l’échelle spécifiée à la matrice de transformation de cette Graphics en la précédant dans la matrice de transformation de l’objet.

Surcharges

ScaleTransform(Single, Single)	Applique l’opération de mise à l’échelle spécifiée à la matrice de transformation de cette Graphics en la précédant dans la matrice de transformation de l’objet.
ScaleTransform(Single, Single, MatrixOrder)	Applique l’opération de mise à l’échelle spécifiée à la matrice de transformation de cette Graphics dans l’ordre spécifié.

ScaleTransform(Single, Single)

Source:

Graphics.cs

Applique l’opération de mise à l’échelle spécifiée à la matrice de transformation de cette Graphics en la précédant dans la matrice de transformation de l’objet.

public:
 void ScaleTransform(float sx, float sy);

public void ScaleTransform (float sx, float sy);

member this.ScaleTransform : single * single -> unit

Public Sub ScaleTransform (sx As Single, sy As Single)

Paramètres

sx

Single

Facteur d’échelle dans le sens x.

sy

Single

Facteur d’échelle dans la direction y.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d’événements Paint. Le code effectue les actions suivantes :

• Fait pivoter la matrice de transformation mondiale du Windows Form de 30 degrés.

• Met à l’échelle cette matrice d’un facteur de 3 dans la direction x et d’un facteur de 1 dans la direction y en préparant la transformation de mise à l’échelle.

• Dessine un rectangle mis à l’échelle et pivoté avec un stylet bleu.

Le résultat est toujours un rectangle.

public:
   void ScaleTransformFloat( PaintEventArgs^ e )
   {
      // Set world transform of graphics object to rotate.
      e->Graphics->RotateTransform( 30.0F );

      // Then to scale, prepending to world transform.
      e->Graphics->ScaleTransform( 3.0F, 1.0F );

      // Draw scaled, rotated rectangle to screen.
      e->Graphics->DrawRectangle( gcnew Pen( Color::Blue,3.0f ), 50, 0, 100, 40 );
   }

private void ScaleTransformFloat(PaintEventArgs e)
{

    // Set world transform of graphics object to rotate.
    e.Graphics.RotateTransform(30.0F);

    // Then to scale, prepending to world transform.
    e.Graphics.ScaleTransform(3.0F, 1.0F);

    // Draw scaled, rotated rectangle to screen.
    e.Graphics.DrawRectangle(new Pen(Color.Blue, 3), 50, 0, 100, 40);
}

Private Sub ScaleTransformFloat(ByVal e As PaintEventArgs)

    ' Set world transform of graphics object to rotate.
    e.Graphics.RotateTransform(30.0F)

    ' Then to scale, prepending to world transform.
    e.Graphics.ScaleTransform(3.0F, 1.0F)

    ' Draw scaled, rotated rectangle to screen.
    e.Graphics.DrawRectangle(New Pen(Color.Blue, 3), 50, 0, 100, 40)
End Sub

Remarques

L’opération de mise à l’échelle consiste à multiplier la matrice de transformation par une matrice diagonale dont les éléments sont (sx, sy, 1). Cette méthode précède la matrice de transformation du Graphics par la matrice de mise à l’échelle.

ScaleTransform(Single, Single, MatrixOrder)

Source:

Graphics.cs

Applique l’opération de mise à l’échelle spécifiée à la matrice de transformation de cette Graphics dans l’ordre spécifié.

public:
 void ScaleTransform(float sx, float sy, System::Drawing::Drawing2D::MatrixOrder order);

public void ScaleTransform (float sx, float sy, System.Drawing.Drawing2D.MatrixOrder order);

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

Public Sub ScaleTransform (sx As Single, sy As Single, order As MatrixOrder)

Paramètres

sx

Single

Facteur d’échelle dans le sens x.

sy

Single

Facteur d’échelle dans la direction y.

order

MatrixOrder

Membre de l’énumération MatrixOrder qui spécifie si l’opération de mise à l’échelle est précédée ou ajoutée à la matrice de transformation.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d’événements Paint. Le code effectue les actions suivantes :

• Fait pivoter la matrice de transformation mondiale du Windows Form de 30 degrés.

• Met à l’échelle cette matrice d’un facteur de 3 dans la direction x et un facteur de 1 dans la direction y en ajoutant la transformation de mise à l’échelle avec le membre Append.

• Dessine un rectangle pivoté et mis à l’échelle avec un stylet bleu.

Le résultat est un parallélisme.

public:
   void ScaleTransformFloatMatrixOrder( PaintEventArgs^ e )
   {
      // Set world transform of graphics object to rotate.
      e->Graphics->RotateTransform( 30.0F );

      // Then to scale, appending to world transform.
      e->Graphics->ScaleTransform( 3.0F, 1.0F, MatrixOrder::Append );

      // Draw rotated, scaled rectangle to screen.
      e->Graphics->DrawRectangle( gcnew Pen( Color::Blue,3.0f ), 50, 0, 100, 40 );
   }

private void ScaleTransformFloatMatrixOrder(PaintEventArgs e)
{

    // Set world transform of graphics object to rotate.
    e.Graphics.RotateTransform(30.0F);

    // Then to scale, appending to world transform.
    e.Graphics.ScaleTransform(3.0F, 1.0F, MatrixOrder.Append);

    // Draw rotated, scaled rectangle to screen.
    e.Graphics.DrawRectangle(new Pen(Color.Blue, 3), 50, 0, 100, 40);
}

Private Sub ScaleTransformFloatMatrixOrder(ByVal e As PaintEventArgs)

    ' Set world transform of graphics object to rotate.
    e.Graphics.RotateTransform(30.0F)

    ' Then to scale, appending to world transform.
    e.Graphics.ScaleTransform(3.0F, 1.0F, MatrixOrder.Append)

    ' Draw rotated, scaled rectangle to screen.
    e.Graphics.DrawRectangle(New Pen(Color.Blue, 3), 50, 0, 100, 40)
End Sub

Remarques

L’opération de mise à l’échelle consiste à multiplier la matrice de transformation par une matrice diagonale dont les éléments sont (sx, sy, 1). Cette méthode précède ou ajoute la matrice de transformation de l'Graphics par la matrice de mise à l’échelle en fonction du paramètre order.