Sur cette page

QValueAxis Class

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

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

QCategoryAxis

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

Emplacements 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 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 à l'emplacement des marques de pointage.

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);

Membre Type Documentation

enum QValueAxis::TickType

Cette énumération décrit la façon dont les ticks et les étiquettes sont positionnés sur l'axe.

ConstanteValeurDescription
QValueAxis::TicksDynamic0Les points sont placés en fonction des valeurs tickAnchor et tickInterval.
QValueAxis::TicksFixed1Les points sont placés uniformément sur l'ensemble de la plage de l'axe. La valeur tickCount spécifie le nombre de ticks.

Documentation sur les propriétés

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.

Si QChart::localizeNumbers est true, 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.

Fonctions d'accès :

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

Signal du notificateur :

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 garantir la validité de la plage.

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 la validité de la plage.

Fonctions d'accès :

qreal min() const
void setMin(qreal min)

Signal de notification :

void minChanged(qreal min)

minorTickCount : int

Cette propriété indique le nombre de marques mineures sur l'axe. Elle indique le nombre de lignes de grille tracées entre les ticks majeurs sur le graphique. Les étiquettes ne sont pas dessinées pour les ticks mineurs. La valeur par défaut est 0.

Fonctions d'accès :

int minorTickCount() const
void setMinorTickCount(int count)

Notifier signal :

void minorTickCountChanged(int minorTickCount)

tickAnchor : qreal

Cette propriété contient la valeur de base à partir de laquelle sont placées dynamiquement les marques et les étiquettes.

Fonctions d'accès :

qreal tickAnchor() const
void setTickAnchor(qreal anchor)

Signal de notification :

void tickAnchorChanged(qreal anchor)

tickCount : int

Cette propriété indique le nombre de points de repère sur l'axe. Elle indique le nombre de lignes de la grille qui sont dessinées sur le graphique. La valeur par défaut est 5, et le nombre ne peut être inférieur à 2.

Fonctions d'accès :

int tickCount() const
void setTickCount(int count)

Signal Notifier :

void tickCountChanged(int tickCount)

tickInterval : qreal

Cette propriété définit l'intervalle entre les marques de tic-tac et les étiquettes placées dynamiquement.

Fonctions d'accès :

qreal tickInterval() const
void setTickInterval(qreal insterval)

Signal du notificateur :

void tickIntervalChanged(qreal interval)

tickType : TickType

Cette propriété contient la méthode de positionnement de la coche et des étiquettes.

Fonctions d'accès :

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

Signal Notificateur :

void tickTypeChanged(QValueAxis::TickType type)

Fonction membre Documentation

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

Construit 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 marques de tic-tac sur l'axe pour qu'ils soient agréables à regarder. L'algorithme considère que les nombres qui peuvent être exprimés sous la forme de 1*10^n, 2* 10^n ou 5*10^n sont des nombres agréables. Ces nombres sont utilisés pour définir l'espacement des marques de tic-tac.

Voir aussi setRange() et setTickCount().

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

Ce signal est émis lorsque le site format des étiquettes d'axe change.

Note : Signal de 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.

Note : Signal de 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.

Note : Signal de notification pour la propriété min.

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

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

Note : Signal de 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, spécifiée par min et max, change.

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.

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

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

Note : Signal de 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.