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

QValueAxis Class

Die Klasse „QValueAxis“ fügt den Achsen eines Diagramms Werte hinzu. Mehr dazu...

Header: #include <QValueAxis>
In QML: ValueAxis
Inherits: QAbstractAxis
Inherited By:

QCategoryAxis

Status: Deprecated

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

Öffentliche Typen

enum TickType { TicksDynamic, TicksFixed }

Eigenschaften

Öffentliche Funktionen

QValueAxis(QObject *parent = nullptr)
virtual ~QValueAxis()
QString labelFormat() const
qreal max() const
qreal min() const
int minorTickCount() const
void setLabelFormat(const QString &format)
void setMax(qreal max)
void setMin(qreal min)
void setMinorTickCount(int count)
void setRange(qreal min, qreal max)
void setTickAnchor(qreal anchor)
void setTickCount(int count)
void setTickInterval(qreal insterval)
void setTickType(QValueAxis::TickType type)
qreal tickAnchor() const
int tickCount() const
qreal tickInterval() const
QValueAxis::TickType tickType() const

Neu implementierte öffentliche Funktionen

virtual QAbstractAxis::AxisType type() const override

Öffentliche Slots

void applyNiceNumbers()

Signale

void labelFormatChanged(const QString &format)
void maxChanged(qreal max)
void minChanged(qreal min)
void minorTickCountChanged(int minorTickCount)
void rangeChanged(qreal min, qreal max)
void tickAnchorChanged(qreal anchor)
void tickCountChanged(int tickCount)
void tickIntervalChanged(qreal interval)
void tickTypeChanged(QValueAxis::TickType type)

Ausführliche Beschreibung

Eine Werteachse kann so eingerichtet werden, dass sie eine Achsenlinie mit Skalenmarkierungen, Gitterlinien und Schattierungen anzeigt. Die Werte auf der Achse werden an den Positionen der Skalenmarkierungen gezeichnet.

Der folgende Beispielcode veranschaulicht die Verwendung der Klasse `QValueAxis`:

QChartView *chartView = new QChartView;
QLineSeries *series = new QLineSeries;
// ...
chartView->chart()->addSeries(series);

QValueAxis *axisX = new QValueAxis;
axisX->setRange(10, 20.5);
axisX->setTickCount(10);
axisX->setLabelFormat("%.2f");
chartView->chart()->setAxisX(axisX, series);

Dokumentation zu den Mitgliedstypen

enum QValueAxis::TickType

Diese Aufzählung beschreibt, wie die Teilstriche und Beschriftungen auf der Achse positioniert werden.

KonstanteWertBeschreibung
QValueAxis::TicksDynamic0Die Teilstriche werden entsprechend den Werten „ tickAnchor “ und „ tickInterval “ platziert.
QValueAxis::TicksFixed1Die Teilstriche werden gleichmäßig über den Achsenbereich verteilt. Der Wert „ tickCount “ gibt die Anzahl der Teilstriche an.

Eigenschaftsdokumentation

labelFormat : QString

Diese Eigenschaft enthält das Beschriftungsformat der Achse.

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

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

Zugriffsfunktionen:

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

Notifier-Signal:

void labelFormatChanged(const QString &format)

Siehe auch „ QString::asprintf()“.

max : qreal

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:

qreal max() const
void setMax(qreal max)

Benachrichtigungssignal:

void maxChanged(qreal max)

min : qreal

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:

qreal min() const
void setMin(qreal min)

Benachrichtigungssignal:

void minChanged(qreal min)

minorTickCount : int

Diese Eigenschaft gibt die Anzahl der kleinen Skalenmarkierungen auf der Achse an. Sie gibt an, wie viele Gitterlinien zwischen den großen Skalenmarkierungen im Diagramm gezeichnet werden. Für kleine Skalenmarkierungen werden keine Beschriftungen angezeigt. Der Standardwert ist 0.

Zugriffsfunktionen:

int minorTickCount() const
void setMinorTickCount(int count)

Benachrichtigungssignal:

void minorTickCountChanged(int minorTickCount)

tickAnchor : qreal

Diese Eigenschaft enthält den Basiswert, von dem aus die dynamisch platzierten Skalenmarkierungen und Beschriftungen beginnen.

Zugriffsfunktionen:

qreal tickAnchor() const
void setTickAnchor(qreal anchor)

Benachrichtigungssignal:

void tickAnchorChanged(qreal anchor)

tickCount : int

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

Zugriffsfunktionen:

int tickCount() const
void setTickCount(int count)

Benachrichtigungssignal:

void tickCountChanged(int tickCount)

tickInterval : qreal

Diese Eigenschaft legt den Abstand zwischen dynamisch platzierten Skalenstrichen und Beschriftungen fest.

Zugriffsfunktionen:

qreal tickInterval() const
void setTickInterval(qreal insterval)

Benachrichtigungssignal:

void tickIntervalChanged(qreal interval)

tickType : TickType

Diese Eigenschaft legt die Positionierungsmethode für Markierungen und Beschriftungen fest.

Zugriffsfunktionen:

QValueAxis::TickType tickType() const
void setTickType(QValueAxis::TickType type)

Notifier-Signal:

void tickTypeChanged(QValueAxis::TickType type)

Dokumentation der Member-Funktionen

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

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

[virtual noexcept] QValueAxis::~QValueAxis()

Löscht das Objekt.

[slot] void QValueAxis::applyNiceNumbers()

Passt den aktuellen Bereich und die Anzahl der Skalenmarkierungen auf der Achse so an, dass das Ergebnis ansprechend aussieht. 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.

Siehe auch setRange() und setTickCount().

[signal] void QValueAxis::labelFormatChanged(const QString &format)

Dieses Signal wird ausgelöst, wenn sich der Wert von „ format “ der Achsenbeschriftungen ändert.

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

[signal] void QValueAxis::maxChanged(qreal 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 QValueAxis::minChanged(qreal min)

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

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

[signal] void QValueAxis::minorTickCountChanged(int minorTickCount)

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

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

[signal] void QValueAxis::rangeChanged(qreal min, qreal max)

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

void QValueAxis::setRange(qreal min, qreal max)

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

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

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

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

[override virtual] QAbstractAxis::AxisType QValueAxis::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.