QScatter3DSeries Class
Die Klasse „QScatter3DSeries“ stellt eine Datenreihe in einem 3D-Streudiagramm dar. Mehr...
| Header: | #include <QScatter3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | Scatter3DSeries |
| Erbt von: | QAbstract3DSeries |
| Vererbt an: |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QScatter3DSeries ist Teil von „Qt Graphs “ – C++-Klassen für 3D.
Eigenschaften
|
Öffentliche Funktionen
| QScatter3DSeries(QObject *parent = nullptr) | |
| QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QScatter3DSeries() override |
| QValue3DAxis * | axisX() const |
| QValue3DAxis * | axisY() const |
| QValue3DAxis * | axisZ() const |
| void | clearArray() |
| void | clearScaleArray() |
| const QScatterDataArray & | dataArray() const & |
| QScatterDataArray | dataArray() && |
| QScatterDataProxy * | dataProxy() const |
| float | itemSize() const |
| void | resetAxisX() |
| void | resetAxisY() |
| void | resetAxisZ() |
| const QList<QVector3D> & | scaleArray() const & |
| QList<QVector3D> | scaleArray() && |
| qsizetype | selectedItem() const |
| void | setAxisX(QValue3DAxis *axis) |
| void | setAxisY(QValue3DAxis *axis) |
| void | setAxisZ(QValue3DAxis *axis) |
| void | setDataArray(const QScatterDataArray &newDataArray) |
| void | setDataProxy(QScatterDataProxy *proxy) |
| void | setItemSize(float size) |
| void | setScaleArray(const QList<QVector3D> &newScaleArray) |
| void | setSelectedItem(qsizetype index) |
Signale
| void | axisXChanged(QValue3DAxis *axis) |
| void | axisYChanged(QValue3DAxis *axis) |
| void | axisZChanged(QValue3DAxis *axis) |
| void | dataArrayChanged(const QScatterDataArray &array) |
| void | dataProxyChanged(QScatterDataProxy *proxy) |
| void | itemSizeChanged(float size) |
| void | scaleArrayChanged(const QList<QVector3D> &scaleArray) |
| void | selectedItemChanged(qsizetype index) |
Statische öffentliche Mitglieder
| qsizetype | invalidSelectionIndex() |
Detaillierte Beschreibung
Diese Klasse verwaltet die serienspezifischen visuellen Elemente sowie die Seriendaten (über einen Daten-Proxy).
In Bezug auf die Beziehung zwischen Proxy und Serie ist es wichtig, einige Schlüsselpunkte hervorzuheben. In diesem Zusammenhang werden Daten in Serien gespeichert, und Benutzer können über die Serie auf den Datensatz zugreifen. Diese Serie wird durch ein Proxy-Objekt gesteuert oder repräsentiert. Somit kann der Proxy verwendet werden, um verschiedene Operationen an den Daten durchzuführen und den eigentlichen Datensatz zu aktualisieren. Um den Datensatz zu bearbeiten, muss jedoch eine mit diesem Proxy verknüpfte Serie erstellt werden.
Wenn für die Reihe kein Daten-Proxy explizit festgelegt ist, erstellt die Reihe einen Standard-Proxy. Das Festlegen eines anderen Proxys löscht den bestehenden Proxy und alle der Reihe hinzugefügten Daten.
QScatter3DSeries unterstützt die folgenden Format-Tags für „ QAbstract3DSeries::setItemLabelFormat “():
| @xTitle | Titel der x-Achse |
| @yTitle | Titel der y-Achse |
| @zTitle | Titel von der z-Achse |
| @xLabel | Der Wert des Elements wird im Format der x-Achse dargestellt. Weitere Informationen finden Sie unter QValue3DAxis::labelFormat. |
| @yLabel | Elementwert, formatiert gemäß dem Format der y-Achse. Weitere Informationen finden Sie unter QValue3DAxis::labelFormat. |
| @zLabel | Der Wert des Elements wird im Format der z-Achse dargestellt. Weitere Informationen finden Sie unter QValue3DAxis::labelFormat. |
| @seriesName | Name der Reihe |
Beispiel:
proxy->setItemLabelFormat(QStringLiteral("@yTitle for (@xLabel, @zLabel): %.1f"));Siehe auch „Qt Graphs: Datenverarbeitung mit 3D“.
Eigenschaftsdokumentation
[since 6.11] axisX : QValue3DAxis*
Verwendet eine zusätzliche X-Achse für die Reihe. Wenn eine Achse angegeben wird, wird die Reihe an die Minimal- und Maximalwerte der Achse angepasst.
Diese Aufzählung wurde in Qt 6.11 eingeführt.
Zugriffsfunktionen:
| QValue3DAxis * | axisX() const |
| void | setAxisX(QValue3DAxis *axis) |
| void | resetAxisX() |
Notifier-Signal:
| void | axisXChanged(QValue3DAxis *axis) |
[since 6.11] axisY : QValue3DAxis*
Verwendet eine zusätzliche Y-Achse für die Reihe. Wenn eine Achse angegeben wird, wird die Reihe an die Minimal- und Maximalwerte dieser Achse angepasst.
Diese Aufzählung wurde in Qt 6.11 eingeführt.
Zugriffsfunktionen:
| QValue3DAxis * | axisY() const |
| void | setAxisY(QValue3DAxis *axis) |
| void | resetAxisY() |
Notifier-Signal:
| void | axisYChanged(QValue3DAxis *axis) |
[since 6.11] axisZ : QValue3DAxis*
Enthält eine zusätzliche Z-Achse für die Reihe. Wenn eine Achse angegeben wird, wird die Reihe an die Minimal- und Maximalwerte dieser Achse angepasst.
Diese Aufzählung wurde in Qt 6.11 eingeführt.
Zugriffsfunktionen:
| QValue3DAxis * | axisZ() const |
| void | setAxisZ(QValue3DAxis *axis) |
| void | resetAxisZ() |
Notifier-Signal:
| void | axisZChanged(QValue3DAxis *axis) |
dataArray : QScatterDataArray
Datenarray für die Reihe.
Enthält den Verweis auf das Datenarray.
Das Signal „dataArrayChanged“ wird ausgelöst, wenn das Datenarray festgelegt wird, es sei denn, „ newDataArray “ ist identisch mit dem vorherigen Wert.
Hinweis: Bevor Sie irgendwelche Aktionen bezüglich des Datenarrays durchführen, muss für den entsprechenden Proxy eine Serie angelegt werden.
Zugriffsfunktionen:
| const QScatterDataArray & | dataArray() const & |
| QScatterDataArray | dataArray() && |
| void | setDataArray(const QScatterDataArray &newDataArray) |
Notifier-Signal:
| void | dataArrayChanged(const QScatterDataArray &array) |
Siehe auch ` clearArray()`.
dataProxy : QScatterDataProxy*
Diese Eigenschaft enthält den aktiven Datenproxy.
Legt den aktiven Datenproxy für die Reihe auf „ proxy “ fest. Die Reihe übernimmt die Verantwortung für jeden ihr zugewiesenen Proxy und löscht alle zuvor festgelegten Proxys, sobald ein neuer hinzugefügt wird. Das Argument „ proxy “ darf weder null sein noch auf eine andere Reihe gesetzt werden.
Zugriffsfunktionen:
| QScatterDataProxy * | dataProxy() const |
| void | setDataProxy(QScatterDataProxy *proxy) |
Benachrichtigungssignal:
| void | dataProxyChanged(QScatterDataProxy *proxy) |
itemSize : float
Artikelgröße für die Serie.
Die Größe muss zwischen 0.0f und 1.0f liegen. Wenn die Größe auf 0.0f gesetzt wird, wird die Elementgröße automatisch basierend auf der Gesamtzahl der Elemente in allen Reihen des Diagramms skaliert.
Die voreingestellte Standardgröße ist 0.0f.
Zugriffsfunktionen:
| float | itemSize() const |
| void | setItemSize(float size) |
Benachrichtigungssignal:
| void | itemSizeChanged(float size) |
scaleArray : QList<QVector3D>
Skalierungsarray für die Reihe.
Enthält den Verweis auf das Skalierungsarray.
Das Signal „scaleArrayChanged“ wird ausgelöst, wenn das Skalierungsarray festgelegt wird, es sei denn, „ newScaleArray “ ist identisch mit dem vorherigen Wert.
Hinweis: Bevor Sie Änderungen am Skalierungsarray vornehmen, muss für den entsprechenden Proxy eine Reihe erstellt worden sein.
Hinweis: Wenn für die Daten keine Skalierung angegeben ist, wird der Standardwert (1,0; 1,0; 1,0) verwendet.
Zugriffsfunktionen:
| const QList<QVector3D> & | scaleArray() const & |
| QList<QVector3D> | scaleArray() && |
| void | setScaleArray(const QList<QVector3D> &newScaleArray) |
Notifier-Signal:
| void | scaleArrayChanged(const QList<QVector3D> &scaleArray) |
Siehe auch ` clearScaleArray()`.
selectedItem : qsizetype
Diese Eigenschaft enthält das Element, das in der Serie ausgewählt ist.
Wählt das Element am Index „ index “ im Datenarray der Serie aus. Es kann jeweils nur ein Element ausgewählt werden.
Um die Auswahl aus dieser Reihe zu löschen, wird ` invalidSelectionIndex()` auf ` index` gesetzt. Wird diese Reihe zu einem Diagramm hinzugefügt, kann das Diagramm die Auswahl entsprechend der Benutzerinteraktion anpassen oder sie aufheben, wenn sie ungültig wird. Die Auswahl eines Elements in einer anderen hinzugefügten Reihe führt ebenfalls zum Löschen der Auswahl.
Das Entfernen von Elementen aus der Reihe oder das Einfügen von Elementen vor dem ausgewählten Element passt die Auswahl so an, dass dasselbe Element ausgewählt bleibt.
Zugriffsfunktionen:
| qsizetype | selectedItem() const |
| void | setSelectedItem(qsizetype index) |
Benachrichtigungssignal:
| void | selectedItemChanged(qsizetype index) |
Siehe auch „ Q3DGraphsWidgetItem::clearSelection()“.
Dokumentation zu Mitgliedsfunktionen
[explicit] QScatter3DSeries::QScatter3DSeries(QObject *parent = nullptr)
Erstellt eine 3D-Streudiagramm-Reihe mit dem übergeordneten Element „ parent “.
[explicit] QScatter3DSeries::QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr)
Erstellt eine 3D-Streudiagramm-Reihe mit dem Daten-Proxy „ dataProxy “ und dem übergeordneten Element „ parent “.
[override virtual noexcept] QScatter3DSeries::~QScatter3DSeries()
Löscht die 3D-Streuungsreihe.
void QScatter3DSeries::clearArray()
Löscht das Datenarray.
void QScatter3DSeries::clearScaleArray()
Löscht das Skalen-Array.
[static] qsizetype QScatter3DSeries::invalidSelectionIndex()
Gibt einen ungültigen Index für die Auswahl zurück. Dieser Index wird der Eigenschaft „ selectedItem “ zugewiesen, um die Auswahl aus dieser Reihe zu löschen.
Siehe auch „ Q3DGraphsWidgetItem::clearSelection()“.
© 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.
