Graphics ::TransformPoints(CoordinateSpace,CoordinateSpace,Point*,INT) , méthode (gdiplusgraphics.h)

Article
03/02/2024

La méthode Graphics ::TransformPoints convertit un tableau de points d’un espace de coordonnées en un autre. La conversion est basée sur le monde actuel et les transformations de page de cet objet Graphics .

Syntaxe

Status TransformPoints(
  [in]      CoordinateSpace destSpace,
  [in]      CoordinateSpace srcSpace,
  [in, out] Point           *pts,
  [in]      INT             count
);

Paramètres

[in] destSpace

Type : CoordinateSpace

Élément de l’énumération CoordinateSpace qui spécifie l’espace de coordonnées de destination.

[in] srcSpace

Type : CoordinateSpace

Élément de l’énumération CoordinateSpace qui spécifie l’espace de coordonnées source.

[in, out] pts

Type : Point*

Pointeur vers un tableau qui, en entrée, contient les points à convertir et, en sortie, contient les points convertis.

[in] count

Type : INT

Entier qui spécifie le nombre d’éléments dans le tableau pts .

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

La transformation de monde convertit les points de l’espace de coordonnées du monde en espace de coordonnées de page. La transformation de page convertit les points de l’espace de coordonnées de la page en espace de coordonnées de l’appareil. Pour plus d’informations sur les espaces de coordonnées, consultez Types de systèmes de coordonnées.

Exemples

L’exemple suivant crée un objet Graphics et définit sa transformation de monde sur une traduction de 40 unités vers la droite et de 30 unités vers le bas. Ensuite, le code crée un tableau de points et transmet l’adresse de ce tableau à la méthode Graphics ::TransformPoints du même objet Graphics . Les points du tableau sont transformés par la transformation du monde de l’objet Graphics . Le code appelle la méthode Graphics ::D rawLine deux fois : une fois pour connecter les deux points avant la transformation et une fois pour connecter les deux points après la transformation.

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

   // Create an array of two Point objects.
   Point points[2] = {Point(0, 0), Point(100, 50)};

   // Draw a line that connects the two points.
   // No transformation has been performed yet.
   graphics.DrawLine(&pen, points[0], points[1]);

   // Set the world transformation of the Graphics object.
   graphics.TranslateTransform(40.0f, 30.0f);

   // Transform the points in the array from world to page coordinates.
   graphics.TransformPoints(
      CoordinateSpacePage, 
      CoordinateSpaceWorld, 
      points, 
      2);

   // It is the world transformation that takes points from world
   // space to page space. Because the world transformation is a
   // translation 40 to the right and 30 down, the
   // points in the array are now (40, 30) and (140, 80).

   // Draw a line that connects the transformed points.
   graphics.ResetTransform();
   graphics.DrawLine(&pen, points[0], points[1]);
}

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