Auf dieser Seite

QValue3DAxis Class

Die Klasse „QValue3DAxis“ dient zur Bearbeitung einer Achse eines Diagramms. Mehr...

Header: #include <QValue3DAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Seit: QtDataVisualization 1.0
In QML: ValueAxis3D
Erbt von: QAbstract3DAxis
Status: Veraltet

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

Eigenschaften

Öffentliche Funktionen

QValue3DAxis(QObject *parent = nullptr)
virtual ~QValue3DAxis()
QValue3DAxisFormatter *formatter() const
QString labelFormat() const
bool reversed() const
int segmentCount() const
void setFormatter(QValue3DAxisFormatter *formatter)
void setLabelFormat(const QString &format)
void setReversed(bool enable)
void setSegmentCount(int count)
void setSubSegmentCount(int count)
int subSegmentCount() const

Signale

void formatterChanged(QValue3DAxisFormatter *formatter)
void labelFormatChanged(const QString &format)
void reversedChanged(bool enable)
void segmentCountChanged(int count)
void subSegmentCountChanged(int count)

Ausführliche Beschreibung

Einer Werteachse können ein Wertebereich sowie die Anzahl der Segmente und Untersegmente zugewiesen werden, in die der Bereich unterteilt werden soll.

Zwischen den einzelnen Segmenten werden Beschriftungen eingezeichnet. Zwischen jedem Segment und jedem Untersegment werden Gitterlinien eingezeichnet.

Hinweis: Sofern sichtbar, gibt es immer mindestens zwei Gitterlinien und Beschriftungen, die den Minimal- und den Maximalwert des Bereichs angeben, da es immer mindestens ein Segment gibt.

Eigenschaftsdokumentation

[since QtDataVisualization 1.1] formatter : QValue3DAxisFormatter*

Diese Eigenschaft enthält den zu verwendenden Achsenformatierer.

Ein bereits vorhandener Formatierer wird gelöscht, wenn ein neuer Formatierer festgelegt wird.

Diese Aufzählung wurde in QtDataVisualization 1.1 eingeführt.

Zugriffsfunktionen:

QValue3DAxisFormatter *formatter() const
void setFormatter(QValue3DAxisFormatter *formatter)

Notifier-Signal:

void formatterChanged(QValue3DAxisFormatter *formatter)

labelFormat : QString

Diese Eigenschaft enthält das Beschriftungsformat, das für die Beschriftungen auf dieser Achse verwendet werden soll.

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

Wenn „ QAbstract3DGraph::locale “ einen anderen Wert als „ "C" “ hat, 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 erfolgt gemäß der Standard-Formatierung „ QLocale “ der Anwendung.

Anwendungsbeispiel:

axis->setLabelFormat("%.2f mm");

Zugriffsfunktionen:

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

Notifier-Signal:

void labelFormatChanged(const QString &format)

Siehe auch formatter und QAbstract3DGraph::locale.

[since QtDataVisualization 1.1] reversed : bool

Diese Eigenschaft legt fest, ob die Achse in umgekehrter Reihenfolge dargestellt wird.

Wenn „ true “ gilt, wird die Achse in umgekehrter Reihenfolge dargestellt, d. h., die Positionen der Minimal- und Maximalwerte werden beim Rendern des Diagramms vertauscht. Diese Eigenschaft hat keinen Einfluss auf die tatsächlichen Minimal- und Maximalwerte der Achse.

Diese Aufzählung wurde in QtDataVisualization 1.1 eingeführt.

Zugriffsfunktionen:

bool reversed() const
void setReversed(bool enable)

Notifier-Signal:

void reversedChanged(bool enable)

segmentCount : int

Diese Eigenschaft gibt die Anzahl der Segmente auf der Achse an.

Dies gibt an, wie viele Beschriftungen gezeichnet werden. Die Anzahl der zu zeichnenden Gitterlinien wird anhand der folgenden Formel berechnet: segments * subsegments + 1. Die voreingestellte Standardwert ist 5. Der Wert darf nicht kleiner als 1 sein.

Zugriffsfunktionen:

int segmentCount() const
void setSegmentCount(int count)

Benachrichtigungssignal:

void segmentCountChanged(int count)

Siehe auch ` setSubSegmentCount()`.

subSegmentCount : int

Diese Eigenschaft gibt die Anzahl der Untersegmente innerhalb jedes Segments auf der Achse an.

Zwischen jedem Teilsegment sowie zwischen den einzelnen Segmenten werden Gitterlinien gezeichnet. Die voreingestellte Standardwert ist „ 1 “. Der Wert darf nicht unter „ 1 “ liegen.

Zugriffsfunktionen:

int subSegmentCount() const
void setSubSegmentCount(int count)

Benachrichtigungssignal:

void subSegmentCountChanged(int count)

Siehe auch ` setSegmentCount()`.

Dokumentation der Mitgliedsfunktionen

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

Erstellt ein `QValue3DAxis`-Objekt mit dem angegebenen ` parent`.

[virtual noexcept] QValue3DAxis::~QValue3DAxis()

Löscht „ QValue3DAxis “.

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