QAbstract3DAxis Class
Die Klasse „QAbstract3DAxis“ ist eine Basisklasse für die Achsen eines 3D-Diagramms. Mehr...
| Header: | #include <QAbstract3DAxis> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | Abstract3DAxis |
| Erbt von: | QObject |
| Vererbt an: |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QAbstract3DAxis ist Teil von „Qt Graphs “ – C++-Klassen für 3D.
Öffentliche Typen
| enum class | AxisOrientation { None, X, Y, Z } |
| enum class | AxisType { None, Category, Value } |
Eigenschaften
|
|
Öffentliche Funktionen
| virtual | ~QAbstract3DAxis() override |
| bool | isAutoAdjustRange() const |
| bool | isScaleLabelsByCount() const |
| bool | isTitleFixed() const |
| bool | isTitleVisible() const |
| float | labelAutoAngle() const |
| qreal | labelSize() const |
| QStringList | labels() const |
| bool | labelsVisible() const |
| float | max() const |
| float | min() const |
| QAbstract3DAxis::AxisOrientation | orientation() const |
| void | setAutoAdjustRange(bool autoAdjust) |
| void | setLabelAutoAngle(float degree) |
| void | setLabelSize(qreal size) |
| void | setLabels(const QStringList &labels) |
| void | setLabelsVisible(bool visible) |
| void | setMax(float max) |
| void | setMin(float min) |
| void | setRange(float min, float max) |
| void | setScaleLabelsByCount(bool adjust) |
| void | setTitle(const QString &title) |
| void | setTitleFixed(bool fixed) |
| void | setTitleOffset(float offset) |
| void | setTitleVisible(bool visible) |
| QString | title() const |
| float | titleOffset() const |
| QAbstract3DAxis::AxisType | type() const |
Signale
| void | autoAdjustRangeChanged(bool autoAdjust) |
| void | labelAutoAngleChanged(float angle) |
| void | labelSizeChanged(qreal size) |
| void | labelVisibleChanged(bool visible) |
| void | labelsChanged() |
| void | maxChanged(float value) |
| void | minChanged(float value) |
| void | orientationChanged(QAbstract3DAxis::AxisOrientation orientation) |
| void | rangeChanged(float min, float max) |
| void | scaleLabelsByCountChanged(bool adjust) |
| void | titleChanged(const QString &newTitle) |
| void | titleFixedChanged(bool fixed) |
| void | titleOffsetChanged(float offset) |
| void | titleVisibleChanged(bool visible) |
Ausführliche Beschreibung
Diese Klasse definiert die Aufzählungen, Eigenschaften und Funktionen, die allen Diagrammachsen gemeinsam sind. Sie sollte nicht direkt verwendet werden, sondern stattdessen sollte eine ihrer Unterklassen verwendet werden.
Siehe auch QCategory3DAxis und QValue3DAxis.
Dokumentation zu den Mitgliedstypen
enum class QAbstract3DAxis::AxisOrientation
Die Ausrichtung des Achsenobjekts.
| Konstante | Wert |
|---|---|
QAbstract3DAxis::AxisOrientation::None | 0 |
QAbstract3DAxis::AxisOrientation::X | 1 |
QAbstract3DAxis::AxisOrientation::Y | 2 |
QAbstract3DAxis::AxisOrientation::Z | 3 |
enum class QAbstract3DAxis::AxisType
Der Typ des Achsenobjekts.
| Konstante | Wert |
|---|---|
QAbstract3DAxis::AxisType::None | 0 |
QAbstract3DAxis::AxisType::Category | 1 |
QAbstract3DAxis::AxisType::Value | 2 |
Eigenschaftsdokumentation
autoAdjustRange : bool
Diese Eigenschaft legt fest, ob die Achse den Bereich automatisch so anpasst, dass alle Daten darin Platz finden.
Zugriffsfunktionen:
| bool | isAutoAdjustRange() const |
| void | setAutoAdjustRange(bool autoAdjust) |
Benachrichtigungssignal:
| void | autoAdjustRangeChanged(bool autoAdjust) |
Siehe auch setRange(), setMin() und setMax().
labelAutoAngle : float
Diese Eigenschaft legt den maximalen Winkel fest, um den sich die Beschriftungen automatisch drehen können, wenn sich der Kamerawinkel ändert.
Der Winkel kann zwischen 0 und 90 liegen (einschließlich). Der Standardwert ist 0. Ist der Wert 0, drehen sich die Achsenbeschriftungen nicht automatisch. Ist der Wert größer als Null, versuchen die Beschriftungen, sich bis zum angegebenen Winkel zur Kamera auszurichten.
Zugriffsfunktionen:
| float | labelAutoAngle() const |
| void | setLabelAutoAngle(float degree) |
Benachrichtigungssignal:
| void | labelAutoAngleChanged(float angle) |
[since 6.9] labelSize : qreal
Größe der Beschriftung
Die Größe des Labels. Der Standardwert hierfür ist „ 1.0 “.
Diese Aufzählung wurde in Qt 6.9 eingeführt.
Zugriffsfunktionen:
| qreal | labelSize() const |
| void | setLabelSize(qreal size) |
Notifier-Signal:
| void | labelSizeChanged(qreal size) |
Siehe auch scaleLabelsByCount.
labels : QStringList
Diese Eigenschaft enthält die Beschriftungen für die Achse.
Hinweis: Das Festlegen dieser Eigenschaft für „ QValue3DAxis “ hat keine Auswirkung, da die Beschriftungen automatisch generiert werden.
Zugriffsfunktionen:
| QStringList | labels() const |
| void | setLabels(const QStringList &labels) |
Benachrichtigungssignal:
| void | labelsChanged() |
labelsVisible : bool
Diese Eigenschaft legt fest, ob die Achsenbeschriftungen in der primären Diagrammansicht sichtbar sind.
Der Standardwert lautet „ true “.
Zugriffsfunktionen:
| bool | labelsVisible() const |
| void | setLabelsVisible(bool visible) |
Benachrichtigungssignal:
| void | labelVisibleChanged(bool visible) |
max : float
Diese Eigenschaft enthält den Maximalwert auf der Achse.
Beim Festlegen dieser Eigenschaft wird der Minimalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Hinweis: Bei „ QCategory3DAxis “ wird der Index der letzten anzuzeigenden Zeile oder Spalte angegeben.
Zugriffsfunktionen:
| float | max() const |
| void | setMax(float max) |
Benachrichtigungssignal:
| void | maxChanged(float value) |
min : float
Diese Eigenschaft enthält den Minimalwert auf der Achse.
Beim Festlegen dieser Eigenschaft wird der Maximalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Hinweis: Bei „ QCategory3DAxis “ gibt dies den Index der ersten anzuzeigenden Zeile oder Spalte an.
Zugriffsfunktionen:
| float | min() const |
| void | setMin(float min) |
Benachrichtigungssignal:
| void | minChanged(float value) |
[read-only] orientation : QAbstract3DAxis::AxisOrientation
Diese Eigenschaft enthält die Ausrichtung der Achse.
Der Wert ist einer der Werte „ AxisOrientation “.
Zugriffsfunktionen:
| QAbstract3DAxis::AxisOrientation | orientation() const |
Benachrichtigungssignal:
| void | orientationChanged(QAbstract3DAxis::AxisOrientation orientation) |
[since 6.9] scaleLabelsByCount : bool
Diese Eigenschaft legt fest, ob die Beschriftungen ihre Größe automatisch an die Gesamtanzahl der Beschriftungen anpassen
Diese Aufzählung wurde in Qt 6.9 eingeführt.
Zugriffsfunktionen:
| bool | isScaleLabelsByCount() const |
| void | setScaleLabelsByCount(bool adjust) |
Notifier-Signal:
| void | scaleLabelsByCountChanged(bool adjust) |
Siehe auch ` labelSize()`.
title : QString
Diese Eigenschaft enthält die Bezeichnung der Achse.
Zugriffsfunktionen:
| QString | title() const |
| void | setTitle(const QString &title) |
Benachrichtigungssignal:
| void | titleChanged(const QString &newTitle) |
Siehe auch titleVisible und titleFixed.
titleFixed : bool
Diese Eigenschaft legt die Drehung der Achsenbeschriftungen fest.
Wenn „ false “ ist, werden die Achsenbeschriftungen in der primären Diagrammansicht ähnlich wie die Achsenbezeichnungen zur Kamera hin gedreht. Wenn „ true “ ist, werden die Achsenbeschriftungen nur um ihre eigene Achse gedreht, aber nicht zur Kamera hin ausgerichtet. Diese Eigenschaft hat keine Auswirkung, wenn der Wert der Eigenschaft „ labelAutoAngle “ Null ist. Der Standardwert ist „ true “.
Zugriffsfunktionen:
| bool | isTitleFixed() const |
| void | setTitleFixed(bool fixed) |
Benachrichtigungssignal:
| void | titleFixedChanged(bool fixed) |
Siehe auch „ labelAutoAngle “, „ title “ und „ titleVisible “.
titleOffset : float
Die Position der Achsenbezeichnung auf der Achse. Der Wert muss zwischen -1.0f und 1.0f
Zugriffsfunktionen:
| float | titleOffset() const |
| void | setTitleOffset(float offset) |
Benachrichtigungssignal:
| void | titleOffsetChanged(float offset) |
Siehe auch title und titleFixed.
titleVisible : bool
Diese Eigenschaft gibt an, ob der Achsen-Titel in der primären Diagrammansicht sichtbar ist.
Der Standardwert ist „ false “.
Zugriffsfunktionen:
| bool | isTitleVisible() const |
| void | setTitleVisible(bool visible) |
Benachrichtigungssignal:
| void | titleVisibleChanged(bool visible) |
Siehe auch „ title “ und „ titleFixed “.
[read-only] type : const QAbstract3DAxis::AxisType
Diese Eigenschaft gibt den Typ der Achse an.
Der Wert ist einer der Werte „ AxisType “.
Zugriffsfunktionen:
| QAbstract3DAxis::AxisType | type() const |
Dokumentation zu den Member-Funktionen
[override virtual noexcept] QAbstract3DAxis::~QAbstract3DAxis()
Löscht „ QAbstract3DAxis “.
[signal] void QAbstract3DAxis::rangeChanged(float min, float max)
Gibt bei einer Änderung des Bereichs den Minimal- und Maximalwert des Bereichs aus: min und max.
void QAbstract3DAxis::setRange(float min, float max)
Legt den Wertebereich der Achse von min bis max fest. Bei der Festlegung des Bereichs wird der Maximalwert gegebenenfalls angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Hinweis: Bei „ QCategory3DAxis “ wird der Indexbereich der anzuzeigenden Zeilen oder Spalten angegeben.
© 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.
