QBarDataProxy Class
Die Klasse „QBarDataProxy“ ist der Datenproxy für ein 3D-Balkendiagramm. Mehr...
| Header: | #include <QBarDataProxy> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Seit: | QtDataVisualization 1.0 |
| In QML: | BarDataProxy |
| Erbt von: | QAbstractDataProxy |
| Vererbt an: | |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Eigenschaften
- columnLabels : QStringList
- rowCount : int
- rowLabels : QStringList
- series : QBar3DSeries*
Öffentliche Funktionen
| QBarDataProxy(QObject *parent = nullptr) | |
| virtual | ~QBarDataProxy() |
| int | addRow(QBarDataRow *row) |
| int | addRow(QBarDataRow *row, const QString &label) |
| int | addRows(const QBarDataArray &rows) |
| int | addRows(const QBarDataArray &rows, const QStringList &labels) |
| const QBarDataArray * | array() const |
| QStringList | columnLabels() const |
| void | insertRow(int rowIndex, QBarDataRow *row) |
| void | insertRow(int rowIndex, QBarDataRow *row, const QString &label) |
| void | insertRows(int rowIndex, const QBarDataArray &rows) |
| void | insertRows(int rowIndex, const QBarDataArray &rows, const QStringList &labels) |
| const QBarDataItem * | itemAt(const QPoint &position) const |
| const QBarDataItem * | itemAt(int rowIndex, int columnIndex) const |
| void | removeRows(int rowIndex, int removeCount, bool removeLabels = true) |
| void | resetArray() |
| void | resetArray(QBarDataArray *newArray) |
| void | resetArray(QBarDataArray *newArray, const QStringList &rowLabels, const QStringList &columnLabels) |
| const QBarDataRow * | rowAt(int rowIndex) const |
| int | rowCount() const |
| QStringList | rowLabels() const |
| QBar3DSeries * | series() const |
| void | setColumnLabels(const QStringList &labels) |
| void | setItem(const QPoint &position, const QBarDataItem &item) |
| void | setItem(int rowIndex, int columnIndex, const QBarDataItem &item) |
| void | setRow(int rowIndex, QBarDataRow *row) |
| void | setRow(int rowIndex, QBarDataRow *row, const QString &label) |
| void | setRowLabels(const QStringList &labels) |
| void | setRows(int rowIndex, const QBarDataArray &rows) |
| void | setRows(int rowIndex, const QBarDataArray &rows, const QStringList &labels) |
Signale
| void | arrayReset() |
| void | columnLabelsChanged() |
| void | itemChanged(int rowIndex, int columnIndex) |
| void | rowCountChanged(int count) |
| void | rowLabelsChanged() |
| void | rowsAdded(int startIndex, int count) |
| void | rowsChanged(int startIndex, int count) |
| void | rowsInserted(int startIndex, int count) |
| void | rowsRemoved(int startIndex, int count) |
| void | seriesChanged(QBar3DSeries *series) |
Zugehörige Nicht-Mitglieder
Detaillierte Beschreibung
Ein Bar-Daten-Proxy übernimmt das Hinzufügen, Einfügen, Ändern und Entfernen von Datenzeilen.
Das Datenarray ist eine Liste von Vektoren (Zeilen) mit Instanzen von ` QBarDataItem `. Jede Zeile kann eine unterschiedliche Anzahl von Elementen enthalten oder sogar null sein.
QBarDataProxy übernimmt die Verantwortung für alle QtDataVisualization::QBarDataRow-Objekte, die ihm übergeben werden, sei es direkt oder in einem QtDataVisualization::QBarDataArray-Container. Wenn Zeiger auf Bar-Datenzeilen verwendet werden, um Daten nach dem Hinzufügen des Arrays zum Proxy direkt zu ändern, muss das entsprechende Signal ausgelöst werden, um das Diagramm zu aktualisieren.
QBarDataProxy verwaltet optional Zeilen- und Spaltenbeschriftungen, die von „ QCategory3DAxis “ zur Darstellung von Achsenbeschriftungen genutzt werden können. Die Zeilen- und Spaltenbeschriftungen werden in einem vom Datenarray getrennten Array gespeichert, und die Methoden zur Daten- und Zeilenbearbeitung bieten alternative Versionen, die die Zeilenbeschriftungen nicht beeinflussen. Dies ermöglicht die Verwendung von Zeilenbeschriftungen, die sich auf die Position der Daten im Array beziehen und nicht auf die Daten selbst.
Siehe auch „Qt Data Visualization –Datenverarbeitung“.
Dokumentation zu den Eigenschaften
columnLabels : QStringList
Diese Eigenschaft enthält die optionalen Spaltenbezeichnungen für das Array.
Die Indizes in diesem Array stimmen mit den Spaltenindizes in den Zeilen überein. Ist die Liste kürzer als die längste Zeile, erhalten nicht alle Spalten eine Bezeichnung.
Zugriffsfunktionen:
| QStringList | columnLabels() const |
| void | setColumnLabels(const QStringList &labels) |
Benachrichtigungssignal:
| void | columnLabelsChanged() |
[read-only] rowCount : int
Diese Eigenschaft enthält die Anzahl der Zeilen im Array.
Zugriffsfunktionen:
| int | rowCount() const |
Benachrichtigungssignal:
| void | rowCountChanged(int count) |
rowLabels : QStringList
Diese Eigenschaft enthält die optionalen Zeilenbeschriftungen für das Array.
Die Indizes in diesem Array stimmen mit den Zeilenindizes im Datenarray überein. Ist die Liste kürzer als die Anzahl der Zeilen, erhalten nicht alle Zeilen eine Beschriftung.
Zugriffsfunktionen:
| QStringList | rowLabels() const |
| void | setRowLabels(const QStringList &labels) |
Benachrichtigungssignal:
| void | rowLabelsChanged() |
[read-only] series : QBar3DSeries*
Diese Eigenschaft enthält die Serie, an die dieser Proxy angehängt ist.
Zugriffsfunktionen:
| QBar3DSeries * | series() const |
Benachrichtigungssignal:
| void | seriesChanged(QBar3DSeries *series) |
Dokumentation der Mitgliedsfunktionen
[explicit] QBarDataProxy::QBarDataProxy(QObject *parent = nullptr)
Erstellt einen Balken-Datenproxy mit dem angegebenen „ parent “.
[virtual noexcept] QBarDataProxy::~QBarDataProxy()
Löscht den Daten-Proxy für den Balken.
int QBarDataProxy::addRow(QBarDataRow *row)
Fügt die neue Zeile „ row “ am Ende eines Arrays hinzu. Vorhandene Zeilenbezeichnungen bleiben davon unberührt.
Gibt den Index der hinzugefügten Zeile zurück.
int QBarDataProxy::addRow(QBarDataRow *row, const QString &label)
Fügt am Ende eines Arrays eine neue Zeile „ row “ mit der Bezeichnung „ label “ hinzu.
Gibt den Index der hinzugefügten Zeile zurück.
int QBarDataProxy::addRows(const QBarDataArray &rows)
Fügt das neue „ rows “ am Ende eines Arrays hinzu. Vorhandene Zeilenbezeichnungen bleiben davon unberührt.
Gibt den Index der zuerst hinzugefügten Zeile zurück.
int QBarDataProxy::addRows(const QBarDataArray &rows, const QStringList &labels)
Fügt das neue Element ` rows ` mit dem Wert ` labels ` am Ende des Arrays hinzu.
Gibt den Index der zuerst hinzugefügten Zeile zurück.
const QBarDataArray *QBarDataProxy::array() const
Gibt den Zeiger auf das Datenarray zurück.
[signal] void QBarDataProxy::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 QBarDataProxy::insertRow(int rowIndex, QBarDataRow *row)
Fügt die neue Zeile „ row “ in „ rowIndex “ ein. Wenn „ rowIndex “ der Größe des Arrays entspricht, werden die Zeilen am Ende des Arrays angehängt. Die vorhandenen Zeilenbezeichnungen bleiben davon unberührt.
Hinweis: Das Array der Zeilenbezeichnungen ist nach diesem Aufruf nicht mehr mit dem Zeilen-Array synchron, wenn sich hinter der eingefügten Zeile weitere beschriftete Zeilen befanden.
void QBarDataProxy::insertRow(int rowIndex, QBarDataRow *row, const QString &label)
Fügt die neue Zeile „ row “ mit der Bezeichnung „ label “ in „ rowIndex “ ein. Wenn „ rowIndex “ der Größe des Arrays entspricht, werden die Zeilen am Ende des Arrays angehängt.
void QBarDataProxy::insertRows(int rowIndex, const QBarDataArray &rows)
Fügt neue „ rows “ in „ rowIndex “ ein. Wenn „ rowIndex “ der Größe des Arrays entspricht, werden die Zeilen am Ende des Arrays angehängt. Die vorhandenen Zeilenbezeichnungen bleiben davon unberührt.
Hinweis: Das Array der Zeilenbezeichnungen ist nach diesem Aufruf nicht mehr mit dem Zeilen-Array synchron, wenn sich über die eingefügten Zeilen hinaus weitere beschriftete Zeilen befanden.
void QBarDataProxy::insertRows(int rowIndex, const QBarDataArray &rows, const QStringList &labels)
Fügt unter rowIndex ein neues Array „ rows “ mit den Elementen „ labels “ ein. Wenn „ rowIndex “ der Größe des Arrays entspricht, werden die Zeilen am Ende des Arrays angehängt.
const QBarDataItem *QBarDataProxy::itemAt(const QPoint &position) const
Gibt den Zeiger auf das Element an der Position position zurück. Der x-Wert von position gibt die Zeile an, der y-Wert die Spalte. Das Element ist garantiert nur bis zum nächsten Aufruf gültig, der die Daten ändert.
const QBarDataItem *QBarDataProxy::itemAt(int rowIndex, int columnIndex) const
Gibt den Zeiger auf das Element an der Position zurück, die durch rowIndex und columnIndex angegeben wird. Es wird garantiert, dass dieser Zeiger nur bis zum nächsten Aufruf gültig ist, der Daten ändert.
[signal] void QBarDataProxy::itemChanged(int rowIndex, int columnIndex)
Dieses Signal wird ausgelöst, wenn sich das Element an der durch ` rowIndex ` und ` columnIndex ` angegebenen Position ändert. Wird das Element im Array geändert, ohne dass ` setItem()` aufgerufen wird, muss dieses Signal ausgelöst werden, um die Grafik zu aktualisieren.
void QBarDataProxy::removeRows(int rowIndex, int removeCount, bool removeLabels = true)
Entfernt die durch ` removeCount ` angegebene Anzahl von Zeilen, beginnend an der Position ` rowIndex`. Der Versuch, Zeilen jenseits des Array-Endes zu entfernen, hat keine Auswirkung. Wenn ` removeLabels ` auf ` true` gesetzt ist, werden auch die entsprechenden Zeilenbezeichnungen entfernt. Andernfalls bleiben die Zeilenbezeichnungen unberührt.
Hinweis: Wenn „ removeLabels “ gleich „ false “ ist, sind das Array der Zeilenbezeichnungen und das Zeilen-Array nicht mehr synchron, sofern sich beschriftete Zeilen jenseits der entfernten Zeilen befinden.
void QBarDataProxy::resetArray()
Löscht das vorhandene Array sowie die Zeilen- und Spaltenbezeichnungen.
void QBarDataProxy::resetArray(QBarDataArray *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. Zeilen- und Spaltenbezeichnungen bleiben davon unberührt.
void QBarDataProxy::resetArray(QBarDataArray *newArray, const QStringList &rowLabels, const QStringList &columnLabels)
Ü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.
Die Listen „ rowLabels “ und „ columnLabels “ legen die neuen Bezeichnungen für Zeilen und Spalten fest.
const QBarDataRow *QBarDataProxy::rowAt(int rowIndex) const
Gibt den Zeiger auf die Zeile an der Position „ rowIndex “ zurück. Es wird garantiert, dass dieser Zeiger nur bis zum nächsten Aufruf gültig ist, der Daten ändert.
[signal] void QBarDataProxy::rowsAdded(int startIndex, int count)
Dieses Signal wird ausgelöst, wenn die durch ` count ` angegebene Anzahl von Zeilen beginnend an der Position ` startIndex` hinzugefügt wird. Werden Zeilen zum Array hinzugefügt, ohne dass ` addRow()` oder ` addRows()` aufgerufen wird, muss dieses Signal ausgelöst werden, um das Diagramm zu aktualisieren.
[signal] void QBarDataProxy::rowsChanged(int startIndex, int count)
Dieses Signal wird ausgelöst, wenn die durch ` count ` festgelegte Zeilenanzahl ab der Position ` startIndex` geändert wird. Werden Zeilen im Array geändert, ohne dass ` setRow()` oder ` setRows()` aufgerufen wird, muss dieses Signal ausgelöst werden, um das Diagramm zu aktualisieren.
[signal] void QBarDataProxy::rowsInserted(int startIndex, int count)
Dieses Signal wird ausgelöst, wenn die durch ` count ` angegebene Anzahl von Zeilen an der Position ` startIndex` eingefügt wird.
Werden Zeilen in das Array eingefügt, ohne dass insertRow() oder insertRows() aufgerufen wird, muss dieses Signal ausgelöst werden, um das Diagramm zu aktualisieren.
[signal] void QBarDataProxy::rowsRemoved(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 entspricht der aktuellen Array-Größe, wenn die Zeilen vom Ende des Arrays entfernt wurden. Werden Zeilen aus dem Array entfernt, ohne dass removeRows() aufgerufen wird, muss dieses Signal ausgelöst werden, um das Diagramm zu aktualisieren.
void QBarDataProxy::setItem(const QPoint &position, const QBarDataItem &item)
Ändert ein einzelnes Element an der Position position in das Element item. Der x-Wert von position gibt die Zeile an, der y-Wert die Spalte.
void QBarDataProxy::setItem(int rowIndex, int columnIndex, const QBarDataItem &item)
Ändert ein einzelnes Element an der durch „ rowIndex “ und „ columnIndex “ angegebenen Position in das Element „ item “.
void QBarDataProxy::setRow(int rowIndex, QBarDataRow *row)
Ändert eine vorhandene Zeile, indem die Zeile an der Position rowIndex durch die neue Zeile ersetzt wird, die durch row angegeben wird. Die neue Zeile kann mit der bereits unter rowIndex gespeicherten Zeile identisch sein. Vorhandene Zeilenbezeichnungen bleiben davon unberührt.
void QBarDataProxy::setRow(int rowIndex, QBarDataRow *row, const QString &label)
Ändert eine vorhandene Zeile, indem die Zeile an der Position rowIndex durch die neue Zeile ersetzt wird, die durch row angegeben ist. Die neue Zeile kann mit der bereits unter rowIndex gespeicherten Zeile identisch sein. Ändert die Zeilenbezeichnung in label.
void QBarDataProxy::setRows(int rowIndex, const QBarDataArray &rows)
Ändert vorhandene Zeilen, indem die Zeilen ab der Position rowIndex durch die neuen Zeilen ersetzt werden, die unter rows angegeben sind. Vorhandene Zeilenbezeichnungen bleiben davon unberührt. Die Zeilen im Array rows können mit den bereits unter rowIndex gespeicherten Zeilen übereinstimmen.
void QBarDataProxy::setRows(int rowIndex, const QBarDataArray &rows, const QStringList &labels)
Ändert vorhandene Zeilen, indem die Zeilen ab der Position rowIndex durch die neuen Zeilen ersetzt werden, die unter rows angegeben sind. Die Zeilenbezeichnungen werden in labels geändert. Die Zeilen im Array rows können mit den bereits unter rowIndex gespeicherten Zeilen übereinstimmen.
Verwandte Nicht-Mitglieder
QBarDataArray
Eine Liste von Zeigern auf „ QBarDataRow “-Objekte.
QBarDataRow
Eine Liste von „ QBarDataItem “-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.