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

QCanvasLinearGradient Class

QCanvasLinearGradient est un pinceau permettant de peindre des dégradés linéaires. En savoir plus...

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

Fonctions publiques

QCanvasLinearGradient()
QCanvasLinearGradient(QPointF start, QPointF end)
QCanvasLinearGradient(qreal startX, qreal startY, qreal endX, qreal endY)
QCanvasLinearGradient(const QCanvasLinearGradient &)
QCanvasLinearGradient(QCanvasLinearGradient &&)
~QCanvasLinearGradient()
QPointF endPosition() const
void setEndPosition(qreal x, qreal y)
void setEndPosition(QPointF end)
void setStartPosition(qreal x, qreal y)
void setStartPosition(QPointF start)
QPointF startPosition() const
void swap(QCanvasLinearGradient &other)
QCanvasLinearGradient &operator=(QCanvasLinearGradient &&)
QCanvasLinearGradient &operator=(const QCanvasLinearGradient &)

Description détaillée

Le dégradé linéaire interpole les couleurs entre les points de départ et d'arrivée selon un motif linéaire, c'est-à-dire horizontalement, verticalement ou en diagonale. Le dégradé commence à l'adresse startPosition() et se termine à l'adresse endPosition(). En dehors de cette zone, les couleurs sont respectivement la couleur de départ et la couleur d'arrivée.

Quatre carrés présentant des dégradés linéaires s'étendant verticalement, horizontalement, en diagonale et sous forme de bandes de couleur horizontales

Voici un exemple simple :

Carré présentant un dégradé linéaire en diagonale allant du bleu au rouge puis au jaune
QRectF rect1(0, 0, 200, 200);
QCanvasLinearGradient lg(rect1.topLeft(),
                    rect1.bottomRight());
lg.setColorAt(0.0, "#1a2a6c");
lg.setColorAt(0.5, "#b21f1f");
lg.setColorAt(1.0, "#fdbb2d");
p->setFillStyle(lg);
p->fillRect(rect1);

Documentation des fonctions membres

QCanvasLinearGradient::QCanvasLinearGradient()

Crée un dégradé linéaire par défaut. La position de la couleur de départ du dégradé est (0, 0) et celle de la couleur de fin (0, 100).

QCanvasLinearGradient::QCanvasLinearGradient(QPointF start, QPointF end)

Crée un dégradé linéaire. La position de la couleur de départ du dégradé est start et celle de la couleur de fin end.

QCanvasLinearGradient::QCanvasLinearGradient(qreal startX, qreal startY, qreal endX, qreal endY)

Crée un dégradé linéaire. La position de la couleur de départ du dégradé est (startX, startY) et celle de la couleur de fin (endX, endY).

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

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

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

Crée par construction une instance de ` QCanvasLinearGradient`.

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

Supprime l'instance de ` QCanvasLinearGradient`.

QPointF QCanvasLinearGradient::endPosition() const

Renvoie le point final d'un dégradé linéaire.

Voir aussi setEndPosition().

void QCanvasLinearGradient::setEndPosition(qreal x, qreal y)

Définit le point final du dégradé linéaire sur ( x, y).

Voir également endPosition().

void QCanvasLinearGradient::setEndPosition(QPointF end)

Définit le point final du dégradé linéaire sur end.

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

void QCanvasLinearGradient::setStartPosition(qreal x, qreal y)

Définit le point de départ du dégradé linéaire sur ( x, y).

Voir également startPosition().

void QCanvasLinearGradient::setStartPosition(QPointF start)

Définit le point de départ du dégradé linéaire sur start.

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

QPointF QCanvasLinearGradient::startPosition() const

Renvoie le point de départ d'un dégradé linéaire.

Voir aussi setStartPosition().

[noexcept] void QCanvasLinearGradient::swap(QCanvasLinearGradient &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] QCanvasLinearGradient &QCanvasLinearGradient::operator=(QCanvasLinearGradient &&)

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

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

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

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