Freigeben über


LinearGradientBrush::GetTransform-Methode (gdiplusbrush.h)

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

Weitere Informationen

Pinsel und gefüllte Formen

Füllen von Shapes mit einem Farbverlaufpinsel

Füllen einer Form mit einem Farbverlauf

LinearGradientBrush

LinearGradientBrush::SetTransform

Matrix

Matrixdarstellung von Transformationen

Point

Transformationen