Sur cette page

QAbstract3DAxis Class

La classe QAbstract3DAxis est une classe de base pour les axes d'un graphique. En savoir plus...

En-tête : #include <QAbstract3DAxis>
CMake : find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake : QT += datavisualization
Depuis : QtDataVisualization 1.0
En QML : AbstractAxis3D
Hérite de : QObject
Hérité par :

QCategory3DAxis et QValue3DAxis

Statut : Obsolète

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Types publics

enum AxisOrientation { AxisOrientationNone, AxisOrientationX, AxisOrientationY, AxisOrientationZ }
enum AxisType { AxisTypeNone, AxisTypeCategory, AxisTypeValue }

Propriétés

Fonctions publiques

virtual ~QAbstract3DAxis()
bool isAutoAdjustRange() const
bool isTitleFixed() const
bool isTitleVisible() const
float labelAutoRotation() const
QStringList labels() const
float max() const
float min() const
QAbstract3DAxis::AxisOrientation orientation() const
void setAutoAdjustRange(bool autoAdjust)
void setLabelAutoRotation(float angle)
void setLabels(const QStringList &labels)
void setMax(float max)
void setMin(float min)
void setRange(float min, float max)
void setTitle(const QString &title)
void setTitleFixed(bool fixed)
void setTitleVisible(bool visible)
QString title() const
QAbstract3DAxis::AxisType type() const

Signaux

void autoAdjustRangeChanged(bool autoAdjust)
void labelAutoRotationChanged(float angle)
void labelsChanged()
void maxChanged(float value)
void minChanged(float value)
void orientationChanged(QAbstract3DAxis::AxisOrientation orientation)
void rangeChanged(float min, float max)
void titleChanged(const QString &newTitle)
void titleFixedChanged(bool fixed)
void titleVisibilityChanged(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 QAbstract3DAxis::AxisOrientation

L'orientation de l'objet « axe ».

ConstanteValeur
QAbstract3DAxis::AxisOrientationNone0
QAbstract3DAxis::AxisOrientationX1
QAbstract3DAxis::AxisOrientationY2
QAbstract3DAxis::AxisOrientationZ4

enum QAbstract3DAxis::AxisType

Le type de l'objet « axe ».

ConstanteValeur
QAbstract3DAxis::AxisTypeNone0
QAbstract3DAxis::AxisTypeCategory1
QAbstract3DAxis::AxisTypeValue2

Documentation de la propriété

autoAdjustRange : bool

Cette propriété détermine si l'axe ajustera automatiquement son intervalle afin 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().

labelAutoRotation : 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 labelAutoRotation() const
void setLabelAutoRotation(float angle)

Signal de notification :

void labelAutoRotationChanged(float angle)

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 celui-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()

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 sur 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 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 : AxisOrientation

Cette propriété définit l'orientation de l'axe.

La valeur correspond à l'une des valeurs suivantes : AxisOrientation.

Fonctions d'accès :

QAbstract3DAxis::AxisOrientation orientation() const

Signal de notification :

void orientationChanged(QAbstract3DAxis::AxisOrientation orientation)

title : QString

Cette propriété contient le libellé 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'true, les titres des axes dans la vue graphique principale seront pivotés vers la caméra, à l'instar des étiquettes des axes. Si l'false, 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é labelAutoRotation 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 labelAutoRotation, title et titleVisible.

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 titleVisibilityChanged(bool visible)

Voir également title et titleFixed.

[read-only] type : const 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

[virtual noexcept] QAbstract3DAxis::~QAbstract3DAxis()

Supprime QAbstract3DAxis.

[signal] void QAbstract3DAxis::rangeChanged(float min, float max)

Affiche les valeurs minimale et maximale de la plage, min et max, lorsque la plage change.

void QAbstract3DAxis::setRange(float min, float max)

Définit la plage de valeurs de l'axe entre min et 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.