Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

QCanvasBoxGradient Class

QCanvasBoxGradient est un pinceau permettant de peindre des dégradés dans des rectangles. En savoir plus...

En-tête : #include <QCanvasBoxGradient>
CMake : find_package(Qt6 REQUIRED COMPONENTS CanvasPainter)
target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter)
Depuis : Qt 6.11
Hérite de : QCanvasGradient

Fonctions publiques

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 &)

Description détaillée

Le dégradé « Box » interpole les couleurs entre les points de départ et d’arrivée, créant ainsi un dégradé en forme de rectangle arrondi. Les fonctions ` setRadius()` et ` setFeather()` permettent de contrôler le degré d’arrondi et la douceur du dégradé.

Quatre carrés présentant des dégradés de couleurs, des rayons de coin et des adoucissements de contours variables, sous forme de rectangles arrondis

Voici un exemple simple :

Carré arrondi bleu foncé, dont les bords sont nimbés d'une lueur jaune pâle
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);

Remarque : lorsque QCanvasBoxGradient est utilisé pour dessiner un rectangle arrondi, il est généralement préférable d’utiliser QCanvasPainter::rect() plutôt que QCanvasPainter::roundRect(), car l’arrondi provient du pinceau plutôt que du tracé. Cela évite de créer des sommets supplémentaires et offre ainsi de meilleures performances.

Documentation des fonctions membres

QCanvasBoxGradient::QCanvasBoxGradient()

Crée un dégradé de cadre par défaut. La position du dégradé est (0, 0) et sa taille (100, 100). L'adoucissement du dégradé est de 10,0. Le rayon du dégradé est de 0,0.

QCanvasBoxGradient::QCanvasBoxGradient(const QRectF &rect)

Crée un dégradé de forme rectangulaire. La position et la taille du dégradé sont définies par rect. L'adoucissement du dégradé est de 10,0 et son rayon est de 0,0.

Voir également setFeather() et setRadius().

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

Crée un dégradé en forme de rectangle. La position du dégradé est ( x, y) et sa taille ( width, height). L'adoucissement du dégradé est de 10,0 et son rayon est de 0,0.

Voir également setFeather() et setRadius().

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

Crée une instance de ` QCanvasBoxGradient` par copie.

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

Crée par « move » une instance de ` QCanvasBoxGradient`.

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

Supprime l'instance de ` QCanvasBoxGradient`.

qreal QCanvasBoxGradient::feather() const

Renvoie l'effacement du dégradé de la boîte.

Voir aussi setFeather().

qreal QCanvasBoxGradient::radius() const

Renvoie le rayon du dégradé de la boîte.

Voir aussi setRadius().

QRectF QCanvasBoxGradient::rect() const

Renvoie l'aire du rectangle correspondant au dégradé de la boîte.

Voir aussi setRect().

void QCanvasBoxGradient::setFeather(qreal feather)

Définit le dégagement du dégradé de la zone sur feather.

Voir également feather().

void QCanvasBoxGradient::setRadius(qreal radius)

Définit le rayon du dégradé de la boîte sur radius. Le rayon maximal correspond à la moitié de la largeur ou de la hauteur de rect(), selon la valeur la plus petite des deux.

Voir également radius().

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

Définit la position ( x, y) et la taille ( width, height) du rectangle du dégradé de la boîte.

Voir également rect().

void QCanvasBoxGradient::setRect(const QRectF &rect)

Définit le rectangle du dégradé de la boîte sur rect.

Il s'agit d'une fonction surchargée.

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

Permute ce dégradé avec celui de other. Cette opération est très rapide et ne pose jamais de problème.

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

Cette opération attribue l'other à cette instance QCanvasBoxGradient.

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

Attribue par copie l'other à cette instance d'QCanvasBoxGradient.

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