Back to Qt.io
Contact Us Blog Download Qt

QValueAxis Class

Die Klasse QValueAxis fügt Werte zu den Achsen eines Diagramms hinzu. Mehr...

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

QCategoryAxis

Ö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

Reimplementierte ö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)

Detaillierte Beschreibung

Eine Wertachse kann so eingerichtet werden, dass sie eine Achsenlinie mit Häkchen, Gitterlinien und Schattierungen anzeigt. Die Werte auf der Achse werden an den Positionen der Tickmarks gezeichnet.

Der folgende Beispielcode zeigt, wie die Klasse QValueAxis verwendet werden kann:

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

Member Type Dokumentation

enum QValueAxis::TickType

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

KonstanteWertBeschreibung
QValueAxis::TicksDynamic0Häkchen werden gemäß den Werten von tickAnchor und tickInterval platziert.
QValueAxis::TicksFixed1Ticks werden gleichmäßig über den Achsenbereich platziert. Der Wert tickCount gibt die Anzahl der Ticks an.

Eigenschaft Dokumentation

labelFormat : QString

Diese Eigenschaft enthält das Beschriftungsformat der Achse.

Der Format-String unterstützt die folgenden Konvertierungsspezifizierer, Längenmodifizierer 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 true ist, beschränken sich die unterstützten Spezifizierer auf: d, e, E, f, g, G und i. Außerdem wird nur der Präzisionsmodifikator unterstützt. Der Rest der Formatierung stammt von der Standardeinstellung 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 Höchstwert auf der Achse.

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

Zugriffsfunktionen:

qreal max() const
void setMax(qreal max)

Melder-Signal:

void maxChanged(qreal max)

min : qreal

Diese Eigenschaft enthält den Mindestwert auf der Achse.

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

Zugriffsfunktionen:

qreal min() const
void setMin(qreal min)

Melder-Signal:

void minChanged(qreal min)

minorTickCount : int

Diese Eigenschaft enthält die Anzahl der kleineren Tick-Markierungen auf der Achse. Sie gibt an, wie viele Gitternetzlinien zwischen den großen Ticks auf dem Diagramm gezeichnet werden. Beschriftungen werden für kleinere Ticks nicht gezeichnet. 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 Tickmarks und Beschriftungen gestartet werden.

Zugriffsfunktionen:

qreal tickAnchor() const
void setTickAnchor(qreal anchor)

Melder-Signal:

void tickAnchorChanged(qreal anchor)

tickCount : int

Diese Eigenschaft enthält die Anzahl der Tickmarks auf der Achse. Sie gibt an, wie viele Gitternetzlinien auf dem Diagramm gezeichnet werden. Der Standardwert ist 5, und die Anzahl kann nicht kleiner als 2 sein.

Zugriffsfunktionen:

int tickCount() const
void setTickCount(int count)

Benachrichtigungssignal:

void tickCountChanged(int tickCount)

tickInterval : qreal

Diese Eigenschaft enthält das Intervall zwischen dynamisch platzierten Tickmarks und Beschriftungen.

Zugriffsfunktionen:

qreal tickInterval() const
void setTickInterval(qreal insterval)

Melder-Signal:

void tickIntervalChanged(qreal interval)

tickType : TickType

Diese Eigenschaft enthält die Positionierungsmethode für Häkchen und Beschriftungen.

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void tickTypeChanged(QValueAxis::TickType type)

Member Function Dokumentation

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

Konstruiert ein Achsenobjekt, das ein Kind von parent ist.

[virtual noexcept] QValueAxis::~QValueAxis()

Zerstört das Objekt.

[slot] void QValueAxis::applyNiceNumbers()

Ändert den aktuellen Bereich und die Anzahl der Häkchen auf der Achse, damit sie schön aussieht. Der Algorithmus betrachtet Zahlen, die in der Form von 1*10^n, 2* 10^n oder 5*10^n ausgedrückt werden können, als schöne Zahlen. Diese Zahlen werden verwendet, um die Abstände für die Tickmarks festzulegen.

Siehe auch setRange() und setTickCount().

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

Dieses Signal wird ausgegeben, wenn sich die format der Achsenbeschriftungen ändert.

Hinweis: Meldersignal für die Eigenschaft labelFormat.

[signal] void QValueAxis::maxChanged(qreal max)

Dieses Signal wird ausgegeben, wenn sich der Maximalwert der Achse, der durch max angegeben wird, ändert.

Hinweis: Meldesignal für die Eigenschaft max.

[signal] void QValueAxis::minChanged(qreal min)

Dieses Signal wird ausgegeben, wenn sich der Mindestwert der Achse, der durch min angegeben wird, ändert.

Hinweis: Meldesignal für die Eigenschaft min.

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

Dieses Signal wird ausgegeben, wenn sich die Anzahl der kleineren Tickmarks auf der Achse, angegeben durch minorTickCount, ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft minorTickCount.

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

Dieses Signal wird ausgegeben, wenn sich der Minimal- oder Maximalwert der Achse, der durch min und max festgelegt ist, ändert.

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

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

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

Dieses Signal wird ausgegeben, wenn sich die Anzahl der Tickmarks auf der Achse, angegeben durch tickCount, ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft tickCount.

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

Reimplements: QAbstractAxis::type() const.

Gibt den Typ der Achse zurück.

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