QRadialGradient Class

La classe QRadialGradient s'utilise en association avec la méthode QBrush pour définir un pinceau à dégradé radial. En savoir plus...

En-tête :	`#include <QRadialGradient>`

CMake :	`find_package(Qt6 REQUIRED COMPONENTS Gui)` `target_link_libraries(mytarget PRIVATE Qt6::Gui)`
qmake :	`QT += gui`
Hérite de :	QGradient

Liste de tous les membres, y compris les membres hérités
QRadialGradient fait partie des classes de peinture.

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 à la fois les dégradés radiaux simples et étendus.

Les dégradés radiaux simples interpolent les couleurs entre un point focal et des points d’extrémité situés sur 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é de manière à se trouver à l’intérieur du cercle central, tandis que dans un dégradé radial étendu, le point focal peut occuper n’importe quelle position.

En dehors des points d’extrémité, le dégradé est soit complété, soit inversé, soit répété, selon la méthode d’ spread e actuellement définie :


PadSpread (par défaut)	ReflectSpread	RepeatSpread

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 complet des points d’arrêt du dégradé qui décrit comment la zone du 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 « The Gradients ».

Documentation des fonctions membres

QRadialGradient::QRadialGradient()

Crée un dégradé radial simple dont le centre et le point focal sont situés en (0, 0) et dont le rayon est égal à 1.

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

Crée un dégradé radial simple à partir des paramètres center et radius fournis, avec le point focal situé au centre du cercle.

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

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

Crée un dégradé radial simple à partir des points de départ center, radius et focalPoint.

Remarque : si le point focal fourni se trouve en dehors du cercle défini par le point center et radius, il sera réajusté pour se situer sur le cercle, à l'intersection de celui-ci avec la droite reliant center à focalPoint.

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

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

Crée un dégradé radial simple dont le centre est situé à (cx, cy) et dont l'radius est spécifiée. Le point focal se trouve au centre du cercle.

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

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

Crée un dégradé radial étendu à partir des valeurs suivantes : center, centerRadius, focalPoint et focalRadius.

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

Crée un dégradé radial simple avec le centre (cx, cy), radius et le point focal (fx, fy) indiqués.

Remarque : si le point focal donné se trouve en dehors du cercle défini par le centre (cx, cy) et le radius, il sera réajusté à l'intersection entre la droite 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)

Crée un dégradé radial étendu avec le centre donné (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 dégradé radial en coordonnées logiques.

Voir également setCenter() et QGradient::stops().

qreal QRadialGradient::centerRadius() const

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

Voir également setCenterRadius() et QGradient::stops().

QPointF QRadialGradient::focalPoint() const

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

Voir également setFocalPoint() et QGradient::stops().

qreal QRadialGradient::focalRadius() const

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

Voir également setFocalRadius() et QGradient::stops().

qreal QRadialGradient::radius() const

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

Équivalent à centerRadius()

Voir également setRadius() et QGradient::stops().

void QRadialGradient::setCenter(const QPointF &center)

Définit le centre de ce dégradé radial en coordonnées logiques à l'adresse center.

Voir également center().

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

Définit le centre de ce dégradé radial en coordonnées logiques sur (x, y).

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

Voir également center().

void QRadialGradient::setCenterRadius(qreal radius)

Définit le rayon central de ce dégradé radial en coordonnées logiques sur radius

Voir aussi centerRadius().

void QRadialGradient::setFocalPoint(const QPointF &focalPoint)

Définit le point focal de ce dégradé radial en coordonnées logiques à focalPoint.

Voir également focalPoint().

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

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

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

Voir également focalPoint().

void QRadialGradient::setFocalRadius(qreal radius)

Définit le rayon focal de ce dégradé radial en coordonnées logiques sur radius

Voir également focalRadius().

void QRadialGradient::setRadius(qreal radius)

Définit le rayon de ce dégradé radial en coordonnées logiques sur radius

Équivalent à setCenterRadius()

Voir également 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.