QValue3DAxis Class

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

Kopfzeile: #include <QValue3DAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Since: QtDataVisualization 1.0
In QML: ValueAxis3D
Vererbt: QAbstract3DAxis

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)

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 den einzelnen Segmenten werden Beschriftungen gezeichnet. Zwischen jedem Segment und jedem Untersegment werden Gitternetzlinien gezeichnet.

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

Dokumentation der Eigenschaft

[since QtDataVisualization 1.1] formatter : QValue3DAxisFormatter*

Diese Eigenschaft enthält den zu verwendenden Achsenformatierer.

Ein vorhandener Formatter wird gelöscht, wenn ein neuer Formatter gesetzt wird.

Diese Eigenschaft 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 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 QAbstract3DGraph::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 QAbstract3DGraph::locale.

[since QtDataVisualization 1.1] reversed : bool

Diese Eigenschaft legt fest, 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.

Diese Eigenschaft 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 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:

int segmentCount() const
void setSegmentCount(int count)

Melder-Signal:

void segmentCountChanged(int count)

Siehe auch setSubSegmentCount().

subSegmentCount : int

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:

int subSegmentCount() const
void setSubSegmentCount(int count)

Melder-Signal:

void subSegmentCountChanged(int count)

Siehe auch setSegmentCount().

Dokumentation der Mitgliedsfunktionen

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

Konstruiert QValue3DAxis mit der angegebenen parent.

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