QValue3DAxis Class
La classe QValue3DAxis permet de manipuler un axe d'un graphique. En savoir plus...
| 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érite de : | QAbstract3DAxis |
| Statut : | Obsolète |
Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
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 valeurs peut se voir attribuer une plage de valeurs ainsi qu'un nombre de segments et de sous-segments permettant de diviser cette plage.
Des étiquettes sont affichées entre chaque segment. Des lignes de grille sont tracées entre chaque segment et chaque sous-segment.
Remarque : si elles sont visibles, il y aura toujours au moins deux lignes de quadrillage et des étiquettes indiquant les valeurs minimale et maximale de la plage, car il y a toujours au moins un segment.
Documentation des 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 énumération a été introduite dans QtDataVisualization 1.1.
Fonctions d'accès :
| QValue3DAxisFormatter * | formatter() const |
| void | setFormatter(QValue3DAxisFormatter *formatter) |
Signal de notification :
| void | formatterChanged(QValue3DAxisFormatter *formatter) |
labelFormat : QString
Cette propriété définit 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 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 la valeur de ` QAbstract3DGraph::locale ` est différente de ` "C"`, 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 de la mise en forme est déterminé par l'QLocale par défaut de l'application.
Exemple d'utilisation :
axis->setLabelFormat("%.2f mm");
Fonctions d'accès :
| QString | labelFormat() const |
| void | setLabelFormat(const QString &format) |
Signal de notification :
| void | labelFormatChanged(const QString &format) |
Voir également formatter et QAbstract3DGraph::locale.
[since QtDataVisualization 1.1] reversed : bool
Cette propriété s'applique même si l'axe est affiché à l'envers.
Si la valeur est « true », l'axe sera affiché dans l'ordre inverse, c'est-à-dire que les positions des valeurs minimales et maximales seront inversées lors du rendu du graphique. Cette propriété n'affecte pas les valeurs minimales et maximales réelles de l'axe.
Cette énumération a été introduite dans QtDataVisualization 1.1.
Fonctions d'accès :
| bool | reversed() const |
| void | setReversed(bool enable) |
Signal de notification :
| void | reversedChanged(bool enable) |
segmentCount : int
Cette propriété indique le nombre de segments sur l'axe.
Ce nombre indique le nombre d'étiquettes affichées. Le nombre de lignes de grille à tracer est calculé à l'aide de la formule suivante : segments * subsegments + 1. La valeur par défaut prédéfinie est 5. La valeur ne peut pas être inférieure à 1.
Fonctions d'accès :
| int | segmentCount() const |
| void | setSegmentCount(int count) |
Signal de notification :
| void | segmentCountChanged(int count) |
Voir également setSubSegmentCount().
subSegmentCount : int
Cette propriété indique le nombre de sous-segments contenus dans chaque segment sur l'axe.
Des lignes de quadrillage sont tracées entre chaque sous-segment, en plus de celles tracées entre chaque segment. La valeur par défaut prédéfinie est 1. La valeur ne peut pas ê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)
Crée un objet `QValue3DAxis` à partir de l'parent` fournie.
[virtual noexcept] QValue3DAxis::~QValue3DAxis()
Supprime 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.
