QCanvasBoxGradient Class

QCanvasBoxGradient est une brosse pour peindre des dégradés. 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 :	QCanvasGradient
Statut :	Technical Preview

Liste de tous les membres, y compris les membres hérités

Fonctions publiques

	QCanvasBoxGradient()
	QCanvasBoxGradient(const QRectF &rect, float feather, float radius = 0.0f)
	QCanvasBoxGradient(float x, float y, float width, float height, float feather, float radius = 0.0f)
float	feather() const
float	radius() const
QRectF	rect() const
void	setFeather(float feather)
void	setRadius(float radius)
void	setRect(float x, float y, float width, float height)
void	setRect(const QRectF &rect)

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 l'arrondi et la douceur du dégradé.

Voici un exemple simple :

QRectF rect(20, 20, 160, 160);
QCanvasBoxGradient bg(rect, 20, 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 peindre 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 chemin. Cela évite de créer des sommets supplémentaires et donne donc de meilleurs résultats.

Documentation des fonctions membres

QCanvasBoxGradient::QCanvasBoxGradient()

Construit un dégradé de boîte par défaut. La position du dégradé est (0, 0) et la taille (100, 100). L'épaisseur du dégradé est de 10,0. Le rayon du dégradé est de 0,0. La couleur de départ du dégradé est le blanc (255, 255, 255) et la couleur de fin est le noir transparent (0, 0, 0, 0).

QCanvasBoxGradient::QCanvasBoxGradient(const QRectF &rect, float feather, float radius = 0.0f)

Construit un dégradé de boîtes. La position et la taille du dégradé sont définies à l'adresse rect. L'épaisseur du dégradé est de feather. Le rayon du dégradé est radius. La couleur de départ du dégradé est le blanc (255, 255, 255) et la couleur de fin est le noir transparent (0, 0, 0, 0).

QCanvasBoxGradient::QCanvasBoxGradient(float x, float y, float width, float height, float feather, float radius = 0.0f)

Construit un dégradé de boîte. La position du dégradé est ( x, y) et la taille ( width, height) La plume du dégradé est feather. Le rayon du dégradé est radius. La couleur de départ du dégradé est le blanc (255, 255, 255) et la couleur de fin est le noir transparent (0, 0, 0, 0).

float QCanvasBoxGradient::feather() const

Renvoie la plume du dégradé de la boîte.

Voir également setFeather().

float QCanvasBoxGradient::radius() const

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

Voir également setRadius().

QRectF QCanvasBoxGradient::rect() const

Renvoie la surface du rectangle du dégradé de la boîte.

Voir également setRect().

void QCanvasBoxGradient::setFeather(float feather)

Définit la plume du dégradé de la boîte à feather.

Voir également feather().

void QCanvasBoxGradient::setRadius(float radius)

Définit le rayon du dégradé de la boîte à radius. Le rayon maximum est la moitié de la largeur ou de la hauteur de rect(), selon ce qui est le plus petit.

Voir également radius().

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

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

Voir aussi rect().

void QCanvasBoxGradient::setRect(const QRectF &rect)

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

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

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