Sur cette page

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 Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake : QT += graphs
En QML : Value3DAxis
Héritages : QAbstract3DAxis

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 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 et des lignes de grille sont tracées entre chaque segment et chaque sous-segment.

Remarque : S'ils 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

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 du notificateur :

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 Q3DGraphsWidgetItem::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 Q3DGraphsWidgetItem::locale.

reversed : bool

Cette propriété indique si l'axe est rendu en sens inverse.

Si true, l'axe sera rendu en sens inverse, ce qui signifie que les positions des valeurs minimales et maximales sont interverties 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 Notifier :

void reversedChanged(bool enable)

segmentCount : qsizetype

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 :

qsizetype segmentCount() const
void setSegmentCount(qsizetype count)

Signal de notification :

void segmentCountChanged(qsizetype count)

Voir aussi setSubSegmentCount().

subSegmentCount : qsizetype

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 :

qsizetype subSegmentCount() const
void setSubSegmentCount(qsizetype count)

Signal de notification :

void subSegmentCountChanged(qsizetype count)

Voir également setSegmentCount().

Documentation des fonctions membres

[explicit] QValue3DAxis::QValue3DAxis(QObject *parent = nullptr)

Construit QValue3DAxis avec la valeur donnée parent.

[override 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.