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

Ö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

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():

@xTitleTitel der x-Achse
@yTitleTitel von der y-Achse
@zTitelTitel von der z-Achse
@xLabelElementwert, formatiert unter Verwendung des Formats der x-Achse. Für weitere Informationen siehe QValue3DAxis::setLabelFormat().
@yBeschriftungElementwert, formatiert unter Verwendung des Formats der y-Achse. Für weitere Informationen siehe QValue3DAxis::setLabelFormat().
@zLabelElementwert, formatiert unter Verwendung des Formats der z-Achse. Weitere Informationen finden Sie unter QValue3DAxis::setLabelFormat().
@ReihennameName 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.