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

Article
02/29/2024

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