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 Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake : | QT += graphs |
| En QML : | Value3DAxis |
| Hérite de : | QAbstract3DAxis |
- Liste de tous les membres, y compris les membres hérités
- QValue3DAxis fait partie des classes C++Qt Graphs pour la 3D.
Propriétés
|
|
Fonctions publiques
| QValue3DAxis(QObject *parent = nullptr) | |
| virtual | ~QValue3DAxis() override |
| QValue3DAxisFormatter * | formatter() const |
| QString | labelFormat() const |
| bool | reversed() const |
| qsizetype | segmentCount() const |
| void | setFormatter(QValue3DAxisFormatter *formatter) |
| void | setLabelFormat(const QString &format) |
| void | setReversed(bool enable) |
| void | setSegmentCount(qsizetype count) |
| void | setSubSegmentCount(qsizetype count) |
| qsizetype | subSegmentCount() const |
Signaux
| void | formatterChanged(QValue3DAxisFormatter *formatter) |
| void | labelFormatChanged(const QString &format) |
| void | reversedChanged(bool enable) |
| void | segmentCountChanged(qsizetype count) |
| void | subSegmentCountChanged(qsizetype 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 tracées entre chaque segment, et 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 grille et deux étiquettes indiquant les valeurs minimale et maximale de la plage, car il y a toujours au moins un segment.
Documentation des propriétés
formatter : QValue3DAxisFormatter*
Cette propriété contient le formateur d'axe à utiliser.
Tout formateur existant est supprimé lorsqu'un nouveau formateur est défini.
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 ` Q3DGraphsWidgetItem::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 du formatage provient de 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 Q3DGraphsWidgetItem::locale.
reversed : bool
Cette propriété s'applique même si l'axe est affiché à l'envers.
Si l'true, l'axe sera affiché à l'envers, ce qui signifie que les positions des valeurs minimales et maximales sont inversées lors du rendu du graphique. Cette propriété n'affecte pas les valeurs minimales et maximales réelles de l'axe.
Fonctions d'accès :
| bool | reversed() const |
| void | setReversed(bool enable) |
Signal de notification :
| void | reversedChanged(bool enable) |
segmentCount : qsizetype
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 :
| qsizetype | segmentCount() const |
| void | setSegmentCount(qsizetype count) |
Signal de notification :
| void | segmentCountChanged(qsizetype count) |
Voir également setSubSegmentCount().
subSegmentCount : qsizetype
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 :
| qsizetype | subSegmentCount() const |
| void | setSubSegmentCount(qsizetype count) |
Signal de notification :
| void | subSegmentCountChanged(qsizetype count) |
Voir également setSegmentCount().
Documentation sur les fonctions membres
[explicit] QValue3DAxis::QValue3DAxis(QObject *parent = nullptr)
Crée un objet `QValue3DAxis` à partir de l'parent` fournie.
[override 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.
