Sur cette page

QRadialGradient Class

La classe QRadialGradient est utilisée en combinaison avec QBrush pour spécifier un pinceau à dégradé radial. Plus d'informations...

En-tête : #include <QRadialGradient>
CMake : find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake : QT += gui
Héritages : QGradient

Fonctions publiques

QRadialGradient()
QRadialGradient(const QPointF &center, qreal radius)
QRadialGradient(const QPointF &center, qreal radius, const QPointF &focalPoint)
QRadialGradient(qreal cx, qreal cy, qreal radius)
QRadialGradient(const QPointF &center, 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 &center)
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)

Description détaillée

Qt prend en charge les dégradés radiaux simples et étendus.

Les dégradés radiaux simples interpolent les couleurs entre un point focal et les points d'extrémité d'un cercle qui l'entoure. Les dégradés radiaux étendus interpolent les couleurs entre un cercle focal et un cercle central. Les points situés à l'extérieur du cône défini par les deux cercles seront transparents. Pour les dégradés radiaux simples, le point focal est ajusté pour se situer à l'intérieur du cercle central, alors que le point focal peut avoir n'importe quelle position dans un dégradé radial étendu.

En dehors des points d'extrémité, le dégradé est soit complété, soit réfléchi, soit répété, en fonction de la méthode actuellement définie sur spread:

Les couleurs d'un dégradé sont définies à l'aide de points d'arrêt de type QGradientStop, c'est-à-dire une position et une couleur. Utilisez la fonction QGradient::setColorAt() ou QGradient::setStops() pour définir les points d'arrêt. C'est l'ensemble des points d'arrêt du dégradé qui décrit la manière dont la zone de dégradé doit être remplie. Si aucun point d'arrêt n'a été spécifié, un dégradé allant du noir à 0 au blanc à 1 est utilisé.

Outre les fonctions héritées de QGradient, la classe QRadialGradient fournit les fonctions center(), focalPoint() et radius() qui renvoient respectivement le centre, le point focal et le rayon du dégradé.

Voir également QLinearGradient, QConicalGradient, et l'exemple des gradients.

Documentation des fonctions membres

QRadialGradient::QRadialGradient()

Construit un gradient radial simple dont le centre et le point focal sont situés à (0, 0) avec un rayon de 1.

QRadialGradient::QRadialGradient(const QPointF &center, qreal radius)

Construit un gradient radial simple avec les données center, radius et le point focal au centre du cercle.

Voir aussi QGradient::setColorAt() et QGradient::setStops().

QRadialGradient::QRadialGradient(const QPointF &center, qreal radius, const QPointF &focalPoint)

Construit un gradient radial simple avec les données center, radius et focalPoint.

Remarque : si le point focal donné se trouve en dehors du cercle défini par le point center et radius, il sera réajusté pour se situer à un point du cercle où il croise la ligne allant de center à focalPoint.

Voir également QGradient::setColorAt() et QGradient::setStops().

QRadialGradient::QRadialGradient(qreal cx, qreal cy, qreal radius)

Construit un gradient radial simple dont le centre est situé à (cx, cy) et le point spécifié à radius. Le point focal se trouve au centre du cercle.

Voir aussi QGradient::setColorAt() et QGradient::setStops().

QRadialGradient::QRadialGradient(const QPointF &center, qreal centerRadius, const QPointF &focalPoint, qreal focalRadius)

Construit un gradient radial étendu avec les données center, centerRadius, focalPoint, et focalRadius.

QRadialGradient::QRadialGradient(qreal cx, qreal cy, qreal radius, qreal fx, qreal fy)

Construit un gradient radial simple avec le centre (cx, cy), radius et le point focal (fx, fy).

Remarque : si le point focal donné se trouve en dehors du cercle défini par le centre (cx, cy) et radius, il sera réajusté à l'intersection entre la ligne reliant le centre au point focal et le cercle.

Voir également QGradient::setColorAt() et QGradient::setStops().

QRadialGradient::QRadialGradient(qreal cx, qreal cy, qreal centerRadius, qreal fx, qreal fy, qreal focalRadius)

Construit un gradient radial étendu avec le centre (cx, cy), le rayon du centre, centerRadius, le point focal, (fx, fy), et le rayon focal focalRadius.

QPointF QRadialGradient::center() const

Renvoie le centre de ce gradient radial en coordonnées logiques.

Voir aussi setCenter() et QGradient::stops().

qreal QRadialGradient::centerRadius() const

Renvoie le rayon central de ce gradient radial en coordonnées logiques.

Voir aussi setCenterRadius() et QGradient::stops().

QPointF QRadialGradient::focalPoint() const

Renvoie le point focal de ce gradient radial en coordonnées logiques.

Voir aussi setFocalPoint() et QGradient::stops().

qreal QRadialGradient::focalRadius() const

Renvoie le rayon focal de ce gradient radial en coordonnées logiques.

Voir aussi setFocalRadius() et QGradient::stops().

qreal QRadialGradient::radius() const

Renvoie le rayon de ce gradient radial en coordonnées logiques.

Équivalent à centerRadius()

Voir aussi setRadius() et QGradient::stops().

void QRadialGradient::setCenter(const QPointF &center)

Fixe le centre de ce gradient radial en coordonnées logiques à center.

Voir aussi center().

void QRadialGradient::setCenter(qreal x, qreal y)

Fixe le centre de ce gradient radial en coordonnées logiques à (x, y).

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

Voir aussi center().

void QRadialGradient::setCenterRadius(qreal radius)

Définit le rayon central de ce gradient radial en coordonnées logiques à radius

Voir aussi centerRadius().

void QRadialGradient::setFocalPoint(const QPointF &focalPoint)

Fixe le point focal de ce gradient radial en coordonnées logiques à focalPoint.

Voir également focalPoint().

void QRadialGradient::setFocalPoint(qreal x, qreal y)

Définit le point focal de ce gradient radial en coordonnées logiques à (x, y).

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

Voir aussi focalPoint().

void QRadialGradient::setFocalRadius(qreal radius)

Définit le rayon focal de ce gradient radial en coordonnées logiques à radius

Voir aussi focalRadius().

void QRadialGradient::setRadius(qreal radius)

Définit le rayon de ce gradient radial en coordonnées logiques à radius

Équivalent à setCenterRadius()

Voir aussi radius().

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