Back to Qt.io
Contact Us Blog Download Qt

QDateTimeAxis Class

Die Klasse QDateTimeAxis fügt Datums- und Zeitangaben zu den Achsen eines Diagramms hinzu. Mehr...

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

Eigenschaften

Öffentliche Funktionen

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

Reimplementierte öffentliche Funktionen

virtual QAbstractAxis::AxisType type() const override

Signale

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

Detaillierte Beschreibung

QDateTimeAxis kann so eingerichtet werden, dass eine Achsenlinie mit Tickmarks, Gitterlinien und Schattierungen angezeigt wird. Die Beschriftungen können durch Einstellung eines geeigneten DateTime-Formats konfiguriert werden. QDateTimeAxis arbeitet korrekt mit Daten von 4714 BCE bis 287396 CE. Für andere Einschränkungen im Zusammenhang mit QDateTime siehe QDateTime Dokumentation.

Hinweis: QDateTimeAxis ist auf Plattformen, die qreal als float definieren, deaktiviert.

QDateTimeAxis kann mit jeder QXYSeries verwendet werden. Um einen Datenpunkt zur Serie hinzuzufügen, wird QDateTime::toMSecsSinceEpoch() verwendet:

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

Der folgende Codeschnipsel veranschaulicht das Hinzufügen der Serie zum Diagramm und die Einrichtung von 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);

Dokumentation der Eigenschaft

format : QString

Diese Eigenschaft enthält den Format-String, der verwendet wird, wenn die Beschriftung für die Achse aus einem QDateTime Objekt erstellt wird.

Siehe QDateTime Dokumentation für Informationen darüber, wie die Zeichenkette definiert werden sollte.

Zugriffsfunktionen:

QString format() const
void setFormat(QString format)

Benachrichtigungssignal:

void formatChanged(QString format)

Siehe auch QChart::locale.

max : QDateTime

Diese Eigenschaft enthält den Maximalwert auf der Achse.

Beim Festlegen dieser Eigenschaft wird der Mindestwert gegebenenfalls angepasst, um sicherzustellen, dass der Bereich gültig bleibt.

Zugriffsfunktionen:

QDateTime max() const
void setMax(QDateTime max)

Melder-Signal:

void maxChanged(QDateTime max)

min : QDateTime

Diese Eigenschaft enthält den Mindestwert auf der Achse.

Beim Einstellen dieser Eigenschaft wird der Maximalwert gegebenenfalls angepasst, um sicherzustellen, dass der Bereich gültig bleibt.

Zugriffsfunktionen:

QDateTime min() const
void setMin(QDateTime min)

Melder-Signal:

void minChanged(QDateTime min)

tickCount : int

Diese Eigenschaft enthält die Anzahl der Tickmarks auf der Achse.

Zugriffsfunktionen:

int tickCount() const
void setTickCount(int count)

Benachrichtigungssignal:

void tickCountChanged(int tickCount)

Member Function Dokumentation

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

Konstruiert ein Achsenobjekt, das ein Kind von parent ist.

[virtual noexcept] QDateTimeAxis::~QDateTimeAxis()

Zerstört das Objekt.

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

Dieses Signal wird ausgesendet, wenn sich die format der Achse ändert.

Hinweis: Meldersignal für die Eigenschaft format.

[signal] void QDateTimeAxis::maxChanged(QDateTime max)

Dieses Signal wird ausgegeben, wenn sich der Maximalwert der Achse, der durch max angegeben wird, ändert.

Hinweis: Meldesignal für die Eigenschaft max.

[signal] void QDateTimeAxis::minChanged(QDateTime min)

Dieses Signal wird ausgegeben, wenn sich der Mindestwert der Achse, der durch min angegeben wird, ändert.

Hinweis: Meldesignal für die Eigenschaft min.

[signal] void QDateTimeAxis::rangeChanged(QDateTime min, QDateTime max)

Dieses Signal wird ausgegeben, wenn sich der Minimal- oder Maximalwert der Achse, der durch min und max festgelegt ist, ändert.

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

Legt den Bereich auf der Achse von min bis max fest. Wenn min größer als max ist, kehrt diese Funktion zurück, ohne Änderungen vorzunehmen.

void QDateTimeAxis::setTickCount(int count)

Setzt die Anzahl der Tickmarks auf der Achse auf count.

Hinweis: Setter-Funktion für die Eigenschaft tickCount.

Siehe auch tickCount().

int QDateTimeAxis::tickCount() const

Gibt die Anzahl der Tickmarkierungen auf der Achse zurück.

Hinweis: Getter-Funktion für die Eigenschaft tickCount.

Siehe auch setTickCount().

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

Dieses Signal wird ausgegeben, wenn sich die Anzahl der Tickmarks auf der Achse, angegeben durch tickCount, ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft tickCount.

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

Reimplements: QAbstractAxis::type() const.

Gibt den Typ der Achse zurück.

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