Graphics::TransformPoints(CoordinateSpace,CoordinateSpace,Point*,INT)-Methode (gdiplusgraphics.h)

Artikel
02/29/2024

Die Graphics::TransformPoints-Methode konvertiert ein Array von Punkten aus einem Koordinatenraum in einen anderen. Die Konvertierung basiert auf der aktuellen Welt- und Seitentransformation dieses Graphics-Objekts .

Syntax

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

Parameter

[in] destSpace

Typ: CoordinateSpace

Element der CoordinateSpace-Enumeration , das den Zielkoordinatenbereich angibt.

[in] srcSpace

Typ: CoordinateSpace

Element der CoordinateSpace-Enumeration , das den Quellkoordinatenbereich angibt.

[in, out] pts

Typ: Punkt*

Zeiger auf ein Array, das bei der Eingabe die zu konvertierenden Punkte und bei der Ausgabe die konvertierten Punkte enthält.

[in] count

Typ: INT

Eine ganze Zahl, die die Anzahl der Elemente im pts-Array angibt.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Die Welttransformation konvertiert Punkte aus dem Weltkoordinatenraum in den Seitenkoordinatenraum. Die Seitentransformation konvertiert Punkte aus dem Seitenkoordinatenbereich in den Gerätekoordinatenbereich. Weitere Informationen zu Koordinatenräumen finden Sie unter Typen von Koordinatensystemen.

Beispiele

Im folgenden Beispiel wird ein Graphics-Objekt erstellt und dessen Welttransformation auf eine Übersetzung um 40 Einheiten rechts und 30 Einheiten nach unten festgelegt. Anschließend erstellt der Code ein Array von Punkten und übergibt die Adresse dieses Arrays an die Graphics::TransformPoints-Methode desselben Graphics-Objekts . Die Punkte im Array werden durch die Welttransformation des Graphics-Objekts transformiert. Der Code ruft die Graphics::D rawLine-Methode zweimal auf: einmal, um die beiden Punkte vor der Transformation zu verbinden, und einmal, um die beiden Punkte nach der Transformation zu verbinden.

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]);
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusgraphics.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll