LinearGradientBrush::LinearGradientBrush(constPointF&,constPointF&,constColor&,constColor&)-Methode (gdiplusbrush.h)

  • Artikel

Erstellt ein LinearGradientBrush::LinearGradientBrush-Objekt aus einer Reihe von Begrenzungspunkten und Begrenzungsfarben.

Syntax

void LinearGradientBrush(
  [in, ref] const PointF & point1,
  [in, ref] const PointF & point2,
  [in, ref] const Color &  color1,
  [in, ref] const Color &  color2
);

Parameter

[in, ref] point1

Typ: const PointF

Verweis auf ein Point-Objekt , das den Ausgangspunkt des Farbverlaufs angibt. Die Anfangsbegrenzungslinie durchläuft den Startpunkt.

[in, ref] point2

Typ: const PointF

Verweis auf ein Point-Objekt , das den Endpunkt des Farbverlaufs angibt. Die endende Begrenzungslinie durchläuft den Endpunkt.

[in, ref] color1

Typ: const Color

Verweis auf ein Color-Objekt , das die Farbe an der Anfangsbegrenzungslinie dieses linearen Farbverlaufpinsels angibt.

[in, ref] color2

Typ: const Color

Verweis auf ein Color-Objekt , das die Farbe an der endenden Begrenzungslinie dieses linearen Farbverlaufpinsels angibt.

Rückgabewert

Keine

Bemerkungen

Die "Richtungslinie", eine imaginäre gerade Linie, wird durch den Startpunkt Punkt1 und den Endpunkt Punkt2 definiert. Die Anfangsgrenze des Farbverlaufs ist eine gerade Linie, die senkrecht zur Richtungslinie steht und den Ausgangspunkt durchläuft. Die Endgrenze des Farbverlaufs ist eine gerade Linie, die parallel zur Anfangsbegrenzungslinie verläuft und den Endpunkt durchläuft. Die Farbverlaufsfarbe ist entlang von Linien konstant, die parallel zu den Begrenzungslinien sind. Der Farbverlauf wechselt allmählich von der Startfarbe zur Endfarbe entlang der Richtungslinie.

Beispiele

Im folgenden Beispiel wird ein linearer Farbverlaufpinsel aus einer Reihe von Begrenzungspunkten und Begrenzungsfarben erstellt. Der Code verwendet dann den Pinsel, um das Innere eines Rechtecks zu zeichnen.

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

   LinearGradientBrush linGrBrush(
      PointF(0.8f, 1.6f),
      PointF(3.0f, 2.4f),
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255));  // blue

   myGraphics.SetPageUnit(UnitInch);
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 4, 3); 
}

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

Farbe

LinearGradientBrush

Rect