QRadialGradient Class
Die Klasse QRadialGradient wird in Kombination mit QBrush verwendet, um einen radialen Farbverlaufspinsel zu spezifizieren. Mehr...
Kopfzeile: | #include <QRadialGradient> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
qmake: | QT += gui |
Vererbt: | QGradient |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QRadialGradient ist Teil von Painting Classes.
Öffentliche Funktionen
QRadialGradient() | |
QRadialGradient(const QPointF ¢er, qreal radius) | |
QRadialGradient(const QPointF ¢er, qreal radius, const QPointF &focalPoint) | |
QRadialGradient(qreal cx, qreal cy, qreal radius) | |
QRadialGradient(const QPointF ¢er, qreal centerRadius, const QPointF &focalPoint, qreal focalRadius) | |
QRadialGradient(qreal cx, qreal cy, qreal radius, qreal fx, qreal fy) | |
QRadialGradient(qreal cx, qreal cy, qreal centerRadius, qreal fx, qreal fy, qreal focalRadius) | |
QPointF | center() const |
qreal | centerRadius() const |
QPointF | focalPoint() const |
qreal | focalRadius() const |
qreal | radius() const |
void | setCenter(const QPointF ¢er) |
void | setCenter(qreal x, qreal y) |
void | setCenterRadius(qreal radius) |
void | setFocalPoint(const QPointF &focalPoint) |
void | setFocalPoint(qreal x, qreal y) |
void | setFocalRadius(qreal radius) |
void | setRadius(qreal radius) |
Detaillierte Beschreibung
Qt unterstützt sowohl einfache als auch erweiterte radiale Farbverläufe.
Einfache radiale Farbverläufe interpolieren Farben zwischen einem Fokuspunkt und Endpunkten auf einem ihn umgebenden Kreis. Erweiterte radiale Farbverläufe interpolieren Farben zwischen einem Fokuskreis und einem Zentralkreis. Punkte außerhalb des Kegels, der durch die beiden Kreise definiert wird, sind transparent. Bei einfachen radialen Farbverläufen wird der Brennpunkt so eingestellt, dass er innerhalb des Mittelkreises liegt, während der Brennpunkt in einem erweiterten radialen Farbverlauf eine beliebige Position einnehmen kann.
Außerhalb der Endpunkte wird der Farbverlauf je nach der aktuell eingestellten Methode spread entweder aufgefüllt, gespiegelt oder wiederholt:
![]() | ![]() | ![]() |
PadSpread (Standard) | ReflectSpread | RepeatSpread |
Die Farben in einem Farbverlauf werden mit Hilfe von Haltepunkten des Typs QGradientStop definiert, d.h. mit einer Position und einer Farbe. Verwenden Sie die Funktion QGradient::setColorAt() oder QGradient::setStops(), um die Haltepunkte zu definieren. Der komplette Satz von Haltepunkten des Farbverlaufs beschreibt, wie der Bereich des Farbverlaufs gefüllt werden soll. Wenn keine Haltepunkte angegeben wurden, wird ein Farbverlauf von Schwarz bei 0 bis Weiß bei 1 verwendet.
Zusätzlich zu den von QGradient geerbten Funktionen bietet die Klasse QRadialGradient die Funktionen center(), focalPoint() und radius(), die den Mittelpunkt, den Brennpunkt bzw. den Radius des Farbverlaufs zurückgeben.
Siehe auch QLinearGradient, QConicalGradient, und Das Gradienten-Beispiel.
Dokumentation der Mitgliedsfunktionen
QRadialGradient::QRadialGradient()
Konstruiert einen einfachen radialen Gradienten mit dem Zentrum und dem Brennpunkt bei (0, 0) und einem Radius von 1.
QRadialGradient::QRadialGradient(const QPointF ¢er, qreal radius)
Konstruiert einen einfachen radialen Farbverlauf mit dem angegebenen center, radius und dem Brennpunkt in der Kreismitte.
Siehe auch QGradient::setColorAt() und QGradient::setStops().
QRadialGradient::QRadialGradient(const QPointF ¢er, qreal radius, const QPointF &focalPoint)
Konstruiert einen einfachen radialen Gradienten mit den gegebenen center, radius und focalPoint.
Hinweis: Wenn der angegebene Brennpunkt außerhalb des Kreises liegt, der durch den Punkt center und radius definiert ist, wird er so angepasst, dass er an einem Punkt auf dem Kreis liegt, an dem er sich mit der Linie von center nach focalPoint kreuzt.
Siehe auch QGradient::setColorAt() und QGradient::setStops().
QRadialGradient::QRadialGradient(qreal cx, qreal cy, qreal radius)
Konstruiert einen einfachen radialen Gradienten mit dem Mittelpunkt bei (cx, cy) und dem angegebenen radius. Der Brennpunkt liegt in der Mitte des Kreises.
Siehe auch QGradient::setColorAt() und QGradient::setStops().
QRadialGradient::QRadialGradient(const QPointF ¢er, qreal centerRadius, const QPointF &focalPoint, qreal focalRadius)
Konstruiert einen erweiterten radialen Gradienten mit den gegebenen center, centerRadius, focalPoint und focalRadius.
QRadialGradient::QRadialGradient(qreal cx, qreal cy, qreal radius, qreal fx, qreal fy)
Konstruiert einen einfachen radialen Gradienten mit dem angegebenen Zentrum (cx, cy), radius und dem Brennpunkt (fx, fy).
Hinweis: Wenn der angegebene Brennpunkt außerhalb des Kreises liegt, der durch den Mittelpunkt (cx, cy) und radius definiert ist, wird er auf den Schnittpunkt zwischen der Linie vom Mittelpunkt zum Brennpunkt und dem Kreis neu angepasst.
Siehe auch QGradient::setColorAt() und QGradient::setStops().
QRadialGradient::QRadialGradient(qreal cx, qreal cy, qreal centerRadius, qreal fx, qreal fy, qreal focalRadius)
Konstruiert einen erweiterten radialen Gradienten mit dem angegebenen Zentrum (cx, cy), dem Zentrumsradius, centerRadius, dem Brennpunkt, (fx, fy), und dem Brennradius focalRadius.
QPointF QRadialGradient::center() const
Gibt den Mittelpunkt dieses radialen Gradienten in logischen Koordinaten zurück.
Siehe auch setCenter() und QGradient::stops().
qreal QRadialGradient::centerRadius() const
Gibt den mittleren Radius dieses radialen Gradienten in logischen Koordinaten zurück.
Siehe auch setCenterRadius() und QGradient::stops().
QPointF QRadialGradient::focalPoint() const
Gibt den Brennpunkt dieses radialen Gradienten in logischen Koordinaten zurück.
Siehe auch setFocalPoint() und QGradient::stops().
qreal QRadialGradient::focalRadius() const
Gibt den Fokusradius dieses radialen Gradienten in logischen Koordinaten zurück.
Siehe auch setFocalRadius() und QGradient::stops().
qreal QRadialGradient::radius() const
Gibt den Radius dieses radialen Gradienten in logischen Koordinaten zurück.
Äquivalent zu centerRadius()
Siehe auch setRadius() und QGradient::stops().
void QRadialGradient::setCenter(const QPointF ¢er)
Setzt den Mittelpunkt dieses radialen Gradienten in logischen Koordinaten auf center.
Siehe auch center().
void QRadialGradient::setCenter(qreal x, qreal y)
Dies ist eine überladene Funktion.
Setzt den Mittelpunkt dieses radialen Gradienten in logischen Koordinaten auf (x, y).
Siehe auch center().
void QRadialGradient::setCenterRadius(qreal radius)
Setzt den mittleren Radius dieses radialen Gradienten in logischen Koordinaten auf radius
Siehe auch centerRadius().
void QRadialGradient::setFocalPoint(const QPointF &focalPoint)
Setzt den Brennpunkt dieses radialen Gradienten in logischen Koordinaten auf focalPoint.
Siehe auch focalPoint().
void QRadialGradient::setFocalPoint(qreal x, qreal y)
Dies ist eine überladene Funktion.
Setzt den Brennpunkt dieses radialen Gradienten in logischen Koordinaten auf (x, y).
Siehe auch focalPoint().
void QRadialGradient::setFocalRadius(qreal radius)
Setzt den Fokusradius dieses radialen Gradienten in logischen Koordinaten auf radius
Siehe auch focalRadius().
void QRadialGradient::setRadius(qreal radius)
Setzt den Radius dieses radialen Gradienten in logischen Koordinaten auf radius
Äquivalent zu setCenterRadius()
Siehe auch radius().
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.