Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

QDateTimeAxis Class

La classe QDateTimeAxis ajoute des dates et des heures à l'axe d'un graphique. Plus d'informations...

Header: #include <QDateTimeAxis>
In QML: DateTimeAxis
Inherits: QAbstractAxis

Propriétés

Fonctions publiques

QDateTimeAxis(QObject *parent = nullptr)
virtual ~QDateTimeAxis()
QString format() const
QDateTime max() const
QDateTime min() const
void setFormat(QString format)
void setMax(QDateTime max)
void setMin(QDateTime min)
void setRange(QDateTime min, QDateTime max)
void setTickCount(int count)
int tickCount() const

Fonctions publiques réimplémentées

virtual QAbstractAxis::AxisType type() const override

Signaux

void formatChanged(QString format)
void maxChanged(QDateTime max)
void minChanged(QDateTime min)
void rangeChanged(QDateTime min, QDateTime max)
void tickCountChanged(int tickCount)

Description détaillée

QDateTimeAxis peut être configuré pour afficher une ligne d'axe avec des marques de tic-tac, des lignes de grille et des nuances. Les étiquettes peuvent être configurées en définissant un format DateTime approprié. QDateTimeAxis fonctionne correctement avec les dates comprises entre 4714 BCE et 287396 CE. Pour d'autres limitations liées à QDateTime, voir la documentation de QDateTime.

Remarque : QDateTimeAxis est désactivé sur les plates-formes qui définissent qreal comme float.

Capture d'écran montrant l'axe des x décrivant les dates et heures.

QDateTimeAxis peut être utilisé avec n'importe quelle QXYSeries. Pour ajouter un point de données à la série, on utilise QDateTime::toMSecsSinceEpoch() :

QLineSeries *series = new QLineSeries;

QDateTime xValue;
xValue.setDate(QDate(2012, 1 , 18));
xValue.setTime(QTime(9, 34));
qreal yValue = 12;
series->append(xValue.toMSecsSinceEpoch(), yValue);

xValue.setDate(QDate(2013, 5 , 11));
xValue.setTime(QTime(11, 14));
qreal yValue = 22;
series->append(xValue.toMSecsSinceEpoch(), yValue);

L'extrait de code suivant illustre l'ajout de la série au graphique et la configuration de QDateTimeAxis :

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

// ...
QDateTimeAxis *axisX = new QDateTimeAxis;
axisX->setFormat("dd-MM-yyyy h:mm");
chartView->chart()->setAxisX(axisX, series);

Documentation sur les propriétés

format : QString

Cette propriété contient la chaîne de format utilisée lors de la création de l'étiquette de l'axe à partir d'un objet QDateTime.

Voir la documentation QDateTime pour plus d'informations sur la façon dont la chaîne doit être définie.

Fonctions d'accès :

QString format() const
void setFormat(QString format)

Signal Notifier :

void formatChanged(QString format)

Voir également QChart::locale.

max : QDateTime

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 :

QDateTime max() const
void setMax(QDateTime max)

Signal de notification :

void maxChanged(QDateTime max)

min : QDateTime

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 :

QDateTime min() const
void setMin(QDateTime min)

Signal de notification :

void minChanged(QDateTime min)

tickCount : int

Cette propriété contient le nombre de marques de tic-tac sur l'axe.

Fonctions d'accès :

int tickCount() const
void setTickCount(int count)

Signal Notificateur :

void tickCountChanged(int tickCount)

Member Function Documentation

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

Construit un objet axe qui est un enfant de parent.

[virtual noexcept] QDateTimeAxis::~QDateTimeAxis()

Détruit l'objet.

[signal] void QDateTimeAxis::formatChanged(QString format)

Ce signal est émis lorsque le site format de l'axe change.

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

[signal] void QDateTimeAxis::maxChanged(QDateTime 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 QDateTimeAxis::minChanged(QDateTime 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 QDateTimeAxis::rangeChanged(QDateTime min, QDateTime max)

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

void QDateTimeAxis::setRange(QDateTime min, QDateTime max)

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

void QDateTimeAxis::setTickCount(int count)

Définit le nombre de marques sur l'axe à count.

Remarque : fonction de définition de la propriété tickCount.

Voir également tickCount().

int QDateTimeAxis::tickCount() const

Renvoie le nombre de marques de tic-tac sur l'axe.

Note : Fonction Getter pour la propriété tickCount.

Voir également setTickCount().

[signal] void QDateTimeAxis::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 QDateTimeAxis::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.