QValueAxis Class
La classe QValueAxis ajoute des valeurs aux axes d'un graphique. En savoir plus...
| En-tête : | #include <QValueAxis> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake : | QT += graphs |
| En QML : | ValueAxis |
| Hérite de : | QAbstractAxis |
- Liste de tous les membres, y compris les membres hérités
- QValueAxis fait partie des classes C++ d'Qt Graphs pour le 2D.
Propriétés
|
|
Fonctions publiques
| QValueAxis(QObject *parent = nullptr) | |
| virtual | ~QValueAxis() override |
| int | labelDecimals() const |
| QString | labelFormat() const |
| QString | labelPostFormat() const |
| qreal | max() const |
| qreal | min() const |
| qreal | pan() const |
| void | setLabelDecimals(int decimals) |
| void | setLabelFormat(const QString &format) |
| void | setLabelPostFormat(const QString &format) |
| void | setMax(qreal max) |
| void | setMin(qreal min) |
| void | setPan(qreal pan) |
| void | setRange(qreal min, qreal max) |
| void | setSubTickCount(qsizetype count) |
| void | setTickAnchor(qreal anchor) |
| void | setTickInterval(qreal interval) |
| void | setZoom(qreal zoom) |
| qsizetype | subTickCount() const |
| qreal | tickAnchor() const |
| qreal | tickInterval() const |
| qreal | visualMax() const |
| qreal | visualMin() const |
| qreal | zoom() const |
Fonctions publiques réimplémentées
| virtual QAbstractAxis::AxisType | type() const override |
Signaux
| void | labelDecimalsChanged(int decimals) |
| void | labelFormatChanged(const QString &format) |
| void | labelPostFormatChanged(const QString &format) |
| void | maxChanged(qreal max) |
| void | minChanged(qreal min) |
| void | panChanged(qreal pan) |
| void | subTickCountChanged(qsizetype subTickCount) |
| void | tickAnchorChanged(qreal tickAnchor) |
| void | tickIntervalChanged(qreal tickInterval) |
| void | visualMaxChanged(qreal newVisualMax) |
| void | visualMinChanged(qreal newVisualMin) |
| void | zoomChanged(qreal zoom) |
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 ombres. Les valeurs sur l’axe sont tracées aux positions des graduations.
Documentation des propriétés
labelDecimals : int
Cette propriété détermine le nombre de décimales utilisées pour l'affichage des libellés. Lorsqu'elle est définie sur -1, le nombre de décimales est ajusté automatiquement en fonction de la plage des valeurs. La valeur par défaut est -1.
Fonctions d'accès :
| int | labelDecimals() const |
| void | setLabelDecimals(int decimals) |
Signal de notification :
| void | labelDecimalsChanged(int decimals) |
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. La chaîne formatée est ensuite traitée par la fonction ` QValueAxis::labelPostFormat`.
La valeur par défaut est vide ; dans ce cas, le format « f » est utilisé.
Fonctions d’accès :
| QString | labelFormat() const |
| void | setLabelFormat(const QString &format) |
Signal de notification :
| void | labelFormatChanged(const QString &format) |
Voir également QString::asprintf().
[since 6.12] labelPostFormat : QString
Cette propriété contient le format d'affichage des étiquettes de l'axe.
L'étiquette passe d'abord par QValueAxis::labelFormat pour formater la valeur, puis par cette propriété.
La valeur par défaut est « %1 ».
Cette énumération a été introduite dans Qt 6.12.
Fonctions d'accès :
| QString | labelPostFormat() const |
| void | setLabelPostFormat(const QString &format) |
Signal de notification :
| void | labelPostFormatChanged(const QString &format) |
Voir également QString::arg().
max : qreal
Cette propriété définit 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. La valeur par défaut est 10,0
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. La valeur par défaut est 0,0
Fonctions d'accès :
| qreal | min() const |
| void | setMin(qreal min) |
Signal de notification :
| void | minChanged(qreal min) |
[since 6.9] pan : qreal
Cette propriété contient la valeur de panoramique de l'axe.
La valeur « pan » déplace le centre de l'axe sans affecter les intervalles de la grille ni les étiquettes. La valeur par défaut est 0.
Cette énumération a été introduite dans Qt 6.9.
Fonctions d'accès :
| qreal | pan() const |
| void | setPan(qreal pan) |
Signal de notification :
| void | panChanged(qreal pan) |
subTickCount : qsizetype
Cette propriété contient le nombre de sous-graduations sur l'axe. Elle indique combien de sous-graduations sont tracées entre les lignes principales du graphique. Les libellés ne sont pas affichés pour les sous-graduations. La valeur par défaut est 0.
Fonctions d'accès :
| qsizetype | subTickCount() const |
| void | setSubTickCount(qsizetype count) |
Signal de notification :
| void | subTickCountChanged(qsizetype subTickCount) |
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. La valeur par défaut est 0.
Fonctions d'accès :
| qreal | tickAnchor() const |
| void | setTickAnchor(qreal anchor) |
Signal de notification :
| void | tickAnchorChanged(qreal tickAnchor) |
tickInterval : qreal
Cette propriété définit l'intervalle entre les repères et les étiquettes placés dynamiquement. La valeur par défaut est 0, ce qui signifie que les intervalles sont calculés automatiquement en fonction des valeurs minimale et maximale de la plage.
Fonctions d'accès :
| qreal | tickInterval() const |
| void | setTickInterval(qreal interval) |
Signal de notification :
| void | tickIntervalChanged(qreal tickInterval) |
[read-only, since 6.11] visualMax : qreal
Cette propriété contient la valeur maximale affichée de l'axe.
Cette propriété contient la valeur maximale visuelle de l'axe lorsque celui-ci a fait l'objet d'un panoramique ou d'un zoom. La valeur par défaut est QValueAxis::max
Cette énumération a été introduite dans Qt 6.11.
Fonctions d'accès :
| qreal | visualMax() const |
Signal de notification :
| void | visualMaxChanged(qreal newVisualMax) |
[read-only, since 6.11] visualMin : qreal
Cette propriété contient la valeur minimale d'affichage de l'axe.
Cette propriété contient la valeur minimale visuelle de l'axe lorsque celui-ci a fait l'objet d'un panoramique ou d'un zoom. La valeur par défaut est QValueAxis::min
Cette énumération a été introduite dans Qt 6.11.
Fonctions d'accès :
| qreal | visualMin() const |
Signal de notification :
| void | visualMinChanged(qreal newVisualMin) |
[since 6.9] zoom : qreal
Cette propriété contient la valeur de zoom de l'axe.
La valeur de zoom agrandit ou réduit l'axe, et donc le graphique, sans affecter les intervalles de la grille ni les étiquettes. La valeur par défaut est 1.
Cette énumération a été introduite dans Qt 6.9.
Fonctions d'accès :
| qreal | zoom() const |
| void | setZoom(qreal zoom) |
Signal de notification :
| void | zoomChanged(qreal zoom) |
Documentation des fonctions membres
[explicit] QValueAxis::QValueAxis(QObject *parent = nullptr)
Crée un objet « axe » qui est un enfant de parent.
[override virtual noexcept] QValueAxis::~QValueAxis()
Détruit l'objet.
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.
[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.
