QAbstract3DSeries Class
Die Klasse „QAbstract3DSeries“ ist eine Basisklasse für alle 3D-Datenreihen. Mehr...
| Header: | #include <QAbstract3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | Abstract3DSeries |
| Erbt von: | QObject |
| Vererbt an: | QBar3DSeries, „ QScatter3DSeries “ sowie QSurface3DSeries |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QAbstract3DSeries ist Teil von „Qt Graphs “ – C++-Klassen für 3D.
Öffentliche Typen
| enum class | LightingMode { Shaded, Unshaded } |
| enum class | Mesh { UserDefined, Bar, Cube, Pyramid, Cone, …, Point } |
| enum class | SeriesType { None, Bar, Scatter, Surface } |
Eigenschaften
|
|
Öffentliche Funktionen
| virtual | ~QAbstract3DSeries() override |
| QColor | baseColor() const |
| QLinearGradient | baseGradient() const |
| QGraphsTheme::ColorStyle | colorStyle() const |
| bool | isItemLabelVisible() const |
| bool | isMeshSmooth() const |
| bool | isVisible() const |
| QString | itemLabel() |
| QString | itemLabelFormat() const |
| QAbstract3DSeries::LightingMode | lightingMode() const |
| QAbstract3DSeries::Mesh | mesh() const |
| QQuaternion | meshRotation() const |
| QColor | multiHighlightColor() const |
| QLinearGradient | multiHighlightGradient() const |
| QString | name() const |
| void | setBaseColor(QColor color) |
| void | setBaseGradient(const QLinearGradient &gradient) |
| void | setColorStyle(QGraphsTheme::ColorStyle style) |
| void | setItemLabelFormat(const QString &format) |
| void | setItemLabelVisible(bool visible) |
| void | setLightingMode(QAbstract3DSeries::LightingMode lightingMode) |
| void | setMesh(QAbstract3DSeries::Mesh mesh) |
| void | setMeshAxisAndAngle(QVector3D axis, float angle) |
| void | setMeshRotation(const QQuaternion &rotation) |
| void | setMeshSmooth(bool enable) |
| void | setMultiHighlightColor(QColor color) |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
| void | setName(const QString &name) |
| void | setSingleHighlightColor(QColor color) |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
| void | setUserDefinedMesh(const QString &fileName) |
| void | setVisible(bool visible) |
| QColor | singleHighlightColor() const |
| QLinearGradient | singleHighlightGradient() const |
| QAbstract3DSeries::SeriesType | type() const |
| QString | userDefinedMesh() const |
Signale
| void | baseColorChanged(QColor color) |
| void | baseGradientChanged(const QLinearGradient &gradient) |
| void | colorStyleChanged(QGraphsTheme::ColorStyle style) |
| void | itemLabelChanged(const QString &label) |
| void | itemLabelFormatChanged(const QString &format) |
| void | itemLabelVisibleChanged(bool visible) |
| void | lightingModeChanged(QAbstract3DSeries::LightingMode lightingMode) |
| void | meshChanged(QAbstract3DSeries::Mesh mesh) |
| void | meshRotationChanged(const QQuaternion &rotation) |
| void | meshSmoothChanged(bool enabled) |
| void | multiHighlightColorChanged(QColor color) |
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
| void | nameChanged(const QString &name) |
| void | singleHighlightColorChanged(QColor color) |
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
| void | userDefinedMeshChanged(const QString &fileName) |
| void | visibleChanged(bool visible) |
Ausführliche Beschreibung
Für jeden unterstützten Serientyp gibt es abgeleitete Klassen: „ QBar3DSeries “, „ QScatter3DSeries “ und „ QSurface3DSeries “.
Weitere Informationen finden Sie unter „Qt Graphs “ – Datenverarbeitung mit 3D.
Dokumentation zu Mitgliedstypen
enum class QAbstract3DSeries::LightingMode
Voreingestellte Beleuchtungsmodi
| Konstant | Wert | Beschreibung |
|---|---|---|
QAbstract3DSeries::LightingMode::Shaded | 0 | Die Grafiken reagieren auf die Beleuchtung in Echtzeit |
QAbstract3DSeries::LightingMode::Unshaded | -1 | Die Diagramme reagieren nicht auf die Echtzeit-Beleuchtung |
enum class QAbstract3DSeries::Mesh
Vordefinierte Gittertypen. Nicht alle Stile sind mit allen Diagrammtypen verwendbar.
| Konstante | Wert | Beschreibung |
|---|---|---|
QAbstract3DSeries::Mesh::UserDefined | 0 | Benutzerdefiniertes Gitter, festgelegt über die Eigenschaft „ QAbstract3DSeries::userDefinedMesh “. |
QAbstract3DSeries::Mesh::Bar | 1 | Einfacher rechteckiger Balken. |
QAbstract3DSeries::Mesh::Cube | 2 | Einfacher Würfel. |
QAbstract3DSeries::Mesh::Pyramid | 3 | Vierseitige Pyramide. |
QAbstract3DSeries::Mesh::Cone | 4 | Einfacher Kegel. |
QAbstract3DSeries::Mesh::Cylinder | 5 | Einfacher Zylinder. |
QAbstract3DSeries::Mesh::BevelBar | 6 | Leicht abgeschrägter (abgerundeter) rechteckiger Stab. |
QAbstract3DSeries::Mesh::BevelCube | 7 | Leicht abgeschrägter (abgerundeter) Würfel. |
QAbstract3DSeries::Mesh::Sphere | 8 | Kugel. |
QAbstract3DSeries::Mesh::Minimal | 9 | Das minimale 3D-Netz: eine Dreieckspyramide. Nur mit „ Q3DScatterWidgetItem “ verwendbar. |
QAbstract3DSeries::Mesh::Arrow | 10 | Nach oben zeigender Pfeil. |
QAbstract3DSeries::Mesh::Point | 11 | 2D-Punkt. Nur mit „ Q3DScatterWidgetItem “ verwendbar. Schatten haben keinen Einfluss auf diesen Stil. Der Farbstil „ QGraphsTheme::ColorStyle::ObjectGradient “ wird von diesem Stil nicht unterstützt. |
enum class QAbstract3DSeries::SeriesType
Art der Serie.
| Konstante | Wert | Beschreibung |
|---|---|---|
QAbstract3DSeries::SeriesType::None | 0 | Kein Serientyp. |
QAbstract3DSeries::SeriesType::Bar | 1 | Reihentyp für „ Q3DBarsWidgetItem “. |
QAbstract3DSeries::SeriesType::Scatter | 2 | Reihentyp für ` Q3DScatterWidgetItem`. |
QAbstract3DSeries::SeriesType::Surface | 3 | Serientyp für „ Q3DSurfaceWidgetItem “. |
Dokumentation zu Eigenschaften
baseColor : QColor
Diese Eigenschaft enthält die Grundfarbe der Reihe.
Zugriffsfunktionen:
| QColor | baseColor() const |
| void | setBaseColor(QColor color) |
Benachrichtigungssignal:
| void | baseColorChanged(QColor color) |
Siehe auch colorStyle und QGraphsTheme::seriesColors.
baseGradient : QLinearGradient
Diese Eigenschaft enthält den Basisverlauf der Reihe.
Zugriffsfunktionen:
| QLinearGradient | baseGradient() const |
| void | setBaseGradient(const QLinearGradient &gradient) |
Benachrichtigungssignal:
| void | baseGradientChanged(const QLinearGradient &gradient) |
Siehe auch colorStyle und QGraphsTheme::seriesGradients.
colorStyle : QGraphsTheme::ColorStyle
Diese Eigenschaft enthält den Farbstil für die Reihe.
Zugriffsfunktionen:
| QGraphsTheme::ColorStyle | colorStyle() const |
| void | setColorStyle(QGraphsTheme::ColorStyle style) |
Benachrichtigungssignal:
| void | colorStyleChanged(QGraphsTheme::ColorStyle style) |
Siehe auch „ QGraphsTheme::ColorStyle “.
[read-only] itemLabel : QString
Diese Eigenschaft enthält die formatierte Bezeichnung des Elements.
Wenn kein Element ausgewählt ist oder das ausgewählte Element nicht sichtbar ist, wird eine leere Zeichenfolge zurückgegeben.
Zugriffsfunktionen:
| QString | itemLabel() |
Benachrichtigungssignal:
| void | itemLabelChanged(const QString &label) |
Siehe auch „ itemLabelFormat “.
itemLabelFormat : QString
Diese Eigenschaft enthält das Beschriftungsformat für Datenelemente in dieser Reihe.
Dieses Format wird für Einzelobjektbeschriftungen verwendet, beispielsweise wenn ein Objekt ausgewählt wird. Wie das Format interpretiert wird, hängt vom Serientyp ab.
Zugriffsfunktionen:
| QString | itemLabelFormat() const |
| void | setItemLabelFormat(const QString &format) |
Benachrichtigungssignal:
| void | itemLabelFormatChanged(const QString &format) |
Siehe auch QBar3DSeries, QScatter3DSeries und QSurface3DSeries.
itemLabelVisible : bool
Diese Eigenschaft legt fest, ob die Elementbeschriftungen im Diagramm angezeigt werden.
Wenn „ true “ gesetzt ist, werden die Elementbeschriftungen als schwebende Beschriftungen im Diagramm dargestellt. Andernfalls werden die Elementbeschriftungen nicht angezeigt. Um die Elementbeschriftung in einem externen Steuerelement anzuzeigen, wird diese Eigenschaft auf „ false “ gesetzt. Der Standardwert ist „ true “.
Zugriffsfunktionen:
| bool | isItemLabelVisible() const |
| void | setItemLabelVisible(bool visible) |
Benachrichtigungssignal:
| void | itemLabelVisibleChanged(bool visible) |
Siehe auch „ itemLabelFormat “ und „ itemLabel “.
[since 6.10] lightingMode : QAbstract3DSeries::LightingMode
Diese Eigenschaft enthält den Beleuchtungsmodus der Serie
Diese Aufzählung wurde in Qt 6.10 eingeführt.
Zugriffsfunktionen:
| QAbstract3DSeries::LightingMode | lightingMode() const |
| void | setLightingMode(QAbstract3DSeries::LightingMode lightingMode) |
Notifier-Signal:
| void | lightingModeChanged(QAbstract3DSeries::LightingMode lightingMode) |
Siehe auch LightingMode.
mesh : QAbstract3DSeries::Mesh
Diese Eigenschaft enthält das Mesh der Elemente in der Serie.
Bei „ QSurface3DSeries “ enthält diese Eigenschaft den Auswahlzeiger.
Wenn das Gitter „MeshUserDefined“ ist, muss auch die Eigenschaft „ userDefinedMesh “ festgelegt werden, damit die Elemente korrekt gerendert werden. Der Standardwert hängt vom Diagrammtyp ab.
Zugriffsfunktionen:
| QAbstract3DSeries::Mesh | mesh() const |
| void | setMesh(QAbstract3DSeries::Mesh mesh) |
Notifier-Signal:
| void | meshChanged(QAbstract3DSeries::Mesh mesh) |
meshRotation : QQuaternion
Diese Eigenschaft enthält die Mesh-Rotation, die auf alle Elemente der Serie angewendet wird.
Die Rotation sollte ein normierter Wert sein ( QQuaternion). Bei Serientypen, die eine elementbezogene Rotation unterstützen, werden die Rotationen miteinander multipliziert. „ QBar3DSeries “ ignoriert alle Rotationen, die nicht um die y-Achse erfolgen. „ QSurface3DSeries “ wendet die Rotation nur auf den Auswahlzeiger an. Standardmäßig ist keine Rotation eingestellt.
Zugriffsfunktionen:
| QQuaternion | meshRotation() const |
| void | setMeshRotation(const QQuaternion &rotation) |
Notifier-Signal:
| void | meshRotationChanged(const QQuaternion &rotation) |
meshSmooth : bool
Diese Eigenschaft legt fest, ob geglättete Versionen vordefinierter Netze verwendet werden.
Wenn „ true “ gesetzt ist, werden die über die Eigenschaft „ mesh “ festgelegten geglätteten Versionen verwendet. Diese Eigenschaft hat keine Auswirkungen auf benutzerdefinierte Gitter, die verwendet werden, wenn die Eigenschaft „Mesh“ auf „MeshUserDefined“ gesetzt ist. Der Standardwert ist „ false “.
Zugriffsfunktionen:
| bool | isMeshSmooth() const |
| void | setMeshSmooth(bool enable) |
Notifier-Signal:
| void | meshSmoothChanged(bool enabled) |
multiHighlightColor : QColor
Diese Eigenschaft legt die Hervorhebungsfarbe für mehrere Elemente der Reihe fest.
Zugriffsfunktionen:
| QColor | multiHighlightColor() const |
| void | setMultiHighlightColor(QColor color) |
Benachrichtigungssignal:
| void | multiHighlightColorChanged(QColor color) |
Siehe auch colorStyle und QGraphsTheme::multiHighlightColor.
multiHighlightGradient : QLinearGradient
Diese Eigenschaft enthält den Farbverlauf für die Hervorhebung mehrerer Elemente der Reihe.
Zugriffsfunktionen:
| QLinearGradient | multiHighlightGradient() const |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
Benachrichtigungssignal:
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
Siehe auch colorStyle und QGraphsTheme::multiHighlightGradient.
name : QString
Diese Eigenschaft enthält den Seriennamen.
Der Serienname kann im Format einer Artikelbezeichnung mit dem Tag „ @seriesName “ verwendet werden.
Zugriffsfunktionen:
| QString | name() const |
| void | setName(const QString &name) |
Benachrichtigungssignal:
| void | nameChanged(const QString &name) |
Siehe auch „ itemLabelFormat “.
singleHighlightColor : QColor
Diese Eigenschaft legt die Hervorhebungsfarbe für einzelne Elemente der Reihe fest.
Zugriffsfunktionen:
| QColor | singleHighlightColor() const |
| void | setSingleHighlightColor(QColor color) |
Benachrichtigungssignal:
| void | singleHighlightColorChanged(QColor color) |
Siehe auch colorStyle und QGraphsTheme::singleHighlightColor.
singleHighlightGradient : QLinearGradient
Diese Eigenschaft enthält den Hervorhebungsfarbverlauf für einzelne Elemente der Reihe.
Zugriffsfunktionen:
| QLinearGradient | singleHighlightGradient() const |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
Benachrichtigungssignal:
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
Siehe auch colorStyle und QGraphsTheme::singleHighlightGradient.
[read-only] type : const QAbstract3DSeries::SeriesType
Diese Eigenschaft gibt den Typ der Reihe an.
Zugriffsfunktionen:
| QAbstract3DSeries::SeriesType | type() const |
userDefinedMesh : QString
Diese Eigenschaft enthält den Dateinamen eines benutzerdefinierten Netzes für Objekte.
Das benutzerdefinierte Mesh wird verwendet, wenn „ mesh “ auf „MeshUserDefined“ gesetzt ist.
Hinweis: Die Datei muss im „ QtQuick3D “-Mesh-Format vorliegen. Verwenden Sie das Konvertierungstool „ balsam “, um ein Mesh aus anderen 3D-Modellformaten zu erstellen.
Zugriffsfunktionen:
| QString | userDefinedMesh() const |
| void | setUserDefinedMesh(const QString &fileName) |
Notifier-Signal:
| void | userDefinedMeshChanged(const QString &fileName) |
visible : bool
Diese Eigenschaft legt die Sichtbarkeit der Reihe fest.
Wenn diese Eigenschaft auf „ false “ gesetzt ist, wird die Reihe nicht dargestellt. Der Standardwert ist „ true “.
Zugriffsfunktionen:
| bool | isVisible() const |
| void | setVisible(bool visible) |
Benachrichtigungssignal:
| void | visibleChanged(bool visible) |
Dokumentation der Mitgliedsfunktionen
[override virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()
Löscht die abstrakte 3D-Serie.
[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(QVector3D axis, float angle)
Eine Hilfsfunktion zum Erstellen eines Mesh-Rotationsquaternions aus axis und angle.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch meshRotation.
© 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.
