Sur cette page

QValueAxis Class

La classe QValueAxis ajoute des valeurs aux axes d'un graphique. En savoir plus...

Header: #include <QValueAxis>
In QML: ValueAxis
Inherits: QAbstractAxis
Inherited By:

QCategoryAxis

Status: Deprecated

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

Types publics

enum TickType { TicksDynamic, TicksFixed }

Propriétés

Fonctions publiques

QValueAxis(QObject *parent = nullptr)
virtual ~QValueAxis()
QString labelFormat() const
qreal max() const
qreal min() const
int minorTickCount() const
void setLabelFormat(const QString &format)
void setMax(qreal max)
void setMin(qreal min)
void setMinorTickCount(int count)
void setRange(qreal min, qreal max)
void setTickAnchor(qreal anchor)
void setTickCount(int count)
void setTickInterval(qreal insterval)
void setTickType(QValueAxis::TickType type)
qreal tickAnchor() const
int tickCount() const
qreal tickInterval() const
QValueAxis::TickType tickType() const

Fonctions publiques réimplémentées

virtual QAbstractAxis::AxisType type() const override

Slots publics

Signaux

void labelFormatChanged(const QString &format)
void maxChanged(qreal max)
void minChanged(qreal min)
void minorTickCountChanged(int minorTickCount)
void rangeChanged(qreal min, qreal max)
void tickAnchorChanged(qreal anchor)
void tickCountChanged(int tickCount)
void tickIntervalChanged(qreal interval)
void tickTypeChanged(QValueAxis::TickType type)

Description détaillée

Un axe de valeurs peut être configuré pour afficher une ligne d’axe avec des graduations, des lignes de quadrillage et des ombrages. Les valeurs de l’axe sont tracées aux emplacements des graduations.

L'exemple de code suivant illustre l'utilisation de la classe QValueAxis :

QChartView *chartView = new QChartView;
QLineSeries *series = new QLineSeries;
// ...
chartView->chart()->addSeries(series);

QValueAxis *axisX = new QValueAxis;
axisX->setRange(10, 20.5);
axisX->setTickCount(10);
axisX->setLabelFormat("%.2f");
chartView->chart()->setAxisX(axisX, series);

Documentation sur les types de membres

enum QValueAxis::TickType

Cette énumération décrit la manière dont les graduations et les étiquettes sont positionnées sur l'axe.

ConstanteValeurDescription
QValueAxis::TicksDynamic0Les graduations sont placées selon les valeurs de ` tickAnchor ` et ` tickInterval `.
QValueAxis::TicksFixed1Les graduations sont réparties de manière uniforme sur toute la plage de l'axe. La valeur tickCount spécifie le nombre de graduations.

Documentation de la propriété

labelFormat : QString

Cette propriété contient le format d'étiquette de l'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 QChart::localizeNumbers est défini sur true, 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.

Fonctions d’accès :

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

Signal de notification :

void labelFormatChanged(const QString &format)

Voir également 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 garantir que la plage reste valide.

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 garantir que la plage reste valide.

Fonctions d'accès :

qreal min() const
void setMin(qreal min)

Signal de notification :

void minChanged(qreal min)

minorTickCount : int

Cette propriété définit le nombre de graduations secondaires sur l'axe. Elle indique le nombre de lignes de quadrillage tracées entre les graduations principales du graphique. Les graduations secondaires ne sont pas accompagnées de libellés. La valeur par défaut est 0.

Fonctions d'accès :

int minorTickCount() const
void setMinorTickCount(int count)

Signal de notification :

void minorTickCountChanged(int minorTickCount)

tickAnchor : qreal

Cette propriété définit la valeur de référence à partir de laquelle sont placés les repères et les libellés générés dynamiquement.

Fonctions d'accès :

qreal tickAnchor() const
void setTickAnchor(qreal anchor)

Signal de notification :

void tickAnchorChanged(qreal anchor)

tickCount : int

Cette propriété définit le nombre de graduations sur l'axe. Elle indique le nombre de lignes de grille tracées sur le graphique. La valeur par défaut est 5, et ce nombre ne peut pas être inférieur à 2.

Fonctions d'accès :

int tickCount() const
void setTickCount(int count)

Signal de notification :

void tickCountChanged(int tickCount)

tickInterval : qreal

Cette propriété définit l'intervalle entre les graduations et les étiquettes placées dynamiquement.

Fonctions d'accès :

qreal tickInterval() const
void setTickInterval(qreal insterval)

Signal de notification :

void tickIntervalChanged(qreal interval)

tickType : TickType

Cette propriété définit la méthode de positionnement des repères et des étiquettes.

Fonctions d'accès :

QValueAxis::TickType tickType() const
void setTickType(QValueAxis::TickType type)

Signal de notification :

void tickTypeChanged(QValueAxis::TickType type)

Documentation des fonctions membres

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

Crée un objet « axe » qui est un enfant de parent.

[virtual noexcept] QValueAxis::~QValueAxis()

Détruit l'objet.

[slot] void QValueAxis::applyNiceNumbers()

Modifie la plage actuelle et le nombre de graduations sur l'axe afin d'obtenir un rendu esthétique. L'algorithme considère comme « esthétiques » les nombres pouvant s'exprimer sous la forme 1*10^n, 2*10^n ou 5*10^n. Ces nombres sont utilisés pour définir l'espacement des graduations.

Voir également setRange() et setTickCount().

[signal] void QValueAxis::labelFormatChanged(const QString &format)

Ce signal est émis lorsque la propriété « format » des étiquettes d'axe change.

Remarque : signalde notification pour la propriété « labelFormat ».

[signal] void QValueAxis::maxChanged(qreal max)

Ce signal est émis lorsque la valeur maximale de l'axe, spécifiée par max, change.

Remarque : signalde notification pour la propriété max.

[signal] void QValueAxis::minChanged(qreal min)

Ce signal est émis lorsque la valeur minimale de l'axe, spécifiée par min, change.

Remarque : signalde notification pour la propriété min.

[signal] void QValueAxis::minorTickCountChanged(int minorTickCount)

Ce signal est émis lorsque le nombre de graduations secondaires sur l'axe, spécifié par minorTickCount, change.

Remarque : signalde notification pour la propriété minorTickCount.

[signal] void QValueAxis::rangeChanged(qreal min, qreal max)

Ce signal est émis lorsque la valeur minimale ou maximale de l'axe, définie par min et max, change.

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

Définit l'intervalle compris entre min et max sur l'axe. Si min est supérieur à max, cette fonction se termine sans effectuer de modification.

[signal] void QValueAxis::tickCountChanged(int tickCount)

Ce signal est émis lorsque le nombre de graduations sur l'axe, spécifié par tickCount, change.

Remarque : signalde notification pour la propriété tickCount.

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