QScatter3DSeries Class
Die Klasse QScatter3DSeries stellt eine Datenreihe in einem 3D-Streudiagramm dar. Mehr...
| Kopfzeile: | #include <QScatter3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Since: | QtDataVisualization 1.0 |
| In QML: | Scatter3DSeries |
| Vererbt: | QAbstract3DSeries |
Eigenschaften
- dataProxy : QScatterDataProxy*
- itemSize : float
- selectedItem : int
Öffentliche Funktionen
| QScatter3DSeries(QObject *parent = nullptr) | |
| QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QScatter3DSeries() |
| QScatterDataProxy * | dataProxy() const |
| float | itemSize() const |
| int | selectedItem() const |
| void | setDataProxy(QScatterDataProxy *proxy) |
| void | setItemSize(float size) |
| void | setSelectedItem(int index) |
Signale
| void | dataProxyChanged(QScatterDataProxy *proxy) |
| void | itemSizeChanged(float size) |
| void | selectedItemChanged(int index) |
Statische öffentliche Mitglieder
| int | invalidSelectionIndex() |
Detaillierte Beschreibung
Diese Klasse verwaltet die serienspezifischen visuellen Elemente sowie die Seriendaten (über einen Daten-Proxy).
Wenn kein Daten-Proxy explizit für die Serie festgelegt ist, erstellt die Serie einen Standard-Proxy. Das Setzen eines anderen Proxys zerstört den bestehenden Proxy und alle ihm 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::setLabelFormat(). |
| @yBeschriftung | Elementwert, formatiert unter Verwendung des Formats der y-Achse. Für weitere Informationen siehe QValue3DAxis::setLabelFormat(). |
| @zLabel | Elementwert, formatiert unter Verwendung des Formats der z-Achse. Weitere Informationen finden Sie unter QValue3DAxis::setLabelFormat(). |
| @Reihenname | Name der Reihe |
Zum Beispiel:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
Siehe auch Qt Data Visualization Data Handling.
Eigenschaft Dokumentation
dataProxy : QScatterDataProxy*
Diese Eigenschaft enthält den aktiven Datenproxy.
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 : int
Diese Eigenschaft enthält das Element, das in der Serie ausgewählt ist.
Zugriffsfunktionen:
| int | selectedItem() const |
| void | setSelectedItem(int index) |
Benachrichtigungssignal:
| void | selectedItemChanged(int index) |
Member Function Dokumentation
[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 Daten-Proxy dataProxy und dem übergeordneten parent.
[virtual noexcept] QScatter3DSeries::~QScatter3DSeries()
Löscht die 3D-Streuungsreihe.
[static] int 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 QAbstract3DGraph::clearSelection().
void QScatter3DSeries::setDataProxy(QScatterDataProxy *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.
Hinweis: Setter-Funktion für die Eigenschaft dataProxy.
Siehe auch dataProxy().
void QScatter3DSeries::setSelectedItem(int index)
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 aufzuheben, wird invalidSelectionIndex() auf index gesetzt. 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 einer anderen hinzugefügten Serie auswählen, wird die Auswahl ebenfalls aufgehoben.
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.
Hinweis: Setter-Funktion für die Eigenschaft selectedItem.
Siehe auch selectedItem() und QAbstract3DGraph::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.
