QAbstract3DAxis Class
La classe `QAbstract3DAxis` est une classe de base pour les axes d'un graphique 3D. En savoir plus...
| En-tête : | #include <QAbstract3DAxis> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake : | QT += graphs |
| En QML : | Abstract3DAxis |
| Hérite de : | QObject |
| Hérité par : |
- Liste de tous les membres, y compris les membres hérités
- QAbstract3DAxis fait partie des classes C++ «Qt Graphs » pour la 3D.
Types publics
| enum class | AxisOrientation { None, X, Y, Z } |
| enum class | AxisType { None, Category, Value } |
Propriétés
|
|
Fonctions publiques
| virtual | ~QAbstract3DAxis() override |
| bool | isAutoAdjustRange() const |
| bool | isScaleLabelsByCount() const |
| bool | isTitleFixed() const |
| bool | isTitleVisible() const |
| float | labelAutoAngle() const |
| qreal | labelSize() const |
| QStringList | labels() const |
| bool | labelsVisible() const |
| float | max() const |
| float | min() const |
| QAbstract3DAxis::AxisOrientation | orientation() const |
| void | setAutoAdjustRange(bool autoAdjust) |
| void | setLabelAutoAngle(float degree) |
| void | setLabelSize(qreal size) |
| void | setLabels(const QStringList &labels) |
| void | setLabelsVisible(bool visible) |
| void | setMax(float max) |
| void | setMin(float min) |
| void | setRange(float min, float max) |
| void | setScaleLabelsByCount(bool adjust) |
| void | setTitle(const QString &title) |
| void | setTitleFixed(bool fixed) |
| void | setTitleOffset(float offset) |
| void | setTitleVisible(bool visible) |
| QString | title() const |
| float | titleOffset() const |
| QAbstract3DAxis::AxisType | type() const |
Signaux
| void | autoAdjustRangeChanged(bool autoAdjust) |
| void | labelAutoAngleChanged(float angle) |
| void | labelSizeChanged(qreal size) |
| void | labelVisibleChanged(bool visible) |
| void | labelsChanged() |
| void | maxChanged(float value) |
| void | minChanged(float value) |
| void | orientationChanged(QAbstract3DAxis::AxisOrientation orientation) |
| void | rangeChanged(float min, float max) |
| void | scaleLabelsByCountChanged(bool adjust) |
| void | titleChanged(const QString &newTitle) |
| void | titleFixedChanged(bool fixed) |
| void | titleOffsetChanged(float offset) |
| void | titleVisibleChanged(bool visible) |
Description détaillée
Cette classe définit les énumérations, les propriétés et les fonctions communes aux axes des graphiques. Elle ne doit pas être utilisée directement ; il convient plutôt d'utiliser l'une de ses sous-classes.
Voir également QCategory3DAxis et QValue3DAxis.
Documentation sur les types de membres
enum class QAbstract3DAxis::AxisOrientation
L'orientation de l'objet « axe ».
| Constante | Valeur |
|---|---|
QAbstract3DAxis::AxisOrientation::None | 0 |
QAbstract3DAxis::AxisOrientation::X | 1 |
QAbstract3DAxis::AxisOrientation::Y | 2 |
QAbstract3DAxis::AxisOrientation::Z | 3 |
enum class QAbstract3DAxis::AxisType
Le type de l'objet « axe ».
| Constante | Valeur |
|---|---|
QAbstract3DAxis::AxisType::None | 0 |
QAbstract3DAxis::AxisType::Category | 1 |
QAbstract3DAxis::AxisType::Value | 2 |
Documentation sur les propriétés
autoAdjustRange : bool
Cette propriété détermine si l'axe ajustera automatiquement son intervalle de manière à ce que toutes les données y tiennent.
Fonctions d'accès :
| bool | isAutoAdjustRange() const |
| void | setAutoAdjustRange(bool autoAdjust) |
Signal de notification :
| void | autoAdjustRangeChanged(bool autoAdjust) |
Voir également setRange(), setMin() et setMax().
labelAutoAngle : float
Cette propriété définit l'angle maximal de rotation automatique des étiquettes lorsque l'angle de la caméra change.
Cet angle peut être compris entre 0 et 90, inclus. La valeur par défaut est 0. Si la valeur est égale à 0, les étiquettes d'axe ne pivotent pas automatiquement. Si la valeur est supérieure à zéro, les étiquettes tentent de s'orienter vers la caméra, jusqu'à l'angle spécifié.
Fonctions d'accès :
| float | labelAutoAngle() const |
| void | setLabelAutoAngle(float degree) |
Signal de notification :
| void | labelAutoAngleChanged(float angle) |
[since 6.9] labelSize : qreal
Taille de l'étiquette
La taille de l'étiquette. La valeur par défaut est 1.0.
Cette énumération a été introduite dans Qt 6.9.
Fonctions d'accès :
| qreal | labelSize() const |
| void | setLabelSize(qreal size) |
Signal de notification :
| void | labelSizeChanged(qreal size) |
Voir aussi scaleLabelsByCount.
labels : QStringList
Cette propriété contient les libellés des axes.
Remarque : la définition de cette propriété pour « QValue3DAxis » n'a aucun effet, car celle-ci génère automatiquement les libellés.
Fonctions d'accès :
| QStringList | labels() const |
| void | setLabels(const QStringList &labels) |
Signal de notification :
| void | labelsChanged() |
labelsVisible : bool
Cette propriété indique si les étiquettes des axes sont visibles dans la vue graphique principale.
La valeur par défaut est « true ».
Fonctions d'accès :
| bool | labelsVisible() const |
| void | setLabelsVisible(bool visible) |
Signal de notification :
| void | labelVisibleChanged(bool visible) |
max : float
Cette propriété contient 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.
Remarque : pour QCategory3DAxis, spécifie l'index de la dernière ligne ou colonne à afficher.
Fonctions d'accès :
| float | max() const |
| void | setMax(float max) |
Signal de notification :
| void | maxChanged(float value) |
min : float
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.
Remarque : pour l'QCategory3DAxis, spécifie l'index de la première ligne ou colonne à afficher.
Fonctions d'accès :
| float | min() const |
| void | setMin(float min) |
Signal de notification :
| void | minChanged(float value) |
[read-only] orientation : QAbstract3DAxis::AxisOrientation
Cette propriété contient l'orientation de l'axe.
La valeur est l'une des valeurs suivantes : AxisOrientation.
Fonctions d'accès :
| QAbstract3DAxis::AxisOrientation | orientation() const |
Signal de notification :
| void | orientationChanged(QAbstract3DAxis::AxisOrientation orientation) |
[since 6.9] scaleLabelsByCount : bool
Cette propriété détermine si les étiquettes adapteront automatiquement leur taille en fonction du nombre total d'étiquettes
Cette énumération a été introduite dans Qt 6.9.
Fonctions d'accès :
| bool | isScaleLabelsByCount() const |
| void | setScaleLabelsByCount(bool adjust) |
Signal de notification :
| void | scaleLabelsByCountChanged(bool adjust) |
Voir également labelSize().
title : QString
Cette propriété contient le nom de l'axe.
Fonctions d'accès :
| QString | title() const |
| void | setTitle(const QString &title) |
Signal de notification :
| void | titleChanged(const QString &newTitle) |
Voir également titleVisible et titleFixed.
titleFixed : bool
Cette propriété définit la rotation des titres d'axe.
Si l’ false, les titres des axes dans la vue graphique principale seront pivotés vers la caméra, à l’instar des étiquettes d’axe. Si l’ true, les titres des axes sont uniquement pivotés autour de leur axe, mais ne sont pas orientés vers la caméra. Cette propriété n’a aucun effet si la valeur de la propriété labelAutoAngle est égale à zéro. La valeur par défaut est true.
Fonctions d’accès :
| bool | isTitleFixed() const |
| void | setTitleFixed(bool fixed) |
Signal de notification :
| void | titleFixedChanged(bool fixed) |
Voir également labelAutoAngle, title et titleVisible.
titleOffset : float
Position du titre de l'axe sur l'axe. La valeur doit être comprise entre -1.0f et 1.0f
Fonctions d'accès :
| float | titleOffset() const |
| void | setTitleOffset(float offset) |
Signal de notification :
| void | titleOffsetChanged(float offset) |
Voir également title et titleFixed.
titleVisible : bool
Cette propriété indique si le titre de l'axe est visible dans la vue graphique principale.
La valeur par défaut est « false ».
Fonctions d'accès :
| bool | isTitleVisible() const |
| void | setTitleVisible(bool visible) |
Signal de notification :
| void | titleVisibleChanged(bool visible) |
Voir également title et titleFixed.
[read-only] type : const QAbstract3DAxis::AxisType
Cette propriété indique le type de l'axe.
Sa valeur correspond à l'une des valeurs suivantes : AxisType.
Fonctions d'accès :
| QAbstract3DAxis::AxisType | type() const |
Documentation sur les fonctions membres
[override virtual noexcept] QAbstract3DAxis::~QAbstract3DAxis()
Supprime QAbstract3DAxis.
[signal] void QAbstract3DAxis::rangeChanged(float min, float max)
Affiche les valeurs minimale et maximale de l'intervalle, min et max, lorsque l'intervalle change.
void QAbstract3DAxis::setRange(float min, float max)
Définit la plage de valeurs de l'axe de min à max. Lors de la définition de la plage, la valeur maximale est ajustée si nécessaire afin de garantir que la plage reste valide.
Remarque : pour QCategory3DAxis, spécifie la plage d’index des lignes ou des colonnes à afficher.
© 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.
