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: |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QScatterDataProxy ist Teil von „Qt Graphs “ – C++-Klassen für 3D.
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) |
Zugehörige Nicht-Mitglieder
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.
© 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.