QBarDataProxy Class

Die Klasse QBarDataProxy ist der Datenproxy für ein 3D-Balkendiagramm. Mehr...

Kopfzeile: #include <QBarDataProxy>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Since: QtDataVisualization 1.0
In QML: BarDataProxy
Vererbt: QAbstractDataProxy
Vererbt von:

QItemModelBarDataProxy

Eigenschaften

Ö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)

Detaillierte Beschreibung

Ein Bar Data Proxy behandelt das Hinzufügen, Einfügen, Ändern und Entfernen von Datenzeilen.

Das Daten-Array ist eine Liste von Vektoren (Zeilen) von QBarDataItem Instanzen. Jede Zeile kann eine unterschiedliche Anzahl von Elementen enthalten oder sogar Null sein.

QBarDataProxy übernimmt das Eigentum an allen QtDataVisualization::QBarDataRow-Objekten, die ihm übergeben werden, entweder direkt oder in einem QtDataVisualization::QBarDataArray-Container. Wenn Zeilenzeiger verwendet werden, um Daten direkt zu ändern, nachdem das Array zum Proxy hinzugefügt wurde, muss das entsprechende Signal ausgegeben werden, um den Graphen zu aktualisieren.

QBarDataProxy speichert optional Zeilen- und Spaltenbeschriftungen, die QCategory3DAxis zur Anzeige von Achsenbeschriftungen verwenden kann. Die Zeilen- und Spaltenbeschriftungen werden in einem von den Daten getrennten Array gespeichert, und die Methoden zur Zeilenmanipulation bieten alternative Versionen, die die Zeilenbeschriftungen nicht beeinflussen. Dies ermöglicht die Option, Zeilenbeschriftungen zu haben, die sich auf die Position der Daten im Array beziehen und nicht auf die Daten selbst.

Siehe auch Qt Data Visualization Datenbehandlung.

Dokumentation der Eigenschaft

columnLabels : QStringList

Diese Eigenschaft enthält die optionalen Spaltenbezeichnungen für das Array.

Die Indizes in diesem Array entsprechen den Spaltenindizes in den Zeilen. Wenn die Liste kürzer ist als die längste Zeile, erhalten nicht alle Spalten Bezeichnungen.

Zugriffsfunktionen:

QStringList columnLabels() const
void setColumnLabels(const QStringList &labels)

Benachrichtigungssignal:

void columnLabelsChanged()

[read-only] rowCount : const 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 Zeilenbezeichnungen für das Array.

Die Indizes in diesem Array entsprechen den Zeilenindizes im Datenarray. Wenn die Liste kürzer als die Anzahl der Zeilen ist, erhalten nicht alle Zeilen Bezeichnungen.

Zugriffsfunktionen:

QStringList rowLabels() const
void setRowLabels(const QStringList &labels)

Benachrichtigungssignal:

void rowLabelsChanged()

[read-only] series : QBar3DSeries* const

Diese Eigenschaft enthält die Serie, mit der dieser Proxy verbunden ist.

Zugriffsfunktionen:

QBar3DSeries *series() const

Benachrichtigungssignal:

void seriesChanged(QBar3DSeries *series)

Member Function Dokumentation

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

Konstruiert einen Balken-Daten-Proxy mit dem angegebenen parent.

[virtual noexcept] QBarDataProxy::~QBarDataProxy()

Löscht den Proxy für die Balkendaten.

int QBarDataProxy::addRow(QBarDataRow *row)

Fügt die neue Zeile row am Ende eines Arrays ein. Vorhandene Zeilenbeschriftungen sind davon nicht betroffen.

Gibt den Index der hinzugefügten Zeile zurück.

int QBarDataProxy::addRow(QBarDataRow *row, const QString &label)

Fügt eine neue Zeile row mit dem Label label am Ende eines Arrays hinzu.

Gibt den Index der hinzugefügten Zeile zurück.

int QBarDataProxy::addRows(const QBarDataArray &rows)

Fügt die neue rows am Ende eines Arrays ein. Vorhandene Zeilenbeschriftungen sind davon nicht betroffen.

Gibt den Index der ersten hinzugefügten Zeile zurück.

int QBarDataProxy::addRows(const QBarDataArray &rows, const QStringList &labels)

