Freigeben über


LinearGradientBrush::SetTransform-Methode (gdiplusbrush.h)

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

Weitere Informationen

Pinsel und gefüllte Formen

Erstellen eines linearen Farbverlaufs

Füllen von Formen mit einem Farbverlaufpinsel

LinearGradientBrush

LinearGradientBrush::GetTransform

LinearGradientBrush::ResetTransform

Matrix

Matrixdarstellung von Transformationen

Rect

Transformationen