QBar3DSeries Class
Die Klasse QBar3DSeries stellt eine Datenreihe in einem 3D-Balkendiagramm dar. Mehr...
| Kopfzeile: | #include <QBar3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | Bar3DSeries |
| Vererbt: | QAbstract3DSeries |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QBar3DSeries ist Teil von Qt Graphs C++ Classes for 3D.
Eigenschaften
|
|
Öffentliche Funktionen
| QBar3DSeries(QObject *parent = nullptr) | |
| QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QBar3DSeries() override |
| void | clearArray() |
| void | clearRow(qsizetype rowIndex) |
| QStringList | columnLabels() const |
| QBarDataArray | dataArray() && |
| const QBarDataArray & | dataArray() const & |
| QBarDataProxy * | dataProxy() const |
| float | meshAngle() const |
| QList<QColor> | rowColors() const |
| QStringList | rowLabels() const |
| QPoint | selectedBar() const |
| void | setColumnLabels(const QStringList &labels) |
| void | setDataArray(const QBarDataArray &newDataArray) |
| void | setDataProxy(QBarDataProxy *proxy) |
| void | setMeshAngle(float angle) |
| void | setRowColors(const QList<QColor> &colors) |
| void | setRowLabels(const QStringList &labels) |
| void | setSelectedBar(QPoint position) |
Signale
| void | columnLabelsChanged() |
| void | dataArrayChanged(const QBarDataArray &array) |
| void | dataProxyChanged(QBarDataProxy *proxy) |
| void | meshAngleChanged(float angle) |
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
| void | rowLabelsChanged() |
| void | selectedBarChanged(QPoint position) |
Statische öffentliche Mitglieder
| QPoint | invalidSelectionPosition() |
Detaillierte Beschreibung
Diese Klasse verwaltet sowohl die serienspezifischen visuellen Elemente als auch die Seriendaten (über einen Datenproxy).
In Bezug auf die Beziehung zwischen Proxy und Serie sind einige wichtige Punkte hervorzuheben. In diesem Zusammenhang werden die Daten in Reihen gespeichert, und die Benutzer können über die Reihen auf den Datensatz zugreifen. Diese Serie wird durch ein Proxy-Objekt kontrolliert oder repräsentiert. So kann das Proxy-Objekt verwendet werden, um verschiedene Operationen an den Daten durchzuführen und den eigentlichen Datensatz zu aktualisieren. Zur Bearbeitung des Datensatzes ist es jedoch erforderlich, eine mit diesem Proxy verknüpfte Serie zu erstellen.
Wenn kein Daten-Proxy explizit für die Serie festgelegt wird, erstellt die Serie ein Standard-Proxy. Das Setzen eines anderen Proxys zerstört den bestehenden Proxy und alle zur Serie hinzugefügten Daten.
QBar3DSeries unterstützt die folgenden Format-Tags für QAbstract3DSeries::setItemLabelFormat():
| @rowTitle | Titel der Zeilenachse |
| @colTitle | Titel der Spaltenachse |
| @valueTitle | Titel aus der Wertachse |
| @rowIdx | Sichtbarer Zeilenindex. Lokalisiert unter Verwendung des Gebietsschemas der Grafik. |
| @colIdx | Sichtbarer Spaltenindex. Wird unter Verwendung des Diagrammgebietsschemas lokalisiert. |
| @rowLabel | Beschriftung der Zeilenachse |
| @colLabel | Label von der Spaltenachse |
| @valueLabel | Elementwert, formatiert unter Verwendung des Formats der dem Diagramm zugeordneten Wertachse. Für weitere Informationen, siehe QValue3DAxis::labelFormat. |
| @Reihenname | Name der Reihe |
| %<Formatangabe> | Elementwert in dem angegebenen Format. Die Formatierung erfolgt nach denselben Regeln wie bei QValue3DAxis::labelFormat. |
Zum Beispiel:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
Siehe auch Qt Graphs Datenverarbeitung mit 3D und Q3DGraphsWidgetItem::locale.
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() |
dataArray : QBarDataArray
Daten-Array für die Serie.
Enthält den Verweis auf das Datenarray.
Das Signal dataArrayChanged wird ausgegeben, wenn das Datenarray gesetzt wird, es sei denn, newDataArray ist mit dem vorherigen identisch.
Hinweis: Bevor irgendetwas bezüglich des dataArray getan werden kann, muss eine Serie für den entsprechenden Proxy erstellt werden.
Zugriffsfunktionen:
| const QBarDataArray & | dataArray() const & |
| QBarDataArray | dataArray() && |
| void | setDataArray(const QBarDataArray &newDataArray) |
Notifier-Signal:
| void | dataArrayChanged(const QBarDataArray &array) |
Siehe auch clearRow(qsizetype rowIndex) und clearArray().
dataProxy : QBarDataProxy*
Diese Eigenschaft enthält den aktiven Daten-Proxy.
Die Reihe übernimmt alle Proxys, die für sie festgelegt wurden, und löscht alle zuvor festgelegten Proxys, wenn ein neuer hinzugefügt wird. Der Proxy kann nicht ungültig sein oder auf eine andere Serie gesetzt werden.
Zugriffsfunktionen:
| QBarDataProxy * | dataProxy() const |
| void | setDataProxy(QBarDataProxy *proxy) |
Benachrichtigungssignal:
| void | dataProxyChanged(QBarDataProxy *proxy) |
meshAngle : float
Diese Eigenschaft enthält den Drehwinkel der Serie in Grad.
Die Einstellung dieser Eigenschaft entspricht dem folgenden Aufruf:
setMeshRotation(QQuaternion::fromAxisAndAngle(0.0f, 1.0f, 0.0f, angle))
Hinweis: Beim Auslesen dieser Eigenschaft wird sie aus dem Wert QAbstract3DSeries::meshRotation mit Fließkommagenauigkeit berechnet und gibt immer einen Wert zwischen 0 und 360 Grad zurück.
Zugriffsfunktionen:
| float | meshAngle() const |
| void | setMeshAngle(float angle) |
Melder-Signal:
| void | meshAngleChanged(float angle) |
Siehe auch QAbstract3DSeries::meshRotation.
rowColors : QList<QColor>
Diese Eigenschaft enthält die Liste der Zeilenfarben in der Serie.
Diese Eigenschaft kann verwendet werden, um die Zeilen der Serie in verschiedenen Farben zu färben. Die QGraphsTheme::ColorStyle muss auf QGraphsTheme::ColorStyle::Uniform gesetzt sein, um diese Eigenschaft zu verwenden.
Zugriffsfunktionen:
| QList<QColor> | rowColors() const |
| void | setRowColors(const QList<QColor> &colors) |
Benachrichtigungssignal:
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
Siehe auch QGraphsTheme::ColorStyle::Uniform.
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() |
selectedBar : QPoint
Diese Eigenschaft enthält den ausgewählten Takt der Serie.
Zugriffsfunktionen:
| QPoint | selectedBar() const |
| void | setSelectedBar(QPoint position) |
Benachrichtigungssignal:
| void | selectedBarChanged(QPoint position) |
Member Function Dokumentation
[explicit] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
Konstruiert eine 3D-Balkenreihe mit dem übergeordneten parent.
[explicit] QBar3DSeries::QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr)
Konstruiert eine 3D-Balkenreihe mit dem Datenproxy dataProxy und dem übergeordneten parent.
[override virtual noexcept] QBar3DSeries::~QBar3DSeries()
Löscht eine 3D-Balkenserie.
void QBar3DSeries::clearArray()
Löscht das vorhandene Array.
void QBar3DSeries::clearRow(qsizetype rowIndex)
Löscht die vorhandene Zeile im Array gemäß der angegebenen rowIndex.
[static] QPoint QBar3DSeries::invalidSelectionPosition()
Gibt eine ungültige Position für die Auswahl zurück. Diese Position wird auf die Eigenschaft selectedBar gesetzt, um die Auswahl aus dieser Reihe zu löschen.
Siehe auch Q3DGraphsWidgetItem::clearSelection().
void QBar3DSeries::setSelectedBar(QPoint position)
Wählt den Balken an der Position position aus, die als Zeile und Spalte im Datenfeld der Serie angegeben ist.
Es kann jeweils nur ein Balken ausgewählt werden.
Um die Auswahl aus dieser Reihe zu löschen, wird invalidSelectionPosition() als position festgelegt.
Wenn diese Reihe zu einem Diagramm hinzugefügt wird, kann das Diagramm die Auswahl entsprechend der Benutzerinteraktion anpassen oder wenn sie ungültig wird. Wenn Sie einen Balken einer anderen hinzugefügten Reihe auswählen, wird die Auswahl ebenfalls gelöscht.
Das Entfernen von Zeilen aus der Serie oder das Einfügen von Zeilen in die Serie vor der Zeile des ausgewählten Balkens passt die Auswahl so an, dass derselbe Balken ausgewählt bleibt.
Hinweis: Setter-Funktion für die Eigenschaft selectedBar.
Siehe auch selectedBar() und Q3DGraphsWidgetItem::clearSelection().
© 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.