Fügt die neue rows mit labels an das Ende des Arrays an.

Gibt den Index der ersten 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 ausgegeben, wenn das Datenfeld zurückgesetzt wird. Wenn der Inhalt des gesamten Arrays geändert wird, ohne resetArray() aufzurufen, muss dieses Signal ausgegeben werden, um den Graphen zu aktualisieren.

void QBarDataProxy::insertRow(int rowIndex, QBarDataRow *row)

Fügt die neue Zeile row in rowIndex ein. Wenn rowIndex gleich der Array-Größe ist, werden die Zeilen am Ende des Arrays eingefügt. Die vorhandenen Zeilenbeschriftungen bleiben davon unberührt.

Hinweis: Das Array "Zeilenbeschriftungen" ist nach diesem Aufruf nicht mehr mit dem Array "Zeilen" synchron, wenn es beschriftete Zeilen nach der eingefügten Zeile gab.

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 gleich der Array-Größe ist, werden die Zeilen am Ende des Arrays hinzugefügt.

void QBarDataProxy::insertRows(int rowIndex, const QBarDataArray &rows)

Fügt neue rows in rowIndex ein. Wenn rowIndex gleich der Array-Größe ist, werden die Zeilen am Ende des Arrays eingefügt. Die vorhandenen Zeilenbeschriftungen bleiben davon unberührt.

Hinweis: Das Array "Zeilenbeschriftungen" ist nach diesem Aufruf nicht mehr mit dem Array "Zeilen" synchron, wenn es beschriftete Zeilen jenseits der eingefügten Zeilen gab.

void QBarDataProxy::insertRows(int rowIndex, const QBarDataArray &rows, const QStringList &labels)

Fügt neue rows mit labels in rowIndex ein. Wenn rowIndex gleich der Array-Größe ist, werden die Zeilen am Ende des Arrays eingefügt.

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 und der y-Wert die Spalte an. Das Element ist garantiert nur bis zum nächsten Aufruf gültig, bei dem die Daten geändert werden.

const QBarDataItem *QBarDataProxy::itemAt(int rowIndex, int columnIndex) const

Gibt den Zeiger auf das Element an der durch rowIndex und columnIndex angegebenen Position zurück. Er ist garantiert nur bis zum nächsten Aufruf gültig, bei dem Daten geändert werden.

[signal] void QBarDataProxy::itemChanged(int rowIndex, int columnIndex)

Dieses Signal wird ausgegeben, wenn sich das Element an der durch rowIndex und columnIndex angegebenen Position ändert. Wenn das Element im Array geändert wird, ohne setItem() aufzurufen, muss dieses Signal ausgegeben werden, um den Graphen zu aktualisieren.

void QBarDataProxy::removeRows(int rowIndex, int removeCount, bool removeLabels = true)

Entfernt die durch removeCount angegebene Anzahl von Zeilen, beginnend mit der Position rowIndex. Der Versuch, Zeilen über das Ende des Arrays hinaus zu entfernen, führt zu nichts. Wenn removeLabels gleich true ist, werden auch die entsprechenden Zeilenbeschriftungen entfernt. Andernfalls sind die Zeilenbeschriftungen nicht betroffen.

Hinweis: Wenn removeLabels gleich false ist, ist das Array der Zeilenbeschriftungen nicht mit dem Zeilenarray synchronisiert, wenn es beschriftete Zeilen hinter den entfernten Zeilen gibt.

void QBarDataProxy::resetArray()

Löscht das vorhandene Feld und die Zeilen- und Spaltenbeschriftungen.

void QBarDataProxy::resetArray(QBarDataArray *newArray)

Übernimmt das Eigentum an dem Array newArray. Löscht das bestehende Array, wenn sich das neue Array von ihm unterscheidet. Wenn die Arrays gleich sind, löst diese Funktion lediglich das Signal arrayReset() aus.

Die Übergabe eines Null-Arrays löscht das alte Array und erzeugt ein neues leeres Array. Zeilen- und Spaltenbeschriftungen sind davon nicht betroffen.

void QBarDataProxy::resetArray(QBarDataArray *newArray, const QStringList &rowLabels, const QStringList &columnLabels)

Übernimmt das Eigentum an dem Array newArray. Löscht das bestehende Array, wenn sich das neue Array von ihm unterscheidet. Wenn die Arrays gleich sind, löst diese Funktion lediglich das Signal arrayReset() aus.

Die Übergabe eines Null-Arrays löscht das alte Array und erzeugt ein neues leeres Array.

Die Listen rowLabels und columnLabels geben die neuen Bezeichnungen für Zeilen und Spalten an.

const QBarDataRow *QBarDataProxy::rowAt(int rowIndex) const

Gibt den Zeiger auf die Zeile an der Position rowIndex zurück. Er ist garantiert nur bis zum nächsten Aufruf gültig, bei dem die Daten geändert werden.

[signal] void QBarDataProxy::rowsAdded(int startIndex, int count)

Dieses Signal wird ausgegeben, wenn die durch count angegebene Anzahl von Zeilen ab der Position startIndex hinzugefügt wird. Wenn dem Array Zeilen hinzugefügt werden, ohne addRow() oder addRows() aufzurufen, muss dieses Signal ausgegeben werden, um den Graphen zu aktualisieren.

[signal] void QBarDataProxy::rowsChanged(int startIndex, int count)

Dieses Signal wird ausgegeben, wenn die durch count angegebene Anzahl von Zeilen ab der Position startIndex geändert wird. Wenn Zeilen im Array geändert werden, ohne setRow() oder setRows() aufzurufen, muss dieses Signal ausgegeben werden, um den Graphen zu aktualisieren.

[signal] void QBarDataProxy::rowsInserted(int startIndex, int count)

Dieses Signal wird ausgegeben, wenn die durch count angegebene Anzahl von Zeilen an der Position startIndex eingefügt wird.

Wenn Zeilen in das Array eingefügt werden, ohne insertRow() oder insertRows() aufzurufen, muss dieses Signal ausgegeben werden, um den Graphen zu aktualisieren.

[signal] void QBarDataProxy::rowsRemoved(int startIndex, int count)

Dieses Signal wird ausgegeben, wenn die durch count angegebene Anzahl von Zeilen ab der Position startIndex entfernt wird.

Der Index ist die aktuelle Array-Größe, wenn die Zeilen vom Ende des Arrays entfernt wurden. Wenn Zeilen aus dem Array entfernt werden, ohne removeRows() aufzurufen, muss dieses Signal ausgegeben werden, um den Graphen 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 steht für die Zeile und der y-Wert für 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 bestehende Zeile, indem es die Zeile an der Position rowIndex durch die neue Zeile ersetzt, die durch row angegeben wird. Die neue Zeile kann dieselbe sein wie die bereits unter rowIndex gespeicherte Zeile. Vorhandene Zeilenbeschriftungen sind davon nicht betroffen.

void QBarDataProxy::setRow(int rowIndex, QBarDataRow *row, const QString &label)

Ändert eine bestehende Zeile, indem es die Zeile an der Position rowIndex durch die neue Zeile ersetzt, die durch row angegeben wird. Die neue Zeile kann dieselbe sein wie die bereits unter rowIndex gespeicherte Zeile. Ändert die Zeilenbezeichnung in label.

void QBarDataProxy::setRows(int rowIndex, const QBarDataArray &rows)

Ändert bestehende Zeilen, indem die Zeilen ab der Position rowIndex durch die neuen Zeilen ersetzt werden, die durch rows angegeben werden. Vorhandene Zeilenbeschriftungen sind davon nicht betroffen. Die Zeilen im Array rows können dieselben sein wie die bereits unter rowIndex gespeicherten Zeilen.

void QBarDataProxy::setRows(int rowIndex, const QBarDataArray &rows, const QStringList &labels)

Ändert bestehende Zeilen, indem die Zeilen ab der Position rowIndex durch die neuen Zeilen ersetzt werden, die durch rows angegeben werden. Die Zeilenbeschriftungen werden in labels geändert. Die Zeilen im Array rows können dieselben sein wie die bereits unter rowIndex gespeicherten Zeilen.

Verwandte Nicht-Mitglieder

QBarDataArray

Eine Liste von Zeigern auf QBarDataRow Objekte.

QBarDataRow

Eine Liste von QBarDataItem Objekten.

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