QValueAxis Class
La classe QValueAxis ajoute des valeurs aux axes d'un graphique. En savoir plus...
| Header: | #include <QValueAxis> |
| In QML: | ValueAxis |
| Inherits: | QAbstractAxis |
| Inherited By: | |
| Status: | Deprecated |
Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
Types publics
| enum | TickType { TicksDynamic, TicksFixed } |
Propriétés
|
|
Fonctions publiques
| QValueAxis(QObject *parent = nullptr) | |
| virtual | ~QValueAxis() |
| QString | labelFormat() const |
| qreal | max() const |
| qreal | min() const |
| int | minorTickCount() const |
| void | setLabelFormat(const QString &format) |
| void | setMax(qreal max) |
| void | setMin(qreal min) |
| void | setMinorTickCount(int count) |
| void | setRange(qreal min, qreal max) |
| void | setTickAnchor(qreal anchor) |
| void | setTickCount(int count) |
| void | setTickInterval(qreal insterval) |
| void | setTickType(QValueAxis::TickType type) |
| qreal | tickAnchor() const |
| int | tickCount() const |
| qreal | tickInterval() const |
| QValueAxis::TickType | tickType() const |
Fonctions publiques réimplémentées
| virtual QAbstractAxis::AxisType | type() const override |
Slots publics
| void | applyNiceNumbers() |
Signaux
| void | labelFormatChanged(const QString &format) |
| void | maxChanged(qreal max) |
| void | minChanged(qreal min) |
| void | minorTickCountChanged(int minorTickCount) |
| void | rangeChanged(qreal min, qreal max) |
| void | tickAnchorChanged(qreal anchor) |
| void | tickCountChanged(int tickCount) |
| void | tickIntervalChanged(qreal interval) |
| void | tickTypeChanged(QValueAxis::TickType type) |
Description détaillée
Un axe de valeurs peut être configuré pour afficher une ligne d’axe avec des graduations, des lignes de quadrillage et des ombrages. Les valeurs de l’axe sont tracées aux emplacements des graduations.
L'exemple de code suivant illustre l'utilisation de la classe QValueAxis :
QChartView *chartView = new QChartView;
QLineSeries *series = new QLineSeries;
// ...
chartView->chart()->addSeries(series);
QValueAxis *axisX = new QValueAxis;
axisX->setRange(10, 20.5);
axisX->setTickCount(10);
axisX->setLabelFormat("%.2f");
chartView->chart()->setAxisX(axisX, series);Documentation sur les types de membres
enum QValueAxis::TickType
Cette énumération décrit la manière dont les graduations et les étiquettes sont positionnées sur l'axe.
| Constante | Valeur | Description |
|---|---|---|
QValueAxis::TicksDynamic | 0 | Les graduations sont placées selon les valeurs de ` tickAnchor ` et ` tickInterval `. |
QValueAxis::TicksFixed | 1 | Les graduations sont réparties de manière uniforme sur toute la plage de l'axe. La valeur tickCount spécifie le nombre de graduations. |
Documentation de la propriété
labelFormat : QString
Cette propriété contient le format d'étiquette de l'axe.
La chaîne de format prend en charge les spécificateurs de conversion, les modificateurs de longueur et les indicateurs suivants, fournis par la fonction ` printf() ` de la bibliothèque C++ standard : d, i, o, x, X, f, F, e, E, g, G, c.
Si QChart::localizeNumbers est défini sur true, les spécificateurs pris en charge sont limités à : d, e, E, f, g, G et i. De plus, seul le modificateur de précision est pris en charge. Le reste du formatage provient de l'QLocale par défaut de l'application.
Fonctions d’accès :
| QString | labelFormat() const |
| void | setLabelFormat(const QString &format) |
Signal de notification :
| void | labelFormatChanged(const QString &format) |
Voir également QString::asprintf().
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) |
minorTickCount : int
Cette propriété définit le nombre de graduations secondaires sur l'axe. Elle indique le nombre de lignes de quadrillage tracées entre les graduations principales du graphique. Les graduations secondaires ne sont pas accompagnées de libellés. La valeur par défaut est 0.
Fonctions d'accès :
| int | minorTickCount() const |
| void | setMinorTickCount(int count) |
Signal de notification :
| void | minorTickCountChanged(int minorTickCount) |
tickAnchor : qreal
Cette propriété définit la valeur de référence à partir de laquelle sont placés les repères et les libellés générés dynamiquement.
Fonctions d'accès :
| qreal | tickAnchor() const |
| void | setTickAnchor(qreal anchor) |
Signal de notification :
| void | tickAnchorChanged(qreal anchor) |
tickCount : int
Cette propriété définit le nombre de graduations sur l'axe. Elle indique le nombre de lignes de grille tracées sur le graphique. La valeur par défaut est 5, et ce nombre ne peut pas être inférieur à 2.
Fonctions d'accès :
| int | tickCount() const |
| void | setTickCount(int count) |
Signal de notification :
| void | tickCountChanged(int tickCount) |
tickInterval : qreal
Cette propriété définit l'intervalle entre les graduations et les étiquettes placées dynamiquement.
Fonctions d'accès :
| qreal | tickInterval() const |
| void | setTickInterval(qreal insterval) |
Signal de notification :
| void | tickIntervalChanged(qreal interval) |
tickType : TickType
Cette propriété définit la méthode de positionnement des repères et des étiquettes.
Fonctions d'accès :
| QValueAxis::TickType | tickType() const |
| void | setTickType(QValueAxis::TickType type) |
Signal de notification :
| void | tickTypeChanged(QValueAxis::TickType type) |
Documentation des fonctions membres
[explicit] QValueAxis::QValueAxis(QObject *parent = nullptr)
Crée un objet « axe » qui est un enfant de parent.
[virtual noexcept] QValueAxis::~QValueAxis()
Détruit l'objet.
[slot] void QValueAxis::applyNiceNumbers()
Modifie la plage actuelle et le nombre de graduations sur l'axe afin d'obtenir un rendu esthétique. L'algorithme considère comme « esthétiques » les nombres pouvant s'exprimer sous la forme 1*10^n, 2*10^n ou 5*10^n. Ces nombres sont utilisés pour définir l'espacement des graduations.
Voir également setRange() et setTickCount().
[signal] void QValueAxis::labelFormatChanged(const QString &format)
Ce signal est émis lorsque la propriété « format » des étiquettes d'axe change.
Remarque : signalde notification pour la propriété « labelFormat ».
[signal] void QValueAxis::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 QValueAxis::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 QValueAxis::minorTickCountChanged(int minorTickCount)
Ce signal est émis lorsque le nombre de graduations secondaires sur l'axe, spécifié par minorTickCount, change.
Remarque : signalde notification pour la propriété minorTickCount.
[signal] void QValueAxis::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 QValueAxis::setRange(qreal min, qreal max)
Définit l'intervalle compris entre min et max sur l'axe. Si min est supérieur à max, cette fonction se termine sans effectuer de modification.
[signal] void QValueAxis::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.
[override virtual] QAbstractAxis::AxisType QValueAxis::type() const
Réimplémente : ` QAbstractAxis::type()` const.
Renvoie le type de l'axe.
© 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.