LinearGradientBrush::GetTransform-Methode (gdiplusbrush.h)

Artikel
08/23/2023

Die LinearGradientBrush::GetTransform-Methode ruft die Transformationsmatrix dieses linearen Farbverlaufspinsels ab.

Syntax

Status GetTransform(
  [out] Matrix *matrix
);

Parameter

[out] matrix

Typ: Matrix*

Zeiger auf ein Matrix-Objekt , das die Transformationsmatrix empfängt.

Rückgabewert

Typ: Status

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

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Ein LinearGradientBrush-Objekt verwaltet eine Transformationsmatrix, die jede affine Transformation speichern kann. Wenn Sie einen linearen Farbverlaufspinsel zum Ausfüllen eines Bereichs verwenden, transformiert GDI+ die Begrenzungslinien des Pinsels gemäß der Transformationsmatrix des Pinsels und füllt dann den Bereich aus. Die transformierten Grenzen sind nur während des Renderns vorhanden. Die im LinearGradientBrush-Objekt gespeicherten Grenzen werden nicht transformiert.

Beispiele

Im folgenden Beispiel wird ein linearer Farbverlaufspinsel erstellt und dessen Transformationsmatrix festgelegt. Als Nächstes ruft der Code die Transformationsmatrix des Pinsels ab und überprüft oder verwendet die Matrixelemente.

VOID Example_GetTransform(HDC hdc)
{
   Graphics myGraphics(hdc);

   // Construct a linear gradient brush, and set its transformation.
   LinearGradientBrush linGrBrush( 
      Point(0, 0),
      Point(200, 0),
      Color(255, 255, 0, 0),    // red
      Color(255, 0, 0, 255));   // blue

   Matrix matrixSet(0, 1, -1, 0, 0, 0);

   linGrBrush.SetTransform(&matrixSet);

   // Obtain information about the linear gradient brush.
   Matrix matrixGet;
   REAL   elements[6];

   linGrBrush.GetTransform(&matrixGet);
   matrixGet.GetElements(elements);  

   for(INT j = 0; j <= 5; ++j)
   {
       // Inspect or use the value in elements[j].
   }
}

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