QScatter3DSeries Class
Die Klasse „QScatter3DSeries“ stellt eine Datenreihe in einem 3D-Streudiagramm dar. Mehr...
| Header: | #include <QScatter3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Seit: | QtDataVisualization 1.0 |
| In QML: | Scatter3DSeries |
| Erbt von: | QAbstract3DSeries |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
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 für die Serie kein Datenproxy explizit festgelegt ist, erstellt die Serie einen Standardproxy. Das Festlegen eines anderen Proxys löscht 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 der y-Achse |
| @zTitle | Titel von der z-Achse |
| @xLabel | Elementwert, formatiert gemäß dem Format der x-Achse. Weitere Informationen finden Sie unter QValue3DAxis::setLabelFormat(). |
| @yLabel | Elementwert, formatiert gemäß dem Format der y-Achse. Weitere Informationen finden Sie unter QValue3DAxis::setLabelFormat(). |
| @zLabel | Elementwert, formatiert nach dem Format der z-Achse. Weitere Informationen finden Sie unter QValue3DAxis::setLabelFormat(). |
| @seriesName | Name der Reihe |
Beispiel:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));Siehe auch „Qt Data Visualization –Datenverarbeitung“.
Dokumentation zu den Eigenschaften
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 festlegen, 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) |
selectedItem : int
Diese Eigenschaft enthält das Element, das in der Reihe ausgewählt ist.
Zugriffsfunktionen:
| int | selectedItem() const |
| void | setSelectedItem(int index) |
Benachrichtigungssignal:
| void | selectedItemChanged(int index) |
Dokumentation der Member-Funktionen
[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 “.
[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 der Eigenschaft „ selectedItem “ zugewiesen, um die Auswahl aus dieser Reihe zu löschen.
Siehe auch QAbstract3DGraph::clearSelection().
void QScatter3DSeries::setDataProxy(QScatterDataProxy *proxy)
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.
Hinweis: Setter -Funktion für die Eigenschaft „ dataProxy “.
Siehe auch ` dataProxy()`.
void QScatter3DSeries::setSelectedItem(int index)
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. Wenn diese Reihe zu einem Diagramm hinzugefügt wird, kann das Diagramm die Auswahl entsprechend der Benutzerinteraktion anpassen oder sie aufheben, falls sie ungültig wird. Die Auswahl eines Elements in einer anderen hinzugefügten Reihe löscht ebenfalls die 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.
Hinweis: Setter -Funktion für die Eigenschaft „ selectedItem “.
Siehe auch „ selectedItem()“ und „ QAbstract3DGraph::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.
