QAbstract3DSeries Class
Die Klasse QAbstract3DSeries ist eine Basisklasse für alle Datenreihen. Mehr...
| Kopfzeile: | #include <QAbstract3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Since: | QtDataVisualization 1.0 |
| In QML: | Abstract3DSeries |
| Vererbt: | QObject |
| Geerbt von: |
Ö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) |
Detaillierte Beschreibung
Für jeden unterstützten Reihentyp gibt es geerbte Klassen: QBar3DSeries, QScatter3DSeries, und QSurface3DSeries.
Weitere Informationen finden Sie unter Qt Data Visualization Datenverarbeitung.
Dokumentation der Mitgliedstypen
enum QAbstract3DSeries::Mesh
Vordefinierte Netztypen. Nicht alle Stile sind mit allen Visualisierungstypen verwendbar.
| Konstante | Wert | Beschreibung |
|---|---|---|
QAbstract3DSeries::MeshUserDefined | 0 | Benutzerdefiniertes Netz, eingestellt ü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ägte (abgerundete) Rechteckstange. |
QAbstract3DSeries::MeshBevelCube | 7 | Leicht abgeschrägter (abgerundeter) Würfel. |
QAbstract3DSeries::MeshSphere | 8 | Sphäre. |
QAbstract3DSeries::MeshMinimal | 9 | Das minimale 3D-Netz: eine dreieckige Pyramide. Nur mit Q3DScatter verwendbar. |
QAbstract3DSeries::MeshArrow | 10 | Der Pfeil zeigt nach oben. |
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
Typ der Serie.
| Konstante | Wert | Beschreibung |
|---|---|---|
QAbstract3DSeries::SeriesTypeNone | 0 | Kein Serientyp. |
QAbstract3DSeries::SeriesTypeBar | 1 | Typ der Reihe für Q3DBars. |
QAbstract3DSeries::SeriesTypeScatter | 2 | Reihentyp für Q3DScatter. |
QAbstract3DSeries::SeriesTypeSurface | 4 | Reihentyp für Q3DSurface. |
Eigenschaft Dokumentation
baseColor : QColor
Diese Eigenschaft enthält die Grundfarbe der Serie.
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 die Basisneigung der Reihe.
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 Serie.
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 : 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.
Diese Eigenschaft 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 die Beschriftung einzelner Elemente verwendet, zum Beispiel, wenn ein Element 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) |
Benachrichtigungssignal:
| void | itemLabelFormatChanged(const QString &format) |
[since QtDataVisualization 1.1] 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 Voreinstellung ist true.
Diese Eigenschaft 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 Netz der Elemente in der Serie.
Für QSurface3DSeries enthält diese Eigenschaft den Auswahlzeiger.
Wenn das Netz MeshUserDefined ist, muss auch die Eigenschaft userDefinedMesh festgelegt werden, damit die Elemente richtig dargestellt werden können. 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 die über die Eigenschaft mesh eingestellten glatten Versionen verwendet. 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) |
Benachrichtigungssignal:
| 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(const QColor &color) |
Benachrichtigungssignal:
| void | multiHighlightColorChanged(const QColor &color) |
Siehe auch colorStyle und Q3DTheme::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 Q3DTheme::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(const QColor &color) |
Benachrichtigungssignal:
| void | singleHighlightColorChanged(const QColor &color) |
Siehe auch colorStyle und Q3DTheme::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 Q3DTheme::singleHighlightGradient.
[read-only] type : const 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 benutzerdefiniertes Mesh für Objekte.
Das benutzerdefinierte Mesh wird verwendet, wenn mesh MeshUserDefined ist.
Hinweis: Die Datei muss im Wavefront OBJ-Format vorliegen und Vertices, Normalen und UVs enthalten. Sie muss auch in Dreiecken vorliegen.
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 | visibilityChanged(bool visible) |
Member Function Dokumentation
[virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()
Löscht die abstrakte 3D-Serie.
[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(const 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.
