QValueAxis Class
La classe QValueAxis ajoute des valeurs aux axes d'un graphique. Plus d'informations...
| Header: | #include <QValueAxis> |
| In QML: | ValueAxis |
| Inherits: | QAbstractAxis |
| Inherited By: |
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 |
Emplacements 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 valeur peut être configuré pour afficher une ligne d'axe avec des marques de pointage, des lignes de grille et des nuances. Les valeurs de l'axe sont dessinées à l'emplacement des marques de pointage.
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);
Membre Type Documentation
enum QValueAxis::TickType
Cette énumération décrit la façon dont les ticks et les étiquettes sont positionnés sur l'axe.
| Constante | Valeur | Description |
|---|---|---|
QValueAxis::TicksDynamic | 0 | Les points sont placés en fonction des valeurs tickAnchor et tickInterval. |
QValueAxis::TicksFixed | 1 | Les points sont placés uniformément sur l'ensemble de la plage de l'axe. La valeur tickCount spécifie le nombre de ticks. |
Documentation sur les propriétés
labelFormat : QString
Cette propriété contient le format de l'étiquette de l'axe.
La chaîne de format prend en charge les spécificateurs de conversion, les modificateurs de longueur et les drapeaux suivants, fournis par printf() dans la bibliothèque standard C++ : d, i, o, x, X, f, F, e, E, g, G, c.
Si QChart::localizeNumbers est true, les spécificateurs pris en charge sont limités à : d, e, E, f, g, G et i. De même, seul le modificateur de précision est pris en charge. Le reste du formatage provient de la version par défaut de QLocale de l'application.
Fonctions d'accès :
| QString | labelFormat() const |
| void | setLabelFormat(const QString &format) |
Signal du notificateur :
| void | labelFormatChanged(const QString &format) |
Voir aussi 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 la validité de la plage.
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 la validité de la plage.
Fonctions d'accès :
| qreal | min() const |
| void | setMin(qreal min) |
Signal de notification :
| void | minChanged(qreal min) |
minorTickCount : int
Cette propriété indique le nombre de marques mineures sur l'axe. Elle indique le nombre de lignes de grille tracées entre les ticks majeurs sur le graphique. Les étiquettes ne sont pas dessinées pour les ticks mineurs. La valeur par défaut est 0.
Fonctions d'accès :
| int | minorTickCount() const |
| void | setMinorTickCount(int count) |
Notifier signal :
| void | minorTickCountChanged(int minorTickCount) |
tickAnchor : qreal
Cette propriété contient la valeur de base à partir de laquelle sont placées dynamiquement les marques et les étiquettes.
Fonctions d'accès :
| qreal | tickAnchor() const |
| void | setTickAnchor(qreal anchor) |
Signal de notification :
| void | tickAnchorChanged(qreal anchor) |
tickCount : int
Cette propriété indique le nombre de points de repère sur l'axe. Elle indique le nombre de lignes de la grille qui sont dessinées sur le graphique. La valeur par défaut est 5, et le nombre ne peut être inférieur à 2.
Fonctions d'accès :
| int | tickCount() const |
| void | setTickCount(int count) |
Signal Notifier :
| void | tickCountChanged(int tickCount) |
tickInterval : qreal
Cette propriété définit l'intervalle entre les marques de tic-tac et les étiquettes placées dynamiquement.
Fonctions d'accès :
| qreal | tickInterval() const |
| void | setTickInterval(qreal insterval) |
Signal du notificateur :
| void | tickIntervalChanged(qreal interval) |
tickType : TickType
Cette propriété contient la méthode de positionnement de la coche et des étiquettes.
Fonctions d'accès :
| QValueAxis::TickType | tickType() const |
| void | setTickType(QValueAxis::TickType type) |
Signal Notificateur :
| void | tickTypeChanged(QValueAxis::TickType type) |
Fonction membre Documentation
[explicit] QValueAxis::QValueAxis(QObject *parent = nullptr)
Construit 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 marques de tic-tac sur l'axe pour qu'ils soient agréables à regarder. L'algorithme considère que les nombres qui peuvent être exprimés sous la forme de 1*10^n, 2* 10^n ou 5*10^n sont des nombres agréables. Ces nombres sont utilisés pour définir l'espacement des marques de tic-tac.
Voir aussi setRange() et setTickCount().
[signal] void QValueAxis::labelFormatChanged(const QString &format)
Ce signal est émis lorsque le site format des étiquettes d'axe change.
Note : Signal de 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.
Note : Signal de 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.
Note : Signal de notification pour la propriété min.
[signal] void QValueAxis::minorTickCountChanged(int minorTickCount)
Ce signal est émis lorsque le nombre de petites marques sur l'axe, spécifié par minorTickCount, change.
Note : Signal de 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, spécifiée par min et max, change.
void QValueAxis::setRange(qreal min, qreal max)
Définit la plage de min à max sur l'axe. Si min est supérieur à max, cette fonction revient sans apporter de modifications.
[signal] void QValueAxis::tickCountChanged(int tickCount)
Ce signal est émis lorsque le nombre de marques sur l'axe, spécifié par tickCount, change.
Note : Signal de 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.