pen::ResetTransform-Methode (gdipluspen.h)

Artikel
02/26/2024

Die Pen::ResetTransform-Methode legt die Welttransformationsmatrix dieses Pen-Objekts auf die Identitätsmatrix fest.

Syntax

Status ResetTransform();

Rückgabewert

Typ: Status

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

Wenn bei der Methode ein Fehler auftritt, gibt sie eines der anderen Elemente der Ok-Enumeration zurück.

Hinweise

Die Identitätsmatrix stellt eine Transformation dar, die nichts bewirkt. Wenn die Welttransformationsmatrix eines Pen-Objekts die Identitätsmatrix ist, wird keine Welttransformation auf Elemente angewendet, die mit diesem Pen-Objekt gezeichnet wurden.

Beispiele

Das folgende Beispiel erstellt ein Pen-Objekt , legt eine Skalierungsmatrix auf den Stift fest und zeichnet ein Rechteck. Der Code setzt dann die Transformation des Stifts zurück und zeichnet ein zweites Rechteck.

VOID Example_ResetTrans(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a pen, and set its transformation.
   Pen pen(Color(255, 0, 0, 255), 2);
   pen.ScaleTransform(8, 4);

   // Draw a rectangle with the transformed pen.
   graphics.DrawRectangle(&pen, 50, 50, 150, 100);

   pen.ResetTransform();

   // Draw a rectangle with no pen transformation.
   graphics.DrawRectangle(&pen, 250, 50, 150, 100);
}

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	gdipluspen.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll