QAbstract3DSeries Class
Die Klasse QAbstract3DSeries ist eine Basisklasse für alle 3D-Datenreihen. Mehr...
| Kopfzeile: | #include <QAbstract3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | Abstract3DSeries |
| Vererbt: | QObject |
| Vererbt von: |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QAbstract3DSeries ist Teil von Qt Graphs C++ Classes for 3D.
Öffentliche Typen
| 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::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 | 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 | 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) |
Detaillierte Beschreibung
Für jeden unterstützten Reihentyp gibt es geerbte Klassen: QBar3DSeries, QScatter3DSeries, und QSurface3DSeries.
Weitere Informationen finden Sie unter Qt Graphs Datenverarbeitung mit 3D.
Dokumentation der Mitgliedstypen
enum class QAbstract3DSeries::Mesh
Vordefinierte Netztypen. Nicht alle Stile sind mit allen Graphenarten verwendbar.
| Konstante | Wert | Beschreibung |
|---|---|---|
QAbstract3DSeries::Mesh::UserDefined | 0 | Benutzerdefiniertes Netz, eingestellt ü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ägte (abgerundete) Rechteckstange. |
QAbstract3DSeries::Mesh::BevelCube | 7 | Leicht abgeschrägter (abgerundeter) Würfel. |
QAbstract3DSeries::Mesh::Sphere | 8 | Sphäre. |
QAbstract3DSeries::Mesh::Minimal | 9 | Das minimale 3D-Netz: eine dreieckige Pyramide. Nur mit Q3DScatterWidgetItem verwendbar. |
QAbstract3DSeries::Mesh::Arrow | 10 | Der Pfeil zeigt nach oben. |
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
Typ der Serie.
| Konstante | Wert | Beschreibung |
|---|---|---|
QAbstract3DSeries::SeriesType::None | 0 | Kein Serientyp. |
QAbstract3DSeries::SeriesType::Bar | 1 | Typ der Reihe für Q3DBarsWidgetItem. |
QAbstract3DSeries::SeriesType::Scatter | 2 | Reihentyp für Q3DScatterWidgetItem. |
QAbstract3DSeries::SeriesType::Surface | 3 | Reihentyp für Q3DSurfaceWidgetItem. |
Eigenschaft Dokumentation
baseColor : QColor
Diese Eigenschaft enthält die Grundfarbe der Serie.
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 die Basisneigung 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 Serie.
Zugriffsfunktionen:
| QGraphsTheme::ColorStyle | colorStyle() const |
| void | setColorStyle(QGraphsTheme::ColorStyle style) |
Benachrichtigungssignal:
| void | colorStyleChanged(QGraphsTheme::ColorStyle style) |
Siehe auch QGraphsTheme::ColorStyle.
[read-only] itemLabel : const QString
Diese Eigenschaft enthält die formatierte Elementbezeichnung.
Wenn es kein ausgewähltes Element gibt oder das ausgewählte Element nicht sichtbar ist, wird ein leerer String 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 Serie.
Dieses Format wird für Beschriftungen einzelner Elemente verwendet, z. B. wenn ein Element ausgewählt ist. Wie das Format interpretiert wird, hängt vom Serientyp ab.
Zugriffsfunktionen:
| QString | itemLabelFormat() const |
| void | setItemLabelFormat(const QString &format) |
Melder-Signal:
| void | itemLabelFormatChanged(const QString &format) |
Siehe auch QBar3DSeries, QScatter3DSeries, und QSurface3DSeries.
itemLabelVisible : bool
Diese Eigenschaft bestimmt die Sichtbarkeit von Elementbeschriftungen im Diagramm.
Wenn true, werden die Elementbeschriftungen als fließende Beschriftungen im Diagramm gezeichnet. Andernfalls werden die Elementbeschriftungen nicht gezeichnet. Um die Elementbeschriftung in einem externen Steuerelement anzuzeigen, wird diese Eigenschaft auf false gesetzt. Die Standardeinstellung ist true.
Zugriffsfunktionen:
| bool | isItemLabelVisible() const |
| void | setItemLabelVisible(bool visible) |
Benachrichtigungssignal:
| void | itemLabelVisibleChanged(bool visible) |
Siehe auch itemLabelFormat und itemLabel.
mesh : QAbstract3DSeries::Mesh
Diese Eigenschaft enthält das Netz der Elemente in der Serie.
Für QSurface3DSeries enthält diese Eigenschaft den Auswahlzeiger.
Wenn das Mesh MeshUserDefined ist, muss auch die Eigenschaft userDefinedMesh festgelegt werden, damit die Elemente richtig dargestellt werden. Der Standardwert hängt vom Diagrammtyp ab.
Zugriffsfunktionen:
| QAbstract3DSeries::Mesh | mesh() const |
| void | setMesh(QAbstract3DSeries::Mesh mesh) |
Benachrichtigungssignal:
| void | meshChanged(QAbstract3DSeries::Mesh mesh) |
meshRotation : QQuaternion
Diese Eigenschaft enthält die Netzdrehung, die auf alle Elemente der Serie angewendet wird.
Die Drehung sollte eine normalisierte QQuaternion sein. Bei den Serientypen, die eine objektspezifische Drehung unterstützen, werden die Drehungen miteinander multipliziert. QBar3DSeries ignoriert jede Drehung, die nicht um die y-Achse erfolgt. QSurface3DSeries wendet die Drehung nur auf den Auswahlzeiger an. Standardmäßig ist keine Drehung vorgesehen.
Zugriffsfunktionen:
| QQuaternion | meshRotation() const |
| void | setMeshRotation(const QQuaternion &rotation) |
Melder-Signal:
| void | meshRotationChanged(const QQuaternion &rotation) |
meshSmooth : bool
Diese Eigenschaft legt fest, ob glatte Versionen von vordefinierten Netzen verwendet werden.
Wenn true, werden glatte Versionen verwendet, die über die Eigenschaft mesh festgelegt wurden. Diese Eigenschaft wirkt sich nicht auf benutzerdefinierte Netze aus, die verwendet werden, wenn das Netz auf MeshUserDefined eingestellt ist. Die Standardeinstellung ist false.
Zugriffsfunktionen:
| bool | isMeshSmooth() const |
| void | setMeshSmooth(bool enable) |
Notifier-Signal:
| void | meshSmoothChanged(bool enabled) |
multiHighlightColor : QColor
Diese Eigenschaft enthält die Farbe der Hervorhebung mehrerer Elemente in der Serie.
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 Hervorhebungsgradienten für mehrere Elemente der Serie.
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 Namen der Serie.
Der Serienname kann im Format der 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 enthält die Farbe der Hervorhebung eines einzelnen Elements in der Serie.
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 Hervorhebungsgradienten des einzelnen Elements der Serie.
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 enthält den Typ der Reihe.
Zugriffsfunktionen:
| QAbstract3DSeries::SeriesType | type() const |
userDefinedMesh : QString
Diese Eigenschaft enthält den Dateinamen für ein benutzerdefiniertes Mesh für Objekte.
Das benutzerdefinierte Mesh wird verwendet, wenn mesh MeshUserDefined ist.
Hinweis: Die Datei muss im Mesh-Format QtQuick3D vorliegen. Verwenden Sie das Konvertierungstool balsam, um ein Netz aus anderen 3D-Modellformaten zu erstellen.
Zugriffsfunktionen:
| QString | userDefinedMesh() const |
| void | setUserDefinedMesh(const QString &fileName) |
Benachrichtigungssignal:
| void | userDefinedMeshChanged(const QString &fileName) |
visible : bool
Diese Eigenschaft gibt die Sichtbarkeit der Reihe an.
Wenn diese Eigenschaft false lautet, wird die Reihe nicht gerendert. Die Standardeinstellung ist true.
Zugriffsfunktionen:
| bool | isVisible() const |
| void | setVisible(bool visible) |
Benachrichtigungssignal:
| void | visibleChanged(bool visible) |
Member Function Dokumentation
[override virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()
Löscht die abstrakte 3D-Serie.
[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(QVector3D axis, float angle)
Eine Komfortfunktion zur Konstruktion einer Quaternion für die Netzrotation aus axis und angle.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch meshRotation.
© 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.
