QValue3DAxis Class

Die Klasse QValue3DAxis manipuliert eine Achse in einem Diagramm. Mehr...

Kopfzeile: #include <QValue3DAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
In QML: Value3DAxis
Vererbt: 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)

Detaillierte Beschreibung

Eine Wertachse kann mit einem Wertebereich und der Anzahl der Segmente und Untersegmente versehen werden, in die der Bereich unterteilt werden soll.

Zwischen jedem Segment werden Beschriftungen gezeichnet, und zwischen jedem Segment und jedem Untersegment werden Gitterlinien gezeichnet.

Hinweis: Wenn sichtbar, gibt es immer mindestens zwei Gitternetzlinien und Beschriftungen, die die Mindest- und Höchstwerte des Bereichs angeben, da es immer mindestens ein Segment gibt.

Dokumentation der Eigenschaft

formatter : QValue3DAxisFormatter*

Diese Eigenschaft enthält den zu verwendenden Achsenformatierer.

Ein eventuell vorhandenes Formatierungselement wird gelöscht, wenn ein neues Formatierungselement festgelegt wird.

Zugriffsfunktionen:

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

Melder-Signal:

void formatterChanged(QValue3DAxisFormatter *formatter)

labelFormat : QString

Diese Eigenschaft enthält das Beschriftungsformat, das für die Beschriftungen auf dieser Achse zu verwenden ist.

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 Q3DGraphsWidgetItem::locale etwas anderes als "C" 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.

Beispiel für die Verwendung:

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

Zugriffsfunktionen:

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

Melder-Signal:

void labelFormatChanged(const QString &format)

Siehe auch formatter und Q3DGraphsWidgetItem::locale.

reversed : bool

Diese Eigenschaft gibt an, ob die Achse rückwärts gerendert wird.

Bei true wird die Achse umgekehrt 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.

Zugriffsfunktionen:

bool reversed() const
void setReversed(bool enable)

Benachrichtigungssignal:

void reversedChanged(bool enable)

segmentCount : qsizetype

Diese Eigenschaft enthält die Anzahl der Segmente auf der Achse.

Dies gibt an, wie viele Beschriftungen gezeichnet werden. Die Anzahl der zu zeichnenden Gitterlinien wird mit der Formel berechnet: segments * subsegments + 1. Der voreingestellte Standardwert ist 5. Der Wert kann nicht unter 1 liegen.

Zugriffsfunktionen:

qsizetype segmentCount() const
void setSegmentCount(qsizetype count)

Melder-Signal:

void segmentCountChanged(qsizetype count)

Siehe auch setSubSegmentCount().

subSegmentCount : qsizetype

Diese Eigenschaft enthält die Anzahl der Untersegmente innerhalb jedes Segments auf der Achse.

Zusätzlich zu den einzelnen Segmenten werden zwischen den einzelnen Untersegmenten Rasterlinien gezeichnet. Der voreingestellte Standardwert ist 1. Der Wert kann nicht unter 1 liegen.

Zugriffsfunktionen:

qsizetype subSegmentCount() const
void setSubSegmentCount(qsizetype count)

Melder-Signal:

void subSegmentCountChanged(qsizetype count)

Siehe auch setSegmentCount().

Dokumentation der Mitgliedsfunktionen

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

Konstruiert QValue3DAxis mit der angegebenen parent.

[override virtual noexcept] QValue3DAxis::~QValue3DAxis()

Zerstört QValue3DAxis.

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