Auf dieser Seite

QDateTimeAxis Class

Die QDateTimeAxis ermöglicht die Einbindung von DateTime-Werten in die Achsen eines Diagramms. Mehr...

Header: #include <QDateTimeAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
In QML: DateTimeAxis
Erbt von: QAbstractAxis

Eigenschaften

Öffentliche Funktionen

QString labelFormat() const
QDateTime max() const
QDateTime min() const
qreal pan() const
void setLabelFormat(const QString &format)
void setMax(const QDateTime &max)
void setMin(const QDateTime &min)
void setPan(qreal pan)
void setSubTickCount(int newSubTickCount)
void setTickCount(qsizetype count)
void setTickInterval(qreal newTickInterval)
void setTimeZone(const QTimeZone &zoneId)
void setZoom(qreal zoom)
int subTickCount() const
qsizetype tickCount() const
qreal tickInterval() const
QTimeZone timeZone() const
QDateTime visualMax() const
QDateTime visualMin() const
qreal zoom() const

Signale

void labelFormatChanged(const QString &format)
void maxChanged(const QDateTime &max)
void minChanged(const QDateTime &min)
void panChanged(qreal newPan)
void subTickCountChanged()
void tickCountChanged(qsizetype count)
void tickIntervalChanged()
void timeZoneChanged(const QTimeZone &newTimeZone)
void visualMaxChanged(const QDateTime &newMax)
void visualMinChanged(const QDateTime &newMin)
void zoomChanged(qreal newZoom)

Ausführliche Beschreibung

Eine DateTime-Achse kann verwendet werden, um DateTime-Darstellungen mit Markierungen und Gitterlinien anzuzeigen. Die DateTime-Elemente auf der Achse werden an den Positionen der Markierungen angezeigt.

Eigenschaftsdokumentation

labelFormat : QString

Diese Eigenschaft legt das Format der DateTime-Beschriftungen auf der Achse fest. Mit der Format-Eigenschaft lässt sich die visuelle Darstellung des DateTime-Objekts in Tagen, Monaten und Jahren festlegen. Der Standardwert lautet dd-MMMM-yy.

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void labelFormatChanged(const QString &format)

max : QDateTime

Diese Eigenschaft enthält den Maximalwert auf der Achse

Dieser Wert kann kleiner oder größer als der Minimalwert sein. Das DateTime-Objekt wird intern als UTC gespeichert. Der Standardwert ist new Date(1980,1,1)

Zugriffsfunktionen:

QDateTime max() const
void setMax(const QDateTime &max)

Benachrichtigungssignal:

void maxChanged(const QDateTime &max)

min : QDateTime

Diese Eigenschaft enthält den Minimalwert auf der Achse

Dieser Wert kann kleiner oder größer als der Maximalwert sein. Das DateTime-Objekt wird intern als UTC gespeichert. Der Standardwert ist new Date(1970,1,1)

Zugriffsfunktionen:

QDateTime min() const
void setMin(const QDateTime &min)

Benachrichtigungssignal:

void minChanged(const QDateTime &min)

[since 6.11] pan : qreal

Diese Eigenschaft enthält den Pan-Wert der Achse.

Der „pan“-Wert verschiebt den Mittelpunkt der Achse, ohne die Intervalle des Rasters und der Beschriftungen zu beeinflussen. Der Standardwert ist 0.

Diese Aufzählung wurde in Qt 6.11 eingeführt.

Zugriffsfunktionen:

qreal pan() const
void setPan(qreal pan)

Notifier-Signal:

void panChanged(qreal newPan)

subTickCount : int

Diese Eigenschaft gibt die Anzahl der Untermarkierungen auf der Achse an. Sie gibt an, wie viele Untermarkierungen zwischen den Hauptlinien im Diagramm gezeichnet werden. Für Untermarkierungen werden keine Beschriftungen angezeigt. Der Standardwert ist 0.

Zugriffsfunktionen:

int subTickCount() const
void setSubTickCount(int newSubTickCount)

Benachrichtigungssignal:

void subTickCountChanged()

[since 6.12] tickCount : qsizetype

Diese Eigenschaft gibt die Anzahl der Hauptskalenstriche auf einer Achse an. Ist der Wert 0 oder kleiner, berechnet die Achse automatisch die entsprechende Anzahl an Skalenstrichen. Der Standardwert ist 0.

Diese Aufzählung wurde in Qt 6.12 eingeführt.

Zugriffsfunktionen:

qsizetype tickCount() const
void setTickCount(qsizetype count)

Notifier-Signal:

void tickCountChanged(qsizetype count)

[until 6.15] tickInterval : qreal

Diese Aufzählung soll in Version 6.15 als veraltet markiert werden.

Diese Eigenschaft gibt die Anzahl der Hauptskalenstriche auf einer Achse an. Ist der Wert 0 oder kleiner, berechnet die Achse automatisch die entsprechende Anzahl an Skalenstrichen. Der Standardwert ist 0. Verwenden Sie stattdessen „ tickCount “.

Zugriffsfunktionen:

qreal tickInterval() const
void setTickInterval(qreal newTickInterval)

Benachrichtigungssignal:

void tickIntervalChanged()

[since 6.11] timeZone : QTimeZone

Diese Eigenschaft enthält die Zeitzone, die für die Anzeige der Achsenbeschriftungen verwendet wird. Die zulässigen Werte basieren auf den IANA-Zeitzonen-IDs. Die Standardzeitzone ist UTC.

Diese Aufzählung wurde in Qt 6.11 eingeführt.

Zugriffsfunktionen:

QTimeZone timeZone() const
void setTimeZone(const QTimeZone &zoneId)

Notifier-Signal:

void timeZoneChanged(const QTimeZone &newTimeZone)

[read-only, since 6.11] visualMax : QDateTime

Diese Eigenschaft enthält den visuell maximalen Wert der Achse.

Diese Eigenschaft enthält einen visuellen Maximalwert der Achse, wenn die Achse verschoben oder gezoomt wurde. Der Standardwert ist QDateTimeAxis::max

Diese Aufzählung wurde in Qt 6.11 eingeführt.

Zugriffsfunktionen:

QDateTime visualMax() const

Notifier-Signal:

void visualMaxChanged(const QDateTime &newMax)

[read-only, since 6.11] visualMin : QDateTime

Diese Eigenschaft enthält den visuellen Mindestwert der Achse.

Diese Eigenschaft enthält einen visuellen Minimalwert der Achse, wenn die Achse verschoben oder gezoomt wurde. Der Standardwert ist QDateTimeAxis::min

Diese Aufzählung wurde in Qt 6.11 eingeführt.

Zugriffsfunktionen:

QDateTime visualMin() const

Notifier-Signal:

void visualMinChanged(const QDateTime &newMin)

[since 6.11] zoom : qreal

Diese Eigenschaft enthält den Zoomwert der Achse. Der Zoomwert vergrößert oder verkleinert die Achse und damit das Diagramm, ohne die Intervalle des Rasters und der Beschriftungen zu beeinflussen. Der Standardwert ist 1.

Diese Aufzählung wurde in Qt 6.11 eingeführt.

Zugriffsfunktionen:

qreal zoom() const
void setZoom(qreal zoom)

Notifier-Signal:

void zoomChanged(qreal newZoom)

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