Partager via


Graphics ::TranslateTransform, méthode (gdiplusgraphics.h)

La méthode Graphics ::TranslateTransform met à jour la matrice de transformation mondiale de cet objet Graphics avec le produit de lui-même et une matrice de traduction.

Syntaxe

Status TranslateTransform(
  [in]           REAL        dx,
  [in]           REAL        dy,
  [in, optional] MatrixOrder order
);

Paramètres

[in] dx

Type : REAL

Nombre réel qui spécifie le composant horizontal de la traduction.

[in] dy

Type : REAL

Nombre réel qui spécifie le composant vertical de la traduction.

[in, optional] order

Type : MatrixOrder

facultatif. Élément de l’énumération MatrixOrder qui spécifie l’ordre de multiplication. MatrixOrderPrepend spécifie que la matrice de traduction se trouve à gauche, et MatrixOrderAppend spécifie que la matrice de traduction se trouve à droite. La valeur par défaut est MatrixOrderPrepend.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Remarques

Note GDI+ gère les pinceaux différemment lorsque l’échelle de transformation mondiale est inférieure à 100 % (1,0f) dans la direction x ou y. Si l’échelle de transformation mondiale est inférieure à 100 %(1.0f), veillez à multiplier le décalage pour TranslateTransform par l’échelle de transformation mondiale.
 

Exemples

L’exemple suivant définit la transformation du monde d’un objet Graphics sur une rotation. L’appel à Graphics ::TranslateTransform multiplie la matrice de transformation du monde (rotation) existante de l’objet Graphics par une matrice de traduction. L’argument MatrixOrderAppend spécifie que la multiplication est effectuée avec la matrice de traduction à droite. À ce stade, la matrice de transformation mondiale de l’objet Graphics représente une transformation composite : d’abord faire pivoter, puis traduire. L’appel à DrawEllipse dessine une ellipse pivotée et traduite.

VOID Example_TranslateTransform(HDC hdc)
{
   Graphics graphics(hdc);
   Pen pen(Color(255, 0, 0, 255));

   graphics.RotateTransform(30.0f);
   graphics.TranslateTransform(100.0f, 50.0f, MatrixOrderAppend);
   graphics.DrawEllipse(&pen, 0, 0, 200, 80);
}

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête gdiplusgraphics.h (include Gdiplus.h)
Bibliothèque Gdiplus.lib
DLL Gdiplus.dll

Voir aussi

Systèmes de coordonnées et transformations

Graphismes

Graphics ::GetTransform

Graphics ::ResetTransform

Graphics ::ScaleTransform

Graphics ::SetTransform

Graphics ::TransformPoints

Matrice

MatrixOrder

Transformations