QGradient Class

Description détaillée

Qt prend actuellement en charge trois types de remplissage par gradient :

• Les dégradéslinéaires interpolent les couleurs entre les points de départ et d'arrivée.
• Les dégradés radiauxsimples 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 centre et un cercle focal.
• Les dégradésconiques interpolent les couleurs autour d'un point central.

Le type d'un dégradé peut être récupéré à l'aide de la fonction type(). Chaque type est représenté par une sous-classe de QGradient :

QLinearGradient	QRadialGradient	QConicalGradient

Les couleurs d'un dégradé sont définies à l'aide de points d'arrêt du type QGradientStop, c'est-à-dire une position et une couleur. Utilisez la fonction setColorAt() pour définir un seul point d'arrêt. Vous pouvez également utiliser la fonction setStops() pour définir plusieurs points d'arrêt en une seule fois. Notez que cette dernière fonction remplace l' ensemble actuel des points d'arrêt.

C'est l'ensemble des points d'arrêt du dégradé (accessibles via la fonction stops()) 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é.

Un dégradé linéaire diagonal allant du noir à (100, 100) au blanc à (200, 200) pourrait être spécifié comme suit :

QLinearGradient linearGrad(QPointF(100, 100), QPointF(200, 200));
linearGrad.setColorAt(0, Qt::black);
linearGrad.setColorAt(1, Qt::white);

Un dégradé peut avoir un nombre arbitraire de points d'arrêt. L'exemple suivant créerait un dégradé radial commençant par le rouge au centre, puis le bleu et le vert sur les bords :

QRadialGradient radialGrad(QPointF(100, 100), 100);
radialGrad.setColorAt(0, Qt::red);
radialGrad.setColorAt(0.5, Qt::blue);
radialGrad.setColorAt(1, Qt::green);

Il est possible de répéter ou de refléter le dégradé en dehors de sa zone en spécifiant l'adresse spread method à l'aide de la fonction setSpread(). Par défaut, la zone extérieure est remplacée par la couleur du point d'arrêt le plus proche. La fonction spread() permet de récupérer la valeur actuellement définie pour spread method. L'énumération QGradient::Spread définit trois méthodes différentes :

PadSpread	RepeatSpread	ReflectSpread

Notez que la fonction setSpread() n'a d'effet que pour les dégradés linéaires et radiaux. La raison en est que le gradient conique est fermé par définition, c'est-à-dire qu'il remplit tout le cercle de 0 à 360 degrés, alors que la limite d'un gradient radial ou linéaire peut être spécifiée par son rayon ou ses points d'arrêt finaux, respectivement.

Les coordonnées du dégradé peuvent être spécifiées en coordonnées logiques, par rapport aux coordonnées de l'appareil ou par rapport aux coordonnées de la boîte de délimitation de l'objet. L'adresse coordinate mode peut être définie à l'aide de la fonction setCoordinateMode(). La valeur par défaut est LogicalMode, où les coordonnées du gradient sont spécifiées de la même manière que les coordonnées de l'objet. Pour récupérer la valeur actuelle de coordinate mode, utilisez la fonction coordinateMode().