QAbstract3DSeries Class
Die Klasse „QAbstract3DSeries“ ist eine Basisklasse für alle Datenreihen. Mehr...
| Header: | #include <QAbstract3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Seit: | QtDataVisualization 1.0 |
| In QML: | Abstract3DSeries |
| Erbt von: | QObject |
| Vererbt an: | QBar3DSeries, „ QScatter3DSeries “ sowie QSurface3DSeries |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Öffentliche Typen
| enum | Mesh { MeshUserDefined, MeshBar, MeshCube, MeshPyramid, MeshCone, …, MeshPoint } |
| enum | SeriesType { SeriesTypeNone, SeriesTypeBar, SeriesTypeScatter, SeriesTypeSurface } |
Eigenschaften
|
|
Öffentliche Funktionen
| virtual | ~QAbstract3DSeries() |
| QColor | baseColor() const |
| QLinearGradient | baseGradient() const |
| Q3DTheme::ColorStyle | colorStyle() const |
| bool | isItemLabelVisible() const |
| bool | isMeshSmooth() const |
| bool | isVisible() const |
| QString | itemLabel() const |
| QString | itemLabelFormat() const |
| QAbstract3DSeries::Mesh | mesh() const |
| QQuaternion | meshRotation() const |
| QColor | multiHighlightColor() const |
| QLinearGradient | multiHighlightGradient() const |
| QString | name() const |
| void | setBaseColor(const QColor &color) |
| void | setBaseGradient(const QLinearGradient &gradient) |
| void | setColorStyle(Q3DTheme::ColorStyle style) |
| void | setItemLabelFormat(const QString &format) |
| void | setItemLabelVisible(bool visible) |
| void | setMesh(QAbstract3DSeries::Mesh mesh) |
| void | setMeshAxisAndAngle(const QVector3D &axis, float angle) |
| void | setMeshRotation(const QQuaternion &rotation) |
| void | setMeshSmooth(bool enable) |
| void | setMultiHighlightColor(const QColor &color) |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
| void | setName(const QString &name) |
| void | setSingleHighlightColor(const 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(const QColor &color) |
| void | baseGradientChanged(const QLinearGradient &gradient) |
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
| void | itemLabelChanged(const QString &label) |
| void | itemLabelFormatChanged(const QString &format) |
| void | itemLabelVisibilityChanged(bool visible) |
| void | meshChanged(QAbstract3DSeries::Mesh mesh) |
| void | meshRotationChanged(const QQuaternion &rotation) |
| void | meshSmoothChanged(bool enabled) |
| void | multiHighlightColorChanged(const QColor &color) |
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
| void | nameChanged(const QString &name) |
| void | singleHighlightColorChanged(const QColor &color) |
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
| void | userDefinedMeshChanged(const QString &fileName) |
| void | visibilityChanged(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 Data Visualization – Datenverarbeitung“.
Dokumentation zu Mitgliedstypen
enum QAbstract3DSeries::Mesh
Vordefinierte Gittertypen. Nicht alle Stile sind mit allen Visualisierungstypen verwendbar.
| Konstante | Wert | Beschreibung |
|---|---|---|
QAbstract3DSeries::MeshUserDefined | 0 | Benutzerdefiniertes Gitter, festgelegt über die Eigenschaft „ QAbstract3DSeries::userDefinedMesh “. |
QAbstract3DSeries::MeshBar | 1 | Einfacher rechteckiger Balken. |
QAbstract3DSeries::MeshCube | 2 | Einfacher Würfel. |
QAbstract3DSeries::MeshPyramid | 3 | Vierseitige Pyramide. |
QAbstract3DSeries::MeshCone | 4 | Einfacher Kegel. |
QAbstract3DSeries::MeshCylinder | 5 | Einfacher Zylinder. |
QAbstract3DSeries::MeshBevelBar | 6 | Leicht abgeschrägter (abgerundeter) rechteckiger Stab. |
QAbstract3DSeries::MeshBevelCube | 7 | Leicht abgeschrägter (abgerundeter) Würfel. |
QAbstract3DSeries::MeshSphere | 8 | Kugel. |
QAbstract3DSeries::MeshMinimal | 9 | Das minimale 3D-Netz: eine dreieckige Pyramide. Nur mit Q3DScatter verwendbar. |
QAbstract3DSeries::MeshArrow | 10 | Nach oben zeigender Pfeil. |
QAbstract3DSeries::MeshPoint | 11 | 2D-Punkt. Nur mit Q3DScatter verwendbar. Schatten haben keinen Einfluss auf diesen Stil. Der Farbstil „ Q3DTheme::ColorStyleObjectGradient “ wird von diesem Stil nicht unterstützt. |
enum QAbstract3DSeries::SeriesType
Art der Serie.
| Konstante | Wert | Beschreibung |
|---|---|---|
QAbstract3DSeries::SeriesTypeNone | 0 | Kein Serientyp. |
QAbstract3DSeries::SeriesTypeBar | 1 | Reihentyp für Q3DBars. |
QAbstract3DSeries::SeriesTypeScatter | 2 | Reihenart für Q3DScatter. |
QAbstract3DSeries::SeriesTypeSurface | 4 | Reihentyp für Q3DSurface. |
Dokumentation der Eigenschaften
baseColor : QColor
Diese Eigenschaft enthält die Grundfarbe der Reihe.
Zugriffsfunktionen:
| QColor | baseColor() const |
| void | setBaseColor(const QColor &color) |
Benachrichtigungssignal:
| void | baseColorChanged(const QColor &color) |
Siehe auch colorStyle und Q3DTheme::baseColors.
baseGradient : QLinearGradient
Diese Eigenschaft enthält den Basisverlauf der Serie.
Zugriffsfunktionen:
| QLinearGradient | baseGradient() const |
| void | setBaseGradient(const QLinearGradient &gradient) |
Benachrichtigungssignal:
| void | baseGradientChanged(const QLinearGradient &gradient) |
Siehe auch „ colorStyle “ und „ Q3DTheme::baseGradients “.
colorStyle : Q3DTheme::ColorStyle
Diese Eigenschaft enthält den Farbstil für die Reihe.
Zugriffsfunktionen:
| Q3DTheme::ColorStyle | colorStyle() const |
| void | setColorStyle(Q3DTheme::ColorStyle style) |
Benachrichtigungssignal:
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
Siehe auch Q3DTheme::ColorStyle.
[read-only, since QtDataVisualization 1.1] 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 Zeichenkette zurückgegeben.
Diese Aufzählung wurde in QtDataVisualization 1.1 eingeführt.
Zugriffsfunktionen:
| QString | itemLabel() const |
Notifier-Signal:
| void | itemLabelChanged(const QString &label) |
Siehe auch „ itemLabelFormat “.
itemLabelFormat : QString
Diese Eigenschaft enthält das Beschriftungsformat für Datenelemente in dieser Serie.
Dieses Format wird für Einzelobjekt-Beschriftungen verwendet, beispielsweise wenn ein Objekt ausgewählt wird. Wie das Format interpretiert wird, hängt vom Serientyp ab: QBar3DSeries, QScatter3DSeries, QSurface3DSeries.
Zugriffsfunktionen:
| QString | itemLabelFormat() const |
| void | setItemLabelFormat(const QString &format) |
Notifier-Signal:
| void | itemLabelFormatChanged(const QString &format) |
[since QtDataVisualization 1.1] itemLabelVisible : bool
Diese Eigenschaft legt fest, ob die Elementbeschriftungen im Diagramm angezeigt werden.
Wenn „ true “ gesetzt ist, werden Elementbeschriftungen als schwebende Beschriftungen im Diagramm gezeichnet. Andernfalls werden Elementbeschriftungen nicht gezeichnet. Um die Elementbeschriftung in einem externen Steuerelement anzuzeigen, wird diese Eigenschaft auf „ false “ gesetzt. Der Standardwert ist „ true “.
Diese Aufzählung wurde in QtDataVisualization 1.1 eingeführt.
Zugriffsfunktionen:
| bool | isItemLabelVisible() const |
| void | setItemLabelVisible(bool visible) |
Notifier-Signal:
| void | itemLabelVisibilityChanged(bool visible) |
Siehe auch „ itemLabelFormat “ und „ itemLabel “.
mesh : Mesh
Diese Eigenschaft enthält das Mesh der Elemente in der Serie.
Bei „QSurface3DSeries“ enthält diese Eigenschaft den Auswahlzeiger.
Wenn das Mesh „ MeshUserDefined “ ist, muss auch die Eigenschaft „ userDefinedMesh “ gesetzt 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-Drehung, die auf alle Elemente der Serie angewendet wird.
Die Rotation sollte ein normierter Vektor QQuaternion sein. 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 “ eingestellt 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 Gitteroption 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(const QColor &color) |
Benachrichtigungssignal:
| void | multiHighlightColorChanged(const QColor &color) |
Siehe auch colorStyle und Q3DTheme::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 Q3DTheme::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(const QColor &color) |
Benachrichtigungssignal:
| void | singleHighlightColorChanged(const QColor &color) |
Siehe auch colorStyle und Q3DTheme::singleHighlightColor.
singleHighlightGradient : QLinearGradient
Diese Eigenschaft enthält den Hervorhebungsverlauf 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 Q3DTheme::singleHighlightGradient.
[read-only] type : const SeriesType
Diese Eigenschaft gibt den Typ der Reihe an.
Zugriffsfunktionen:
| QAbstract3DSeries::SeriesType | type() const |
userDefinedMesh : QString
Diese Eigenschaft enthält den Dateinamen für ein benutzerdefiniertes Netz für Objekte.
Das benutzerdefinierte Mesh wird verwendet, wenn „ mesh “ auf „ MeshUserDefined “ gesetzt ist.
Hinweis: Die Datei muss im Wavefront-OBJ-Format vorliegen und Scheitelpunkte, Normalen sowie UV-Koordinaten enthalten. Außerdem muss sie aus Dreiecken bestehen.
Zugriffsfunktionen:
| QString | userDefinedMesh() const |
| void | setUserDefinedMesh(const QString &fileName) |
Notifier-Signal:
| void | userDefinedMeshChanged(const QString &fileName) |
visible : bool
Diese Eigenschaft legt die Sichtbarkeit der Serie fest.
Wenn diese Eigenschaft auf „ false “ gesetzt ist, wird die Reihe nicht gerendert. Der Standardwert ist „ true “.
Zugriffsfunktionen:
| bool | isVisible() const |
| void | setVisible(bool visible) |
Benachrichtigungssignal:
| void | visibilityChanged(bool visible) |
Dokumentation der Mitgliedsfunktionen
[virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()
Löscht die abstrakte 3D-Serie.
[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(const QVector3D &axis, float angle)
Eine Hilfsfunktion zum Erstellen eines Quaternions für die Mesh-Drehung 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.
