Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

QCanvasBoxGradient Class

QCanvasBoxGradient ist ein Pinsel zum Malen von Farbverläufen in Rechtecken. Mehr...

Überschrift: #include <QCanvasBoxGradient>
CMake: find_package(Qt6 REQUIRED COMPONENTS CanvasPainter)
target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter)
Seit: Qt 6.11
Erbt von: QCanvasGradient

Öffentliche Funktionen

QCanvasBoxGradient()
QCanvasBoxGradient(const QRectF &rect)
QCanvasBoxGradient(qreal x, qreal y, qreal width, qreal height)
QCanvasBoxGradient(const QCanvasBoxGradient &)
QCanvasBoxGradient(QCanvasBoxGradient &&)
~QCanvasBoxGradient()
qreal feather() const
qreal radius() const
QRectF rect() const
void setFeather(qreal feather)
void setRadius(qreal radius)
void setRect(qreal x, qreal y, qreal width, qreal height)
void setRect(const QRectF &rect)
void swap(QCanvasBoxGradient &other)
QCanvasBoxGradient &operator=(QCanvasBoxGradient &&)
QCanvasBoxGradient &operator=(const QCanvasBoxGradient &)

Ausführliche Beschreibung

Der Box-Farbverlauf interpoliert Farben zwischen Start- und Endpunkt und erzeugt so einen abgerundeten, rechteckförmigen Farbverlauf. Mit den Methoden „ setRadius()“ und „ setFeather()“ lassen sich die Rundung und die Weichheit des Farbverlaufs steuern.

Vier Quadrate mit Farbverläufen in Form von abgerundeten Rechtecken, die sich in Farbe, Eckenradius und Kantenweichheit unterscheiden

Hier ist ein einfaches Beispiel:

Dunkelblaues, abgerundetes Quadrat mit einem sanften gelben Schimmer an den Rändern
QRectF rect(20, 20, 160, 160);
QCanvasBoxGradient bg(rect);
bg.setFeather(20);
bg.setRadius(50);
bg.setColorAt(0.0, "#1a2a6c");
bg.setColorAt(0.2, "#fdbb2d");
bg.setColorAt(1.0, QColorConstants::Transparent);
p->setFillStyle(bg);
p->fillRect(rect);

Hinweis: Wenn „QCanvasBoxGradient“ zum Zeichnen eines abgerundeten Rechtecks verwendet wird, ist es in der Regel besser, „ QCanvasPainter::rect()“ anstelle von „ QCanvasPainter::roundRect()“ zu verwenden, da die Abrundung vom Pinsel und nicht vom Pfad stammt. Dadurch werden keine zusätzlichen Eckpunkte erzeugt, was zu einer besseren Leistung führt.

Dokumentation der Member-Funktionen

QCanvasBoxGradient::QCanvasBoxGradient()

Erstellt einen Standard-Farbverlauf für ein Feld. Die Position des Farbverlaufs ist (0, 0) und die Größe (100, 100). Die Ausblendung des Farbverlaufs beträgt 10,0. Der Radius des Farbverlaufs beträgt 0,0.

QCanvasBoxGradient::QCanvasBoxGradient(const QRectF &rect)

Erzeugt einen Kasten-Farbverlauf. Position und Größe des Farbverlaufs sind rect. Die Ausblendung des Farbverlaufs beträgt 10,0 und der Radius 0,0.

Siehe auch setFeather() und setRadius().

QCanvasBoxGradient::QCanvasBoxGradient(qreal x, qreal y, qreal width, qreal height)

Erzeugt einen Kasten-Farbverlauf. Die Position des Farbverlaufs lautet ( x, y) und die Größe ( width, height). Die Auslaufstärke des Farbverlaufs beträgt 10,0 und der Radius 0,0.

Siehe auch setFeather() und setRadius().

[constexpr noexcept default] QCanvasBoxGradient::QCanvasBoxGradient(const QCanvasBoxGradient &)

Erstellt eine Instanz von ` QCanvasBoxGradient` durch Kopieren.

[constexpr noexcept default] QCanvasBoxGradient::QCanvasBoxGradient(QCanvasBoxGradient &&)

Erstellt eine Instanz von ` QCanvasBoxGradient` mithilfe von `Move`.

[constexpr noexcept default] QCanvasBoxGradient::~QCanvasBoxGradient()

Löscht die Instanz von „ QCanvasBoxGradient “.

qreal QCanvasBoxGradient::feather() const

Gibt die Auslaufkante des Kastenverlaufs zurück.

Siehe auch „ setFeather()“.

qreal QCanvasBoxGradient::radius() const

Gibt den Radius des Box-Gradienten zurück.

Siehe auch „ setRadius()“.

QRectF QCanvasBoxGradient::rect() const

Gibt die Fläche des rechteckigen Feldes des Box-Farbverlaufs zurück.

Siehe auch „ setRect()“.

void QCanvasBoxGradient::setFeather(qreal feather)

Stellt die Auslaufintensität des Box-Farbverlaufs auf „ feather “ ein.

Siehe auch feather().

void QCanvasBoxGradient::setRadius(qreal radius)

Legt den Radius des Kastenverlaufs auf radius fest. Der maximale Radius beträgt die Hälfte der Breite oder Höhe von rect(), je nachdem, welcher Wert kleiner ist.

Siehe auch ` radius()`.

void QCanvasBoxGradient::setRect(qreal x, qreal y, qreal width, qreal height)

Legt die Position ( x, y) und die Größe ( width, height) des Rechtecks für den Box-Farbverlauf fest.

Siehe auch rect().

void QCanvasBoxGradient::setRect(const QRectF &rect)

Setzt den Farbverlauf des Rechtecks auf „ rect “.

Dies ist eine überladene Funktion.

[noexcept] void QCanvasBoxGradient::swap(QCanvasBoxGradient &other)

Tauscht diesen Farbverlauf mit „ other “ aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

[noexcept default] QCanvasBoxGradient &QCanvasBoxGradient::operator=(QCanvasBoxGradient &&)

other Weist der Instanz „ QCanvasBoxGradient “ die Instanz „ “ zu.

[noexcept default] QCanvasBoxGradient &QCanvasBoxGradient::operator=(const QCanvasBoxGradient &)

other Weist dieser Instanz von „ QCanvasBoxGradient “ die Werte von „ “ zu. an diese Instanz von „ “ zu.

© 2026 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.