QGradient Class

Detaillierte Beschreibung

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

• Lineare Farbverläufe interpolieren Farben zwischen Start- und Endpunkten.
• Einfache radiale Farbverläufe interpolieren Farben zwischen einem Fokuspunkt 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 mit der Funktion type() abgerufen werden. Jeder der Typen wird durch eine Unterklasse von QGradient dargestellt:

QLinearGradient	QRadialGradient	QConicalGradient

Die Farben in einem Farbverlauf werden durch Haltepunkte des Typs QGradientStop definiert, d. h. durch eine Position und eine Farbe. Verwenden Sie die Funktion setColorAt(), um einen einzelnen Haltepunkt zu definieren. Alternativ können Sie auch 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 Gradienten (zugänglich über die Funktion stops()), der beschreibt, wie der Gradientenbereich gefüllt werden soll. Wenn keine Haltepunkte angegeben wurden, wird ein Farbverlauf von Schwarz bei 0 bis Weiß bei 1 verwendet.

Ein diagonaler linearer Verlauf von Schwarz bei (100, 100) bis Weiß bei (200, 200) könnte so angegeben 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. Die folgende Darstellung würde einen radialen Farbverlauf erzeugen, der in der Mitte mit Rot beginnt und an den Rändern in Blau und Grün übergeht:

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 man spread method mit der Funktion setSpread() angibt. 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() abgefragt werden. Das QGradient::Spread enum definiert drei verschiedene Methoden:

PadSpread	RepeatSpread	ReflectSpread

Beachten Sie, dass die Funktion setSpread() nur für lineare und radiale Farbverläufe wirksam ist. Der Grund dafür ist, dass der konische Gradient per Definition geschlossen ist, d. h. der konische Gradient füllt den gesamten Kreis von 0 - 360 Grad aus, während die Grenze eines radialen oder linearen Gradienten durch seinen Radius bzw. seine Endpunkte angegeben werden kann.

Die Gradientenkoordinaten können in logischen Koordinaten, relativ zu den Gerätekoordinaten oder relativ zu den Bounding-Box-Koordinaten des Objekts angegeben werden. Die coordinate mode kann mit der Funktion setCoordinateMode() festgelegt werden. Die Vorgabe ist LogicalMode, wobei die Gradientenkoordinaten auf die gleiche Weise wie die Objektkoordinaten angegeben werden. Um die aktuell eingestellte coordinate mode abzurufen, verwenden Sie coordinateMode().