PathGradientBrush::SetSurroundColors-Methode (gdipluspath.h)

Artikel
08/24/2023

Die PathGradientBrush::SetSurroundColors-Methode legt die Surroundfarben dieses Pfadverlaufspinsels fest. Die Surroundfarben sind Farben, die für diskrete Punkte im Begrenzungspfad des Pinsels angegeben sind.

Syntax

Status SetSurroundColors(
  [in]      const Color *colors,
  [in, out] INT         *count
);

Parameter

[in] colors

Typ: const Color*

Zeiger auf ein Array von Color-Objekten , die die Surroundfarben angeben.

[in, out] count

Typ: INT*

Zeiger auf eine ganze Zahl, die bei der Eingabe die Anzahl von Color-Objekten im Farbarray angibt. Wenn die Methode erfolgreich ist, empfängt dieser Parameter bei der Ausgabe die Anzahl der festgelegten Surroundfarben. Wenn die Methode fehlschlägt, empfängt dieser Parameter keinen Wert.

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 Pfadverlaufspinsel hat einen Begrenzungspfad und einen Mittelpunkt. Der Mittelpunkt ist auf eine einzelne Farbe festgelegt, Sie können jedoch verschiedene Farben für mehrere Punkte an der Grenze angeben. Angenommen, Sie geben rot für die mittlere Farbe an, und Sie geben Blau, Grün und Gelb für unterschiedliche Punkte an der Grenze an. Wenn Sie sich dann entlang der Grenze bewegen, ändert sich die Farbe allmählich von blau zu grün zu gelb und zurück zu blau. Wenn Sie sich entlang einer geraden Linie von einem beliebigen Punkt auf der Grenze zum Mittelpunkt bewegen, ändert sich die Farbe von der Farbe dieses Begrenzungspunkts in Rot.

Beispiele

Im folgenden Beispiel wird ein PathGradientBrush-Objekt basierend auf einem Array von drei Punkten erstellt, das einen dreieckigen Pfad definiert. Der Code initialisiert auch ein Array von drei Color-Objekten . Der Aufruf der PathGradientBrush::SetSurroundColors-Methode ordnet jede Farbe im Farbarray dem entsprechenden (gleichen Index) Punkt im Punktarray zu. Nachdem die Surroundfarben des Pfadverlaufspinsels festgelegt wurden, verwendet die Graphics::FillRectangle-Methode den Pfadverlaufspinsel, um ein Rechteck zu zeichnen, das den dreieckigen Pfad enthält.

Eine Kante des gerenderten Dreiecks wechselt allmählich von Rot zu Grün. Die nächste Kante wechselt allmählich von grün zu schwarz, und der dritte Rand wechselt allmählich von schwarz zu rot. Der Code legt die mittlere Farbe nicht fest, sodass die mittlere Farbe den Standardwert Schwarz aufweist. Wenn Sie sich entlang einer geraden Linie von einem beliebigen Punkt auf dem Begrenzungspfad (Dreieck) zum Mittelpunkt bewegen, ändert sich die Farbe schrittweise von der Farbe dieses Begrenzungspunkts in Schwarz.

VOID Example_SetSurColor(HDC hdc)
{
   Graphics graphics(hdc);

   Point pts[] = {
      Point(20, 20), 
      Point(100, 20), 
      Point(100, 100)};

   Color cols[] = {
      Color(255, 255, 0, 0),  // red
      Color(255, 0, 255, 0),  // green
      Color(255, 0, 0, 0)};   // black

   INT count = 3;
   PathGradientBrush pthGrBrush(pts, 3);
   pthGrBrush.SetSurroundColors(cols, &count);
   
   graphics.FillRectangle(&pthGrBrush, 0, 0, 200, 200);
}

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