Sur cette page

QValueAxis Class

La classe QValueAxis ajoute des valeurs aux axes d'un graphique. Plus d'informations...

En-tête : #include <QValueAxis>
CMake : find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake : QT += graphs
En QML : ValueAxis
Héritages : QAbstractAxis

Propriétés

Fonctions publiques

QValueAxis(QObject *parent = nullptr)
virtual ~QValueAxis() override
int labelDecimals() const
QString labelFormat() const
qreal max() const
qreal min() const
qreal pan() const
void setLabelDecimals(int decimals)
void setLabelFormat(const QString &format)
void setMax(qreal max)
void setMin(qreal min)
void setPan(qreal pan)
void setRange(qreal min, qreal max)
void setSubTickCount(qsizetype count)
void setTickAnchor(qreal anchor)
void setTickInterval(qreal interval)
void setZoom(qreal zoom)
qsizetype subTickCount() const
qreal tickAnchor() const
qreal tickInterval() const
qreal visualMax() const
qreal visualMin() const
qreal zoom() const

Fonctions publiques réimplémentées

virtual QAbstractAxis::AxisType type() const override

Signaux

void labelDecimalsChanged(int decimals)
void labelFormatChanged(const QString &format)
void maxChanged(qreal max)
void minChanged(qreal min)
void panChanged(qreal pan)
void subTickCountChanged(qsizetype subTickCount)
void tickAnchorChanged(qreal tickAnchor)
void tickIntervalChanged(qreal tickInterval)
void visualMaxChanged(qreal newVisualMax)
void visualMinChanged(qreal newVisualMin)
void zoomChanged(qreal zoom)

Description détaillée

Un axe de valeur peut être configuré pour afficher une ligne d'axe avec des marques de pointage, des lignes de grille et des nuances. Les valeurs de l'axe sont dessinées à la position des marques de pointage.

Propriété Documentation

labelDecimals : int

Cette propriété indique le nombre de décimales utilisées pour afficher les étiquettes. Lorsqu'elle est fixée à -1, le nombre de décimales est ajusté automatiquement en fonction de la plage de valeurs. La valeur par défaut est -1.

Fonctions d'accès :

int labelDecimals() const
void setLabelDecimals(int decimals)

Signal de notification :

void labelDecimalsChanged(int decimals)

labelFormat : QString

Cette propriété contient le format de l'étiquette de l'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.

La valeur par défaut est vide, auquel cas le format "f" est utilisé.

Fonctions d'accès :

QString labelFormat() const
void setLabelFormat(const QString &format)

Signal de notification :

void labelFormatChanged(const QString &format)

Voir aussi QString::asprintf().

max : qreal

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 s'assurer que la plage reste valide. La valeur par défaut est 10.0

Fonctions d'accès :

qreal max() const
void setMax(qreal max)

Signal de notification :

void maxChanged(qreal max)

min : qreal

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 s'assurer que la plage reste valide. La valeur par défaut est 0.0

Fonctions d'accès :

qreal min() const
void setMin(qreal min)

Signal de notification :

void minChanged(qreal min)

[since 6.9] pan : qreal

Cette propriété contient la valeur panoramique de l'axe.

La valeur pan déplace le centre de l'axe sans affecter les intervalles de la grille et des étiquettes. La valeur par défaut est 0.

Cette propriété a été introduite dans Qt 6.9.

Fonctions d'accès :

qreal pan() const
void setPan(qreal pan)

Signal Notifier :

void panChanged(qreal pan)

subTickCount : qsizetype

Cette propriété contient le nombre de sous-titres sur l'axe. Elle indique le nombre de sous-tirets dessinés entre les lignes principales du graphique. Les étiquettes ne sont pas dessinées pour les sous-tirets. La valeur par défaut est 0.

Fonctions d'accès :

qsizetype subTickCount() const
void setSubTickCount(qsizetype count)

Notifier signal :

void subTickCountChanged(qsizetype subTickCount)

tickAnchor : qreal

Cette propriété contient la valeur de base à partir de laquelle les marques et les étiquettes sont placées dynamiquement. La valeur par défaut est 0.

Fonctions d'accès :

qreal tickAnchor() const
void setTickAnchor(qreal anchor)

Signal de notification :

void tickAnchorChanged(qreal tickAnchor)

tickInterval : qreal

Cette propriété définit l'intervalle entre les marques de tic-tac et les étiquettes placées dynamiquement. La valeur par défaut est 0, ce qui signifie que les intervalles sont automatiquement calculés sur la base des valeurs min et max.

Fonctions d'accès :

qreal tickInterval() const
void setTickInterval(qreal interval)

Signal Notifier :

void tickIntervalChanged(qreal tickInterval)

[read-only, since 6.11] visualMax : qreal

Cette propriété contient la valeur maximale visuelle de l'axe.

Cette propriété contient une valeur maximale visuelle de l'axe lorsque l'axe a fait l'objet d'un panoramique ou d'un zoom. La valeur par défaut est QValueAxis::max

Cette propriété a été introduite dans Qt 6.11.

Fonctions d'accès :

qreal visualMax() const

Signal Notifier :

void visualMaxChanged(qreal newVisualMax)

[read-only, since 6.11] visualMin : qreal

Cette propriété indique la valeur minimale visuelle de l'axe.

Cette propriété contient une valeur minimale visuelle de l'axe lorsque l'axe a fait l'objet d'un panoramique ou d'un zoom. La valeur par défaut est QValueAxis::min

Cette propriété a été introduite dans Qt 6.11.

Fonctions d'accès :

qreal visualMin() const

Signal Notifier :

void visualMinChanged(qreal newVisualMin)

[since 6.9] zoom : qreal

Cette propriété contient la valeur de zoom de l'axe.

La valeur de zoom agrandit ou rétrécit l'axe et donc le graphique sans affecter les intervalles de la grille et des étiquettes. La valeur par défaut est 1.

Cette propriété a été introduite dans Qt 6.9.

Fonctions d'accès :

qreal zoom() const
void setZoom(qreal zoom)

Signal Notifier :

void zoomChanged(qreal zoom)

Member Function Documentation

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

Construit un objet axe qui est un enfant de parent.

[override virtual noexcept] QValueAxis::~QValueAxis()

Détruit l'objet.

void QValueAxis::setRange(qreal min, qreal max)

Définit la plage de min à max sur l'axe. Si min est supérieur à max, cette fonction revient sans apporter de modifications.

[override virtual] QAbstractAxis::AxisType QValueAxis::type() const

Réimplémente : QAbstractAxis::type() const.

Renvoie le type de l'axe.

© 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.