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 DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Seit: QtDataVisualization 1.0
In QML: ScatterDataProxy
Erbt von: QAbstractDataProxy
Vererbt an:

QItemModelScatterDataProxy

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)

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.

Verwandte Nicht-Mitglieder

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.