QGradient Class

Description détaillée

Qt prend actuellement en charge trois types de remplissages en dégradé :

• 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é situés sur 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()`. Chacun de ces types 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 de 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 de points d’arrêt.

C’est l’ensemble complet des points d’arrêt du dégradé (accessible via la fonction stops()) qui décrit comment 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 en (100, 100) au blanc en (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 comporter un nombre arbitraire de points d'arrêt. Le code suivant créerait un dégradé radial commençant par du rouge au centre, puis du bleu et enfin du 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’ spread method à l’aide de la fonction setSpread(). Par défaut, la zone extérieure est remplie avec la couleur du point d’arrêt le plus proche. L’ spread method, actuellement défini, peut être récupéré à l’aide de la fonction spread(). L’énumération QGradient::Spread définit trois méthodes différentes :

PadSpread	RepeatSpread	ReflectSpread

Notez que la fonction ` setSpread()` ne s’applique qu’aux dégradés linéaires et radiaux. En effet, le dégradé conique est fermé par définition, c’est-à-dire qu’il remplit l’intégralité du cercle de 0 à 360 degrés, tandis que la limite d’un dégradé radial ou linéaire peut être spécifiée respectivement par son rayon ou ses points d’arrêt finaux.

Les coordonnées du dégradé peuvent être spécifiées en coordonnées logiques, par rapport aux coordonnées du périphérique ou par rapport aux coordonnées du cadre de délimitation de l’objet. L’ coordinate mode peut être défini à l’aide de la fonction setCoordinateMode(). La valeur par défaut est LogicalMode, où les coordonnées du dégradé sont spécifiées de la même manière que les coordonnées de l’objet. Pour récupérer l’ coordinate mode actuellement défini, utilisez coordinateMode().