LinearGradientBrush::SetBlendBellShape-Methode (gdiplusbrush.h)

Artikel
08/23/2023

Die LinearGradientBrush::SetBlendBellShape-Methode legt die Mischform dieses linearen Farbverlaufspinsels fest, um eine benutzerdefinierte Mischung basierend auf einer glockenförmigen Kurve zu erstellen.

Syntax

Status SetBlendBellShape(
  [in] REAL focus,
  [in] REAL scale
);

Parameter

[in] focus

Typ: REAL

Reelle Zahl, die die Position der Endfarbe angibt. Diese Zahl ist ein Prozentsatz des Abstands zwischen den Begrenzungslinien und muss im Bereich von 0,0 bis 1,0 liegen.

[in] scale

Typ: REAL

Optional. Reelle Zahl, die den Prozentsatz der Endfarbe des Farbverlaufs angibt, der an der Fokusposition mit der Anfangsfarbe des Farbverlaufs gemischt wird. Diese Zahl muss im Bereich von 0,0 bis 1,0 liegen. Der Standardwert ist 1,0, der angibt, dass die Endfarbe die volle Intensität aufweist.

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

Standardmäßig ändert sich die Farbe schrittweise von der Anfangsfarbe (Farbe an der Anfangsgrenze des linearen Farbverlaufspinsels) zur Endfarbe (Farbe an der Endgrenze des linearen Farbverlaufspinsels), wenn Sie von der Anfangsgrenze zur Endgrenze wechseln. Sie können die Positionierung und Das Mischen der Anfangs- und Endfarben anpassen, indem Sie die LinearGradientBrush::SetBlendBellShape-Methode verwenden.

Die LinearGradientBrush::SetBlendBellShape-Methode passt die Mischung so an, dass sie einer glockenförmigen Kurve mit den Extremen der Glockenbasis an den Grenzen des Farbverlaufs folgt. Die Anfangsfarbe, die sich in einer Standardmischung an der Anfangsgrenze eines linearen Farbverlaufspinsels befindet, wird an den Anfangs- und Endgrenzen des linearen Farbverlaufspinsels angezeigt, wenn eine glockenförmige Mischung angewendet wird. Die Position der Endfarbe, die sich in einer Standardmischung an der Endgrenze befindet, befindet sich irgendwo zwischen den Grenzen und wird durch den Wert des Fokus bestimmt. Anders ausgedrückt: Der Fokus gibt die Position der Spitze der Glocke an. Mit einem Fokuswert von 0,7 wird der Spitzenwert beispielsweise auf 70 Prozent des Abstands zwischen den Anfangs- und Endgrenzen festgelegt. Die Endfarbe wird an dieser Spitze angezeigt.

Die endende Farbe in einer glockenförmigen Mischung ist ein Prozentsatz des Farbraums zwischen der Standardmischungs-Startfarbe des Farbverlaufs und der Standardmischungsendfarbe. Angenommen, ein linearer Farbverlaufspinsel wird mit Rot als Startfarbe und Blau als Endfarbe erstellt. Wenn LinearGradientBrush::SetBlendBellShape mit einem Skalierungswert von 0,8 aufgerufen wird, ist die Endfarbe in der glockenförmigen Mischung ein Farbton, der 80 Prozent zwischen Rot und Blau liegt (20 Prozent rot, 80 Prozent blau). Ein Skalierungswert von 1,0 erzeugt eine Endfarbe, die 100 Prozent blau ist.

Beispiele

Im folgenden Beispiel wird ein linearer Farbverlaufspinsel erstellt, eine glockenförmige Mischung festgelegt und der Pinsel verwendet, um ein Rechteck zu füllen. Zweimal mehr legt der Code eine glockenförmige Mischung mit unterschiedlichen Werten fest und verwendet jedes Mal den Pinsel, um ein Rechteck zu füllen.

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

   LinearGradientBrush linGrBrush(
      Point(0, 0),
      Point(500, 0),
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255));  // blue

   linGrBrush.SetBlendBellShape(0.5f, 0.6f);
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 500, 50);

   linGrBrush.SetBlendBellShape(0.5f, 0.8f); 
   myGraphics.FillRectangle(&linGrBrush, 0, 75, 500, 50);

   linGrBrush.SetBlendBellShape(0.5f, 1.0f); 
   myGraphics.FillRectangle(&linGrBrush, 0, 150, 500, 50);
}

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