Auf dieser Seite

ValueAxis QML Type

Fügt Werte zu den Achsen eines Diagramms hinzu. Mehr...

Import Statement: import QtCharts 2.12
In C++: QValueAxis
Inherits:

AbstractAxis

Status: Deprecated

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

Eigenschaften

Signale

Methoden

Ausführliche Beschreibung

Der Typ „ValueAxis“ kann so eingerichtet werden, dass eine Achsenlinie mit Skalenmarkierungen, Gitterlinien und Schattierungen angezeigt wird. Die Werte auf der Achse werden an den Positionen der Skalenmarkierungen gezeichnet.

Der folgende Beispielcode veranschaulicht die Verwendung des „ValueAxis“-Typs:

ChartView {
    ValueAxis {
        id: xAxis
        min: 0
        max: 10
    }
// Add a few series...
}

Dokumentation zu den Eigenschaften

labelFormat : string

Die Formatzeichenfolge unterstützt die folgenden Konvertierungsspezifizierer, Längenmodifikatoren und Flags, die von der Funktion ` printf() ` in der C++-Standardbibliothek bereitgestellt werden: d, i, o, x, X, f, F, e, E, g, G, c.

Wenn ChartView.localizeNumbers auf „ true “ gesetzt ist, sind die unterstützten Spezifizierer auf d, e, E, f, g, G und i beschränkt. Außerdem wird nur der Präzisionsmodifikator unterstützt. Die übrige Formatierung erfolgt gemäß der Standard-Formatierung „ QLocale “ der Anwendung.

Siehe auch QString::asprintf().

max : real

Der Maximalwert auf der Achse.

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

min : real

Der Minimalwert auf der Achse.

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

minorTickCount : int

Die Anzahl der kleinen Skalenmarkierungen auf der Achse. Diese Angabe gibt an, wie viele Gitterlinien zwischen den Hauptskalenmarkierungen im Diagramm gezeichnet werden. Für kleine Skalenmarkierungen werden keine Beschriftungen angezeigt. Der Standardwert ist 0.

tickAnchor : real [since QtCharts 2.3]

Der Basiswert, von dem aus die dynamisch platzierten Skalenmarkierungen und Beschriftungen beginnen.

Diese Eigenschaft wurde in QtCharts 2.3 eingeführt.

tickCount : int

Die Anzahl der Markierungen auf der Achse. Diese gibt an, wie viele Gitterlinien im Diagramm gezeichnet werden. Der Standardwert ist 5, und die Zahl darf nicht kleiner als 2 sein.

tickInterval : real [since QtCharts 2.3]

Der Abstand zwischen dynamisch platzierten Skalenmarkierungen und Beschriftungen.

Diese Eigenschaft wurde in QtCharts 2.3 eingeführt.

tickType : enumeration [since QtCharts 2.3]

Die Methode zur Positionierung von Häkchen und Beschriftungen.

KonstanteBeschreibung
ValueAxis.TicksDynamicDie Skalenstriche werden entsprechend den Werten „ tickAnchor “ und „ tickInterval “ platziert.
ValueAxis.TicksFixedDie Skalenstriche werden gleichmäßig über den Achsbereich verteilt. Der Wert „ tickCount “ gibt die Anzahl der Skalenstriche an.

Diese Eigenschaft wurde in QtCharts 2.3 eingeführt.

Signal-Dokumentation

rangeChanged(string min, string max)

Dieses Signal wird ausgelöst, wenn sich der Wert von „ min “ oder „ max “ der Achse ändert.

Der entsprechende Signal-Handler ist onRangeChanged.

Hinweis: Der zugehörige Handler ist „ onRangeChanged “.

Methodendokumentation

void applyNiceNumbers()

Passen Sie den aktuellen Bereich und die Anzahl der Skalenmarkierungen auf der Achse so an, dass sie ansprechend aussehen. Der Algorithmus betrachtet Zahlen, die sich als 1*10^n, 2*10^n oder 5*10^n darstellen lassen, als ansprechende Zahlen. Diese Zahlen werden zur Festlegung der Abstände zwischen den Skalenmarkierungen verwendet.

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