QScatter3DSeries Class
Die Klasse QScatter3DSeries stellt eine Datenreihe in einem 3D-Streudiagramm dar. Mehr...
| Kopfzeile: | #include <QScatter3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | Scatter3DSeries |
| Vererbt: | QAbstract3DSeries |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QScatter3DSeries ist Teil von Qt Graphs C++ Classes for 3D.
Eigenschaften
- dataArray : QScatterDataArray
- dataProxy : QScatterDataProxy*
- itemSize : float
- selectedItem : qsizetype
Öffentliche Funktionen
| QScatter3DSeries(QObject *parent = nullptr) | |
| QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QScatter3DSeries() override |
| void | clearArray() |
| QScatterDataArray | dataArray() && |
| const QScatterDataArray & | dataArray() const & |
| QScatterDataProxy * | dataProxy() const |
| float | itemSize() const |
| qsizetype | selectedItem() const |
| void | setDataArray(const QScatterDataArray &newDataArray) |
| void | setDataProxy(QScatterDataProxy *proxy) |
| void | setItemSize(float size) |
| void | setSelectedItem(qsizetype index) |
Signale
| void | dataArrayChanged(const QScatterDataArray &array) |
| void | dataProxyChanged(QScatterDataProxy *proxy) |
| void | itemSizeChanged(float size) |
| void | selectedItemChanged(qsizetype index) |
Statische öffentliche Mitglieder
| qsizetype | invalidSelectionIndex() |
Detaillierte Beschreibung
Diese Klasse verwaltet sowohl die serienspezifischen visuellen Elemente als auch die Seriendaten (über einen Datenproxy).
In Bezug auf die Beziehung zwischen Proxy und Serie sind einige wichtige Punkte hervorzuheben. In diesem Zusammenhang werden die Daten in Reihen gespeichert, und die Benutzer können über die Reihen auf den Datensatz zugreifen. Diese Serie wird durch ein Proxy-Objekt kontrolliert oder repräsentiert. So kann das Proxy-Objekt verwendet werden, um verschiedene Operationen an den Daten durchzuführen und den eigentlichen Datensatz zu aktualisieren. Zur Bearbeitung des Datensatzes ist es jedoch erforderlich, eine mit diesem Proxy verknüpfte Serie zu erstellen.
Wenn kein Daten-Proxy explizit für die Serie festgelegt wird, erstellt die Serie ein Standard-Proxy. Das Setzen eines anderen Proxys zerstört den bestehenden Proxy und alle zur Serie hinzugefügten Daten.
QScatter3DSeries unterstützt die folgenden Format-Tags für QAbstract3DSeries::setItemLabelFormat():
| @xTitle | Titel der x-Achse |
| @yTitle | Titel von der y-Achse |
| @zTitel | Titel von der z-Achse |
| @xLabel | Elementwert, formatiert unter Verwendung des Formats der x-Achse. Für weitere Informationen siehe QValue3DAxis::labelFormat. |
| @yBeschriftung | Elementwert, formatiert unter Verwendung des Formats der y-Achse. Für weitere Informationen, siehe QValue3DAxis::labelFormat. |
| @zBeschriftung | Elementwert, formatiert unter Verwendung des Formats der z-Achse. Für weitere Informationen, siehe QValue3DAxis::labelFormat. |
| @Reihenname | Name der Reihe |
Zum Beispiel:
proxy->setItemLabelFormat(QStringLiteral("@yTitle for (@xLabel, @zLabel): %.1f"));
Siehe auch Qt Graphs Datenverarbeitung mit 3D.
Dokumentation der Eigenschaft
dataArray : QScatterDataArray
Daten-Array für die Serie.
Enthält den Verweis auf das Datenarray.
Das Signal dataArrayChanged wird ausgegeben, wenn das Datenfeld gesetzt wird, es sei denn, newDataArray ist mit dem vorherigen identisch.
Hinweis: Bevor irgendetwas bezüglich des Datenarrays getan werden kann, muss eine Serie für den entsprechenden Proxy erstellt 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 Daten-Proxy.
Legt den aktiven Daten-Proxy für die Reihe auf proxy fest. Die Reihe übernimmt alle für sie festgelegten Proxys und löscht alle zuvor festgelegten Proxys, wenn ein neuer hinzugefügt wird. Das Argument proxy kann nicht null sein oder auf eine andere Serie 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 Sie die Größe auf 0.0f setzen, wird die Elementgröße automatisch auf der Grundlage der Gesamtzahl der Elemente in allen Serien des Diagramms skaliert.
Die Standardvorgabe ist 0.0f.
Zugriffsfunktionen:
| float | itemSize() const |
| void | setItemSize(float size) |
Melder-Signal:
| void | itemSizeChanged(float size) |
selectedItem : qsizetype
Diese Eigenschaft enthält das Element, das in der Reihe ausgewählt ist.
Wählt das Element mit dem Index index im Datenfeld der Serie aus. Es kann jeweils nur ein Element ausgewählt werden.
Um die Auswahl aus dieser Reihe zu löschen, wird invalidSelectionIndex() als index festgelegt. Wird diese Reihe zu einem Diagramm hinzugefügt, kann das Diagramm die Auswahl entsprechend der Benutzerinteraktion anpassen oder wenn sie ungültig wird. Wenn Sie ein Element in einer anderen hinzugefügten Serie auswählen, wird die Auswahl ebenfalls gelöscht.
Das Entfernen von Elementen aus der Serie oder das Einfügen von Elementen in die Serie vor dem ausgewählten Element passt die Auswahl so an, dass das gleiche Element ausgewählt bleibt.
Zugriffsfunktionen:
| qsizetype | selectedItem() const |
| void | setSelectedItem(qsizetype index) |
Benachrichtigungssignal:
| void | selectedItemChanged(qsizetype index) |
Siehe auch Q3DGraphsWidgetItem::clearSelection().
Dokumentation der Mitgliedsfunktionen
[explicit] QScatter3DSeries::QScatter3DSeries(QObject *parent = nullptr)
Konstruiert eine 3D-Streuungsreihe mit dem übergeordneten parent.
[explicit] QScatter3DSeries::QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr)
Konstruiert eine 3D-Streuungsreihe mit dem Datenproxy dataProxy und dem übergeordneten parent.
[override virtual noexcept] QScatter3DSeries::~QScatter3DSeries()
Löscht die 3D-Streuungsreihe.
void QScatter3DSeries::clearArray()
Löscht das Datenfeld.
[static] qsizetype QScatter3DSeries::invalidSelectionIndex()
Gibt einen ungültigen Index für die Auswahl zurück. Dieser Index wird auf die Eigenschaft selectedItem gesetzt, um die Auswahl aus dieser Serie zu löschen.
Siehe auch Q3DGraphsWidgetItem::clearSelection().
© 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.
