LinearGradientBrush::SetTransform-Methode (gdiplusbrush.h)

Artikel
02/29/2024

Die LinearGradientBrush::SetTransform-Methode legt die Transformationsmatrix dieses linearen Farbverlaufpinsels fest.

Syntax

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

Parameter

[in] matrix

Typ: const Matrix*

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

Ein LinearGradientBrush-Objekt verfügt über ein Rechteck, das die Anfangs- und Endgrenzen des Farbverlaufs sowie einen Modus oder Winkel angibt, der sich auf die Richtung auswirkt. Wenn die Transformationsmatrix des Pinsels so festgelegt ist, dass sie eine andere Transformation als die Identität darstellt, werden die Grenzen und die Richtung während des Renderings entsprechend dieser Matrix transformiert.

Die Transformation gilt nur während des Renderings. Die vom LinearGradientBrush-Objekt gespeicherten Grenzen werden von der LinearGradientBrush::SetTransform-Methode nicht geändert.

Beispiele

Im folgenden Beispiel wird ein linearer Farbverlaufspinsel erstellt und zum Ausfüllen eines Rechtecks verwendet. Als Nächstes ändert der Code die Transformationsmatrix des Pinsels und füllt ein Rechteck mit dem transformierten Pinsel aus.

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

   LinearGradientBrush linGrBrush( 
      Rect(0, 0, 100, 50),
      Color(255, 255, 0, 0),  // red
      Color(255, 0, 0, 255),  // blue
      LinearGradientModeHorizontal);

   Matrix matrix(2.0, 0, 0, 1, 0, 0);  // horizontal doubling

   // Fill a large area with the linear gradient brush (no transformation).
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 800, 50);

   linGrBrush.SetTransform(&matrix);

   // Fill a large area with the transformed linear gradient brush.
   myGraphics.FillRectangle(&linGrBrush, 0, 75, 800, 50);
}

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