Auf dieser Seite

QScatterDataProxy Class

Die Klasse „QScatterDataProxy“ ist der Datenproxy für 3D-Streudiagramme. Mehr...

Header: #include <QScatterDataProxy>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
In QML: ScatterDataProxy
Erbt von: QAbstractDataProxy
Vererbt an:

QItemModelScatterDataProxy

Eigenschaften

Öffentliche Funktionen

QScatterDataProxy(QObject *parent = nullptr)
virtual ~QScatterDataProxy() override
qsizetype addItem(QScatterDataItem item)
qsizetype addItems(QScatterDataArray items)
void insertItem(qsizetype index, QScatterDataItem item)
void insertItems(qsizetype index, QScatterDataArray items)
const QScatterDataItem &itemAt(qsizetype index) const
qsizetype itemCount() const
void removeItems(qsizetype index, qsizetype removeCount)
void resetArray()
void resetArray(QScatterDataArray newArray)
void resetScaleArray(QList<QVector3D> newArray)
QVector3D scaleAt(qsizetype index) const
QScatter3DSeries *series() const
void setItem(qsizetype index, QScatterDataItem item)
void setItems(qsizetype index, QScatterDataArray items)

Signale

void arrayReset()
void itemCountChanged(qsizetype count)
void itemsAdded(qsizetype startIndex, qsizetype count)
void itemsChanged(qsizetype startIndex, qsizetype count)
void itemsInserted(qsizetype startIndex, qsizetype count)
void itemsRemoved(qsizetype startIndex, qsizetype count)
void seriesChanged(QScatter3DSeries *series)

Ausführliche Beschreibung

Ein Scatter-Daten-Proxy übernimmt das Hinzufügen, Einfügen, Ändern und Entfernen von Datenelementen. Da Daten in Serien gespeichert werden, muss vor der Verwendung dieser Funktionen für den Datensatz eine mit dem Proxy verknüpfte Serie erstellt werden.

`QScatterDataProxy` übernimmt die Eigentumsrechte an allen ihm übergebenen Objekten vom Typ `QtGraphs::QScatterDataArray` und ` QScatterDataItem `.

Siehe auch „Qt Graphs -Datenverarbeitung mit 3D“.

Dokumentation zu den Eigenschaften

[read-only] itemCount : qsizetype

Diese Eigenschaft gibt die Anzahl der Elemente im Array an.

Zugriffsfunktionen:

qsizetype itemCount() const

Benachrichtigungssignal:

void itemCountChanged(qsizetype count)

[read-only] series : QScatter3DSeries*

Diese Eigenschaft enthält die Serie, an die dieser Proxy angeknüpft ist.

Zugriffsfunktionen:

QScatter3DSeries *series() const

Benachrichtigungssignal:

void seriesChanged(QScatter3DSeries *series)

Dokumentation der Mitgliedsfunktionen

[explicit] QScatterDataProxy::QScatterDataProxy(QObject *parent = nullptr)

Erstellt ein `QScatterDataProxy` mit dem angegebenen ` parent`.

[override virtual noexcept] QScatterDataProxy::~QScatterDataProxy()

Löscht den Scatter-Daten-Proxy.

qsizetype QScatterDataProxy::addItem(QScatterDataItem item)

Fügt das Element „ item “ am Ende des Arrays hinzu.

Gibt den Index des hinzugefügten Elements zurück.

qsizetype QScatterDataProxy::addItems(QScatterDataArray items)

Fügt die durch „ items “ angegebenen Elemente am Ende des Arrays hinzu.

Gibt den Index des ersten hinzugefügten Elements zurück.

[signal] void QScatterDataProxy::arrayReset()

Dieses Signal wird ausgelöst, wenn das Datenarray zurückgesetzt wird. Wenn der Inhalt des gesamten Arrays geändert wird, ohne dass die Funktion ` resetArray()` aufgerufen wird, muss dieses Signal ausgelöst werden, um die Grafik zu aktualisieren.

void QScatterDataProxy::insertItem(qsizetype index, QScatterDataItem item)

Fügt das Element „ item “ an der Position „ index “ ein. Wenn der Index der Größe des Datenarrays entspricht, wird das Element dem Array hinzugefügt.

