Sur cette page

QColorAxis Class

La classe QColorAxis affiche une échelle de couleurs sur l'un des axes du graphique. En savoir plus…

Header: #include <QColorAxis>
Since: Qt 6.2
Inherits: QAbstractAxis
Status: Deprecated

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

Fonctions publiques

virtual ~QColorAxis()
bool autoRange() const
QLinearGradient gradient() const
qreal max() const
qreal min() const
void setAutoRange(bool autoRange)
void setGradient(const QLinearGradient &gradient)
void setMax(qreal max)
void setMin(qreal min)
void setSize(const qreal size)
void setTickCount(int count)
qreal size() const
int tickCount() const

Signaux

void autoRangeChanged(bool autoRange)
void maxChanged(qreal max)
void minChanged(qreal min)
void rangeChanged(qreal min, qreal max)
void sizeChanged(const qreal size)
void tickCountChanged(int tickCount)

Description détaillée

Un axe de couleur peut être configuré pour afficher une échelle de couleurs basée sur le dégradé transmis. L'échelle comporte des repères accompagnés d'étiquettes basées sur les données transmises dans la méthode QXYSeries::colorby.

Documentation des propriétés

autoRange : bool

Cette propriété indique si la plage doit être définie à partir de la liste de valeurs transmise à la méthode ` QXYSeries::colorBy ` ou bien extraite de l'axe lui-même.

La valeur par défaut est « true ».

Fonctions d'accès :

bool autoRange() const
void setAutoRange(bool autoRange)

Signal de notification :

void autoRangeChanged(bool autoRange)

max : qreal

Cette propriété contient la valeur maximale de l'axe.

Lors de la définition de cette propriété, la valeur minimale est ajustée si nécessaire, afin de garantir que la plage reste valide.

Fonctions d'accès :

qreal max() const
void setMax(qreal max)

Signal de notification :

void maxChanged(qreal max)

min : qreal

Cette propriété contient la valeur minimale de l'axe.

Lors de la définition de cette propriété, la valeur maximale est ajustée si nécessaire, afin de garantir que la plage reste valide.

Fonctions d'accès :

qreal min() const
void setMin(qreal min)

Signal de notification :

void minChanged(qreal min)

size : qreal

Cette propriété définit la taille de l'échelle de couleurs.

Selon l'alignement, la valeur indique soit la largeur, soit la hauteur.

Fonctions d'accès :

qreal size() const
void setSize(const qreal size)

Signal de notification :

void sizeChanged(const qreal size)

tickCount : int

Cette propriété détermine le nombre de repères sur l'axe. Elle indique le nombre de lignes de grille tracées sur le graphique si QColorAxis::gridVisible est égal à true. La valeur par défaut est 5, et ce nombre ne peut pas être inférieur à 2.

Remarque : les lignesde la grille sont intentionnellement invisibles par défaut dans QColorAxis, car ce type d’axe ne représente pas de valeurs géométriques.

Fonctions d’accès :

int tickCount() const
void setTickCount(int count)

Signal de notification :

void tickCountChanged(int tickCount)

Documentation des fonctions membres

[virtual noexcept] QColorAxis::~QColorAxis()

Détruit l'objet.

[signal] void QColorAxis::autoRangeChanged(bool autoRange)

Ce signal est émis lorsque le mode de sélection automatique de la plage, défini par autoRange, change.

Remarque : signalde notification pour la propriété autoRange.

QLinearGradient QColorAxis::gradient() const

Renvoie le dégradé actuellement utilisé sur l'échelle de couleurs.

Remarque : si l'axe est associé à une série, le dégradé est également utilisé par la méthode ` QXYSeries::colorBy `.

Voir aussi setGradient.

[signal] void QColorAxis::maxChanged(qreal max)

Ce signal est émis lorsque la valeur maximale de l'axe, spécifiée par max, change.

Remarque : signalde notification pour la propriété max.

[signal] void QColorAxis::minChanged(qreal min)

Ce signal est émis lorsque la valeur minimale de l'axe, spécifiée par min, change.

Remarque : signalde notification pour la propriété min.

[signal] void QColorAxis::rangeChanged(qreal min, qreal max)

Ce signal est émis lorsque la valeur minimale ou maximale de l'axe, définie par min et max, change.

void QColorAxis::setGradient(const QLinearGradient &gradient)

Définit le dégradé de l'échelle de couleurs sur « gradient ».

Remarque : si l'axe est associé à une série, le dégradé est également utilisé par la méthode ` QXYSeries::colorBy `.

Voir également gradient.

[signal] void QColorAxis::tickCountChanged(int tickCount)

Ce signal est émis lorsque le nombre de graduations sur l'axe, spécifié par tickCount, change.

Remarque : signalde notification pour la propriété tickCount.

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