QGradient Class

Ausführliche Beschreibung

Qt unterstützt derzeit drei Arten von Farbverlaufsfüllungen:

• Lineare Farbverläufe interpolieren Farben zwischen Start- und Endpunkt.
• Einfache radiale Farbverläufe interpolieren Farben zwischen einem Mittelpunkt und Endpunkten auf einem ihn umgebenden Kreis.
• Erweiterte radiale Farbverläufe interpolieren Farben zwischen einem Mittelpunkt und einem Fokuskreis.
• Konische Farbverläufe interpolieren Farben um einen Mittelpunkt herum.

Der Typ eines Farbverlaufs kann mithilfe der Funktion ` type()` abgerufen werden. Jeder der Typen wird durch eine Unterklasse von `QGradient` repräsentiert:

QLinearGradient	QRadialGradient	QConicalGradient

Die Farben in einem Farbverlauf werden mithilfe von Haltepunkten vom Typ ` QGradientStop ` definiert, d. h. einer Position und einer Farbe. Verwenden Sie die Funktion ` setColorAt()` (), um einen einzelnen Haltepunkt zu definieren. Alternativ können Sie die Funktion ` setStops()` () verwenden, um mehrere Haltepunkte auf einmal zu definieren. Beachten Sie, dass die letztgenannte Funktion den aktuellen Satz von Haltepunkten ersetzt.

Es ist der vollständige Satz von Haltepunkten des Farbverlaufs (abrufbar über die Funktion ` stops()`), der beschreibt, wie der Farbverlaufsbereich gefüllt werden soll. Wenn keine Haltepunkte angegeben wurden, wird ein Farbverlauf von Schwarz bei 0 bis Weiß bei 1 verwendet.

Ein diagonaler linearer Farbverlauf von Schwarz bei (100, 100) nach Weiß bei (200, 200) könnte wie folgt festgelegt werden:

QLinearGradient linearGrad(QPointF(100, 100), QPointF(200, 200));
linearGrad.setColorAt(0, Qt::black);
linearGrad.setColorAt(1, Qt::white);

Ein Farbverlauf kann eine beliebige Anzahl von Haltepunkten haben. Der folgende Code würde einen radialen Farbverlauf erzeugen, der in der Mitte mit Rot beginnt, dann in Blau übergeht und an den Rändern in Grün endet:

QRadialGradient radialGrad(QPointF(100, 100), 100);
radialGrad.setColorAt(0, Qt::red);
radialGrad.setColorAt(0.5, Qt::blue);
radialGrad.setColorAt(1, Qt::green);

Es ist möglich, den Farbverlauf außerhalb seines Bereichs zu wiederholen oder zu spiegeln, indem die „ spread method “ mithilfe der Funktion „ setSpread()“ festgelegt wird. Standardmäßig wird der Außenbereich mit der Farbe des nächstgelegenen Haltepunkts aufgefüllt. Die aktuell eingestellte „ spread method “ kann mit der Funktion „ spread()“ abgerufen werden. Die Enumeration „ QGradient::Spread “ definiert drei verschiedene Methoden:

PadSpread	RepeatSpread	ReflectSpread

Beachten Sie, dass die Funktion „ setSpread()“ nur bei linearen und radialen Farbverläufen wirksam ist. Der Grund dafür ist, dass der konische Farbverlauf per Definition geschlossen ist, d. h., der konische Farbverlauf füllt den gesamten Kreis von 0 bis 360 Grad aus, während die Begrenzung eines radialen oder linearen Farbverlaufs durch dessen Radius bzw. die Endpunkte festgelegt werden kann.

Die Gradientenkoordinaten können in logischen Koordinaten, relativ zu den Gerätekoordinaten oder relativ zu den Koordinaten des Begrenzungsrahmens des Objekts angegeben werden. Die „ coordinate mode “ können mit der Funktion „ setCoordinateMode()“ festgelegt werden. Die Standardeinstellung ist „ LogicalMode “, wobei die Gradientenkoordinaten auf dieselbe Weise wie die Objektkoordinaten angegeben werden. Um die aktuell eingestellten „ coordinate mode “ abzurufen, verwenden Sie „ coordinateMode()“.