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 Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
In QML: Value3DAxis
Erbt von: QAbstract3DAxis

Eigenschaften

Öffentliche Funktionen

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

Signale

void formatterChanged(QValue3DAxisFormatter *formatter)
void labelFormatChanged(const QString &format)
void reversedChanged(bool enable)
void segmentCountChanged(qsizetype count)
void subSegmentCountChanged(qsizetype 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 jedem Segment werden Beschriftungen eingezeichnet, und zwischen jedem Segment und jedem Untersegment werden Gitterlinien eingezeichnet.

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

Eigenschaftsdokumentation

formatter : QValue3DAxisFormatter*

Diese Eigenschaft enthält den zu verwendenden Achsenformatierer.

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

Zugriffsfunktionen:

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

Benachrichtigungssignal:

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 der Funktion „ printf() “ in der Standard-C++-Bibliothek bereitgestellt werden: d, i, o, x, X, f, F, e, E, g, G, c.

Wenn „ Q3DGraphsWidgetItem::locale “ ein anderer Wert als „ "C" “ ist, sind die unterstützten Konvertierungsbezeichner 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 Q3DGraphsWidgetItem::locale.

reversed : bool

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

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

Zugriffsfunktionen:

bool reversed() const
void setReversed(bool enable)

Benachrichtigungssignal:

void reversedChanged(bool enable)

segmentCount : qsizetype

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. Der voreingestellte Standardwert lautet 5. Der Wert darf nicht unter 1 liegen.

Zugriffsfunktionen:

qsizetype segmentCount() const
void setSegmentCount(qsizetype count)

Benachrichtigungssignal:

void segmentCountChanged(qsizetype count)

Siehe auch ` setSubSegmentCount()`.

subSegmentCount : qsizetype

Diese Eigenschaft gibt die Anzahl der Teilsegmente 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:

qsizetype subSegmentCount() const
void setSubSegmentCount(qsizetype count)

Benachrichtigungssignal:

void subSegmentCountChanged(qsizetype count)

Siehe auch ` setSegmentCount()`.

Dokumentation der Member-Funktionen

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

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

[override 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.