Pen::SetTransform-Methode (gdipluspen.h)

Artikel
08/24/2023

Die Pen::SetTransform-Methode legt die Welttransformation dieses Pen-Objekts fest.

Syntax

Status SetTransform(
  [in] const Matrix *matrix
);

Parameter

[in] matrix

Typ: const Matrix*

Zeiger auf ein Matrix-Objekt , das die Welttransformation 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

Diese Methode ignoriert den Übersetzungsteil des Matrix-Objekts .

Beispiele

Im folgenden Beispiel werden eine Skalierungsmatrix und ein Pen-Objekt erstellt und dann ein Rechteck zeichnet. zeichnet. Der Code skaliert dann den Stift durch die Matrix und zeichnet ein zweites Rechteck.

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

   Matrix matrix(20, 0, 0, 10, 0, 0);  // scale

   // Create a pen, and use it to draw a rectangle.
   Pen pen(Color(255, 0, 0, 255), 2);
   graphics.DrawRectangle(&pen, 10, 50, 150, 100);

   // Scale the pen width by a factor of 20 in the horizontal 
   // direction and a factor of 10 in the vertical direction.
   pen.SetTransform(&matrix);

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

Anforderungen


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