QValue3DAxis Class
La classe QValue3DAxis permet de manipuler un axe d'un graphique. Plus d'informations...
| En-tête : | #include <QValue3DAxis> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake : | QT += datavisualization |
| Depuis : | QtDataVisualization 1.0 |
| En QML : | ValueAxis3D |
| Hérites : | QAbstract3DAxis |
Propriétés
|
|
Fonctions publiques
| QValue3DAxis(QObject *parent = nullptr) | |
| virtual | ~QValue3DAxis() |
| QValue3DAxisFormatter * | formatter() const |
| QString | labelFormat() const |
| bool | reversed() const |
| int | segmentCount() const |
| void | setFormatter(QValue3DAxisFormatter *formatter) |
| void | setLabelFormat(const QString &format) |
| void | setReversed(bool enable) |
| void | setSegmentCount(int count) |
| void | setSubSegmentCount(int count) |
| int | subSegmentCount() const |
Signaux
| void | formatterChanged(QValue3DAxisFormatter *formatter) |
| void | labelFormatChanged(const QString &format) |
| void | reversedChanged(bool enable) |
| void | segmentCountChanged(int count) |
| void | subSegmentCountChanged(int count) |
Description détaillée
Un axe de valeur peut recevoir une plage de valeurs et des nombres de segments et de sous-segments pour diviser la plage.
Des étiquettes sont dessinées entre chaque segment. Des lignes de quadrillage sont tracées entre chaque segment et chaque sous-segment.
Remarque : Si elles sont visibles, il y aura toujours au moins deux lignes de grille et des étiquettes indiquant les valeurs minimum et maximum de la plage, car il y a toujours au moins un segment.
Documentation sur les propriétés
[since QtDataVisualization 1.1] formatter : QValue3DAxisFormatter*
Cette propriété contient le formateur d'axe à utiliser.
Tout formateur existant est supprimé lorsqu'un nouveau formateur est défini.
Cette propriété a été introduite dans QtDataVisualization 1.1.
Fonctions d'accès :
| QValue3DAxisFormatter * | formatter() const |
| void | setFormatter(QValue3DAxisFormatter *formatter) |
Signal Notifier :
| void | formatterChanged(QValue3DAxisFormatter *formatter) |
labelFormat : QString
Cette propriété contient le format d'étiquette à utiliser pour les étiquettes de cet 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 QAbstract3DGraph::locale est autre chose que "C", 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.
Exemple d'utilisation :
axis->setLabelFormat("%.2f mm");
Fonctions d'accès :
| QString | labelFormat() const |
| void | setLabelFormat(const QString &format) |
Notifier signal :
| void | labelFormatChanged(const QString &format) |
Voir aussi formatter et QAbstract3DGraph::locale.
[since QtDataVisualization 1.1] reversed : bool
Cette propriété indique si l'axe est rendu en sens inverse.
Si true, l'axe sera rendu en sens inverse, c'est-à-dire que les positions des valeurs minimales et maximales seront interverties lors du rendu du graphique. Cette propriété n'affecte pas les valeurs minimales et maximales de l'axe.
Cette propriété a été introduite dans QtDataVisualization 1.1.
Fonctions d'accès :
| bool | reversed() const |
| void | setReversed(bool enable) |
Signal Notifier :
| void | reversedChanged(bool enable) |
segmentCount : int
Cette propriété indique le nombre de segments sur l'axe.
Elle indique combien d'étiquettes sont dessinées. Le nombre de lignes de grille à dessiner est calculé à l'aide de la formule : segments * subsegments + 1. La valeur par défaut est 5. La valeur ne peut être inférieure à 1.
Fonctions d'accès :
| int | segmentCount() const |
| void | setSegmentCount(int count) |
Signal de notification :
| void | segmentCountChanged(int count) |
Voir aussi setSubSegmentCount().
subSegmentCount : int
Cette propriété indique le nombre de sous-segments à l'intérieur de chaque segment de l'axe.
Les lignes de la grille sont tracées entre chaque sous-segment, en plus de chaque segment. La valeur par défaut est 1. La valeur ne peut être inférieure à 1.
Fonctions d'accès :
| int | subSegmentCount() const |
| void | setSubSegmentCount(int count) |
Signal de notification :
| void | subSegmentCountChanged(int count) |
Voir également setSegmentCount().
Documentation des fonctions membres
[explicit] QValue3DAxis::QValue3DAxis(QObject *parent = nullptr)
Construit QValue3DAxis avec la valeur donnée parent.
[virtual noexcept] QValue3DAxis::~QValue3DAxis()
Détruit QValue3DAxis.
© 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.