void QScatterDataProxy::insertItems(qsizetype index, QScatterDataArray items)

Fügt die durch ` items ` angegebenen Elemente an der Position ` index` ein. Wenn der Index der Größe des Datenarrays entspricht, werden die Elemente dem Array hinzugefügt.

const QScatterDataItem &QScatterDataProxy::itemAt(qsizetype index) const

Gibt den Zeiger auf das Element am Index „ index “ zurück. Es wird garantiert, dass dieser Zeiger nur bis zum nächsten Aufruf gültig ist, der die Daten verändert.

[signal] void QScatterDataProxy::itemsAdded(qsizetype startIndex, qsizetype count)

Dieses Signal wird ausgelöst, wenn die durch „ count “ angegebene Anzahl von Elementen ab der Position „ startIndex “ hinzugefügt wird. Werden Elemente zum Array hinzugefügt, ohne dass „ addItem()“ oder „ addItems()“ aufgerufen wird, muss dieses Signal ausgelöst werden, um das Diagramm zu aktualisieren.

[signal] void QScatterDataProxy::itemsChanged(qsizetype startIndex, qsizetype count)

Dieses Signal wird ausgelöst, wenn die durch ` count ` angegebene Anzahl von Elementen ab der Position ` startIndex` geändert wird. Werden Elemente im Array geändert, ohne dass ` setItem()` oder ` setItems()` aufgerufen wird, muss dieses Signal ausgelöst werden, um die Grafik zu aktualisieren.

[signal] void QScatterDataProxy::itemsInserted(qsizetype startIndex, qsizetype count)

Dieses Signal wird ausgelöst, wenn die durch ` count ` angegebene Anzahl von Elementen ab der Position ` startIndex` eingefügt wird. Werden Elemente in das Array eingefügt, ohne dass ` insertItem()` oder ` insertItems()` aufgerufen wird, muss dieses Signal ausgelöst werden, um den Graphen zu aktualisieren.

[signal] void QScatterDataProxy::itemsRemoved(qsizetype startIndex, qsizetype count)

Dieses Signal wird ausgelöst, wenn die durch ` count ` angegebene Anzahl von Zeilen entfernt wird, beginnend an der Position ` startIndex`. Der Index kann größer sein als die aktuelle Größe des Arrays, wenn Elemente vom Ende her entfernt werden. Wenn Elemente aus dem Array entfernt werden, ohne dass ` removeItems()` aufgerufen wird, muss dieses Signal ausgelöst werden, um den Graphen zu aktualisieren.

void QScatterDataProxy::removeItems(qsizetype index, qsizetype removeCount)

Entfernt die durch ` removeCount ` angegebene Anzahl von Elementen, beginnend an der Position ` index`. Der Versuch, Elemente jenseits des Array-Endes zu entfernen, hat keine Auswirkungen.

void QScatterDataProxy::resetArray()

Löscht das vorhandene Array und löst das Signal „ arrayReset()“ aus.

void QScatterDataProxy::resetArray(QScatterDataArray newArray)

Legt das Array aus „ newArray “ fest. Wenn das neue Array mit dem bestehenden identisch ist, löst diese Funktion lediglich das Signal „ arrayReset()“ aus.

void QScatterDataProxy::resetScaleArray(QList<QVector3D> newArray)

Legt das Skalierungsarray aus „ newArray “ fest. Wenn das neue Array mit dem bestehenden übereinstimmt, löst diese Funktion lediglich das Signal „scaleArrayReset()“ aus.

QVector3D QScatterDataProxy::scaleAt(qsizetype index) const

Gibt die Skalendaten unter dem Index „ index “ zurück. Es wird garantiert, dass diese Daten nur bis zum nächsten Aufruf gültig sind, der die Daten verändert.

void QScatterDataProxy::setItem(qsizetype index, QScatterDataItem item)

Ersetzt den Eintrag an der Position index durch den Eintrag item.

void QScatterDataProxy::setItems(qsizetype index, QScatterDataArray items)

Ersetzt die Elemente ab der Position index durch die unter items angegebenen Elemente.

Verwandte Nicht-Mitglieder

[alias] QScatterDataArray

Eine Liste von „ QScatterDataItem “-Objekten.

© 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.