QScatterDataProxy Class
Die Klasse „QScatterDataProxy“ ist der Datenproxy für 3D-Streudiagramme. Mehr...
| Header: | #include <QScatterDataProxy> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Seit: | QtDataVisualization 1.0 |
| In QML: | ScatterDataProxy |
| Erbt von: | QAbstractDataProxy |
| Vererbt an: | |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Eigenschaften
Öffentliche Funktionen
| QScatterDataProxy(QObject *parent = nullptr) | |
| virtual | ~QScatterDataProxy() |
| int | addItem(const QScatterDataItem &item) |
| int | addItems(const QScatterDataArray &items) |
| const QScatterDataArray * | array() const |
| void | insertItem(int index, const QScatterDataItem &item) |
| void | insertItems(int index, const QScatterDataArray &items) |
| const QScatterDataItem * | itemAt(int index) const |
| int | itemCount() const |
| void | removeItems(int index, int removeCount) |
| void | resetArray(QScatterDataArray *newArray) |
| QScatter3DSeries * | series() const |
| void | setItem(int index, const QScatterDataItem &item) |
| void | setItems(int index, const QScatterDataArray &items) |
Signale
| void | arrayReset() |
| void | itemCountChanged(int count) |
| void | itemsAdded(int startIndex, int count) |
| void | itemsChanged(int startIndex, int count) |
| void | itemsInserted(int startIndex, int count) |
| void | itemsRemoved(int startIndex, int count) |
| void | seriesChanged(QScatter3DSeries *series) |
Zugehörige Nicht-Mitglieder
Detaillierte Beschreibung
Ein Scatter-Daten-Proxy übernimmt das Hinzufügen, Einfügen, Ändern und Entfernen von Datenelementen.
QScatterDataProxy übernimmt die Verantwortung für alle ihm übergebenen Objekte vom Typ „QtDataVisualization::QScatterDataArray“ und „ QScatterDataItem “.
Siehe auch „Qt Data Visualization -Datenverarbeitung“.
Dokumentation zu den Eigenschaften
[read-only] itemCount : int
Diese Eigenschaft gibt die Anzahl der Elemente im Array an.
Zugriffsfunktionen:
| int | itemCount() const |
Benachrichtigungssignal:
| void | itemCountChanged(int count) |
[read-only] series : QScatter3DSeries*
Diese Eigenschaft enthält die Serie, an die dieser Proxy angehängt 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`.
[virtual noexcept] QScatterDataProxy::~QScatterDataProxy()
Löscht den Scatter-Daten-Proxy.
int QScatterDataProxy::addItem(const QScatterDataItem &item)
Fügt das Element „ item “ am Ende des Arrays hinzu.
Gibt den Index des hinzugefügten Elements zurück.
int QScatterDataProxy::addItems(const QScatterDataArray &items)
Fügt die durch ` items ` angegebenen Elemente am Ende des Arrays hinzu.
Gibt den Index des ersten hinzugefügten Elements zurück.
const QScatterDataArray *QScatterDataProxy::array() const
Gibt den Zeiger auf das Datenarray 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(int index, const QScatterDataItem &item)
Fügt das Element „ item “ an der Position „ index “ ein. Wenn der Index der Größe des Datenarrays entspricht, wird das Element zum Array hinzugefügt.
void QScatterDataProxy::insertItems(int index, const 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(int 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(int startIndex, int count)
Dieses Signal wird ausgelöst, wenn die durch ` count ` angegebene Anzahl von Elementen beginnend an 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(int startIndex, int 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(int startIndex, int count)
Dieses Signal wird ausgelöst, wenn die durch ` count ` angegebene Anzahl von Elementen beginnend an 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(int startIndex, int count)
Dieses Signal wird ausgelöst, wenn die durch ` count ` angegebene Anzahl von Zeilen beginnend an der Position ` startIndex` entfernt wird. Der Index kann größer sein als die aktuelle Array-Größe, wenn Elemente vom Ende her entfernt werden. Werden Elemente aus dem Array entfernt, ohne dass ` removeItems()` aufgerufen wird, muss dieses Signal ausgelöst werden, um das Diagramm zu aktualisieren.
void QScatterDataProxy::removeItems(int index, int 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 Auswirkung.
void QScatterDataProxy::resetArray(QScatterDataArray *newArray)
Übernimmt das Array „ newArray “. Löscht das vorhandene Array, wenn sich das neue Array davon unterscheidet. Sind die Arrays identisch, löst diese Funktion lediglich das Signal „ arrayReset()“ aus.
Wird ein Null-Array übergeben, wird das alte Array gelöscht und ein neues leeres Array erstellt.
void QScatterDataProxy::setItem(int index, const QScatterDataItem &item)
Ersetzt den Eintrag an der Position index durch den Eintrag item.
void QScatterDataProxy::setItems(int index, const 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.