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

DateTimeAxis QML Type

Fügt „DateTime“-Elemente zur Achse eines Diagramms hinzu. Mehr...

Import Statement: import QtGraphs
In C++: QDateTimeAxis
Inherits:

AbstractAxis

Eigenschaften

Signale

Methoden

Ausführliche Beschreibung

Eine DateTime-Achse kann verwendet werden, um Datums- und Zeitangaben mit Markierungen und Gitterlinien darzustellen. Die Datums- und Zeitangaben auf der Achse werden an den Positionen der Markierungen angezeigt.

Der folgende Beispielcode veranschaulicht die Verwendung des Typs „DateTimeAxis“:

GraphsView {
    axisX: DateTimeAxis {
        min: new Date(2000,1,1)
        max: new Date(1970,1,1)
    }
    LineSeries {
        // Add a few XYPoint data...
    }
}

Dokumentation zu den Eigenschaften

labelFormat : string

Das Format der DateTime-Beschriftungen auf der Achse: Mit der Eigenschaft „format“ lässt sich die visuelle Darstellung des DateTime-Objekts in Tagen, Monaten und Jahren festlegen. Der Standardwert lautet dd-MMMM-yy.

max : real

Der 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)`.

min : real

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

pan : real [since 6.11]

Der Pan-Wert der Achse.

Der Pan-Wert verschiebt den Mittelpunkt der Achse, ohne die Abstände des Rasters und der Beschriftungen zu beeinflussen. Der Standardwert ist 0.

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

subTickCount : int

Die Anzahl der Untermarkierungen auf der Achse. Dieser Wert gibt an, wie viele Untermarkierungen zwischen den Hauptlinien im Diagramm eingezeichnet werden. Für Untermarkierungen werden keine Beschriftungen angezeigt. Der Standardwert ist 0.

tickCount : real [since 6.12]

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

Diese Eigenschaft wurde in Qt 6.12 eingeführt.

tickInterval : real [until 6.15]

Diese Eigenschaft wird in Version 6.15 als veraltet markiert.

Die Anzahl der Haupt-Ticks, die auf einer Achse platziert werden. Ist der Wert 0 oder kleiner, berechnet die Achse automatisch die entsprechende Anzahl an Ticks. Der Standardwert ist 0. Verwenden Sie stattdessen „ tickCount “.

timeZone : QTimeZone [since 6.11]

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 Eigenschaft wurde in Qt 6.11 eingeführt.

visualMax : real [read-only, since 6.11]

Der visuelle Maximalwert der Achse.

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

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

visualMin : real [read-only, since 6.11]

Der visuelle Mindestwert der Achse.

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

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

zoom : real [since 6.11]

Der Zoomfaktor der Achse. Der Zoomfaktor vergrößert oder verkleinert die Achse und damit das Diagramm, ohne die Abstände der Gitterlinien und Beschriftungen zu beeinflussen. Der Standardwert ist 1.

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

Signal-Dokumentation

labelFormatChanged(string format)

Dieses Signal wird ausgelöst, wenn sich die format der Achsenbeschriftungen ändert.

Hinweis: Der entsprechende Handler lautet „ onLabelFormatChanged “.

maxChanged(DateTime max)

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

Hinweis: Der entsprechende Handler lautet „ onMaxChanged “.

minChanged(DateTime min)

Dieses Signal wird ausgelöst, wenn sich der durch min angegebene Mindestwert der Achse ändert.

Hinweis: Der zugehörige Handler lautet onMinChanged.

rangeChanged(real min, real max)

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

Hinweis: Der entsprechende Handler lautet „ onRangeChanged “.

subTickCountChanged(int subTickCount)

Dieses Signal wird ausgelöst, wenn sich die Anzahl der Subticks auf der Achse ändert, die durch ` subTickCount` festgelegt ist.

Hinweis: Der zugehörige Handler lautet „ onSubTickCountChanged “.

[since 6.12] tickCountChanged(real count)

Dieses Signal wird ausgelöst, wenn sich der Wert „ tickCount “ der Achse, die durch „ count “ angegeben ist, ändert.

Hinweis: Der entsprechende Handler ist „ onTickCountChanged “.

Dieses Signal wurde in Qt 6.12 eingeführt.

[until 6.15] tickIntervalChanged(real tickInterval)

Dieses Signal soll in Version 6.15 als veraltet markiert werden.

Dieses Signal wird ausgelöst, wenn sich der Wert des Tick-Intervalls, der durch ` tickInterval` festgelegt ist, ändert. Verwenden Sie stattdessen ` tickCountChanged `.

Hinweis: Der entsprechende Handler ist ` onTickIntervalChanged`.

[since 6.11] timeZoneChanged()

Dieses Signal wird bei einer Änderung der Zeitzone ausgelöst. Es enthält einen Zeichenfolgenwert für die festgelegte IANA-Zeitzonen-ID.

Hinweis: Der entsprechende Handler lautet „ onTimeZoneChanged “.

Dieses Signal wurde in Qt 6.11 eingeführt.

[since 6.11] zoomChanged()

Dieses Signal wird ausgelöst, wenn sich der Zoomwert ändert.

Hinweis: Der entsprechende Handler lautet „ onZoomChanged “.

Dieses Signal wurde in Qt 6.11 eingeführt.

Methodendokumentation

[since 6.11] string timeZoneAsString()

Gibt die auf der IANA basierende Zonen-ID von „ QDateTimeAxis::timeZone “ als Zeichenkette zurück.

Diese Methode wurde in Qt 6.11 eingeführt.

Siehe auch „ timeZone “.

[since 6.11] QTimeZone timeZoneFromString(string zoneId)

Gibt den „ QTimeZone “ zurück, der dem IANA-basierten „ zoneId “ entspricht.

Hinweis: Dies ist die Konvertierungsmethode zum Festlegen der „ timeZone “.

Diese Methode wurde in Qt 6.11 eingeführt.

Siehe auch „ QDateTimeAxis::timeZone “ und „ timeZoneAsString “.

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