Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

QDateTimeAxis Class

Die Klasse „QDateTimeAxis“ fügt Datums- und Zeitangaben zur Achse eines Diagramms hinzu. Mehr...

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

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

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

Neu implementierte ö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)

Ausführliche Beschreibung

QDateTimeAxis kann so eingerichtet werden, dass eine Achsenlinie mit Teilstrichen, Gitterlinien und Schattierungen angezeigt wird. Die Beschriftungen lassen sich durch Festlegen eines geeigneten DateTime-Formats konfigurieren. QDateTimeAxis funktioniert korrekt mit Datumsangaben von 4714 v. Chr. bis 287396 n. Chr. Weitere Einschränkungen in Bezug auf „ QDateTime “ finden Sie in der Dokumentation unter QDateTime.

Hinweis: QDateTimeAxis ist auf Plattformen deaktiviert, auf denen `qreal` als `float` definiert ist.

Ausschnitt aus einem Screenshot, in dem die x-Achse Datums- und Zeitangaben darstellt

QDateTimeAxis kann mit jedem „ QXYSeries “ verwendet werden. Um der Reihe einen Datenpunkt 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 Codeausschnitt veranschaulicht das Hinzufügen der Reihe 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);

Eigenschaftsdokumentation

format : QString

Diese Eigenschaft enthält die Formatzeichenfolge, die beim Erstellen der Achsenbeschriftung aus einem „ QDateTime “-Objekt verwendet wird.

Informationen dazu, wie die Zeichenfolge definiert werden sollte, finden Sie in der Dokumentation zu „ QDateTime “.

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 Minimalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.

Zugriffsfunktionen:

QDateTime max() const
void setMax(QDateTime max)

Benachrichtigungssignal:

void maxChanged(QDateTime max)

min : QDateTime

Diese Eigenschaft enthält den Minimalwert auf der Achse.

Beim Festlegen dieser Eigenschaft wird der Maximalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.

Zugriffsfunktionen:

QDateTime min() const
void setMin(QDateTime min)

Benachrichtigungssignal:

void minChanged(QDateTime min)

tickCount : int

Diese Eigenschaft gibt die Anzahl der Skalenmarkierungen auf der Achse an.

Zugriffsfunktionen:

int tickCount() const
void setTickCount(int count)

Benachrichtigungssignal:

void tickCountChanged(int tickCount)

Dokumentation der Member-Funktionen

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

Erstellt ein Achsenobjekt, das ein untergeordnetes Element von „ parent “ ist.

[virtual noexcept] QDateTimeAxis::~QDateTimeAxis()

Löscht das Objekt.

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

Dieses Signal wird ausgegeben, wenn sich die Eigenschaft „ format “ der Achse ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft „ format “.

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

Dieses Signal wird ausgelöst, wenn sich der durch „ max “ festgelegte Maximalwert der Achse ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ max “.

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

Dieses Signal wird ausgelöst, wenn sich der durch „ min “ festgelegte Minimalwert der Achse ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ min “.

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

Dieses Signal wird ausgelöst, wenn sich der durch „ min “ und „ max “ festgelegte Minimal- oder Maximalwert der Achse ändert.

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

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

void QDateTimeAxis::setTickCount(int count)

Legt die Anzahl der Skalenmarkierungen auf der Achse auf „ count “ fest.

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

Siehe auch ` tickCount()`.

int QDateTimeAxis::tickCount() const

Gibt die Anzahl der Skalenmarkierungen 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 ausgelöst, wenn sich die Anzahl der Skalenmarkierungen auf der Achse, die durch „ tickCount “ festgelegt ist, ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft „ tickCount “.

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

Implementiert neu: ` QAbstractAxis::type()` const.

Gibt den Typ der Achse zurück.

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