QBar3DSeries Class
Die Klasse „QBar3DSeries“ stellt eine Datenreihe in einem 3D-Balkendiagramm dar. Mehr...
| Header: | #include <QBar3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | Bar3DSeries |
| Erbt von: | QAbstract3DSeries |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QBar3DSeries ist Teil von „Qt Graphs “ – C++-Klassen für 3D.
Eigenschaften
|
|
Öffentliche Funktionen
| QBar3DSeries(QObject *parent = nullptr) | |
| QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QBar3DSeries() override |
| void | clearArray() |
| void | clearRow(qsizetype rowIndex) |
| QCategory3DAxis * | columnAxis() const |
| QStringList | columnLabels() const |
| QStringList | customColumnLabels() const |
| QStringList | customRowLabels() const |
| const QBarDataArray & | dataArray() const & |
| QBarDataArray | dataArray() && |
| QBarDataProxy * | dataProxy() const |
| bool | isValueColoringEnabled() const |
| float | meshAngle() const |
| void | resetColumnAxis() |
| void | resetRowAxis() |
| void | resetValueAxis() |
| QCategory3DAxis * | rowAxis() const |
| QList<QColor> | rowColors() const |
| QStringList | rowLabels() const |
| QPoint | selectedBar() const |
| void | setColumnAxis(QCategory3DAxis *axis) |
| void | setColumnLabels(const QStringList &labels) |
| void | setCustomColumnLabels(const QStringList &labels) |
| void | setCustomRowLabels(const QStringList &labels) |
| void | setDataArray(const QBarDataArray &newDataArray) |
| void | setDataProxy(QBarDataProxy *proxy) |
| void | setMeshAngle(float angle) |
| void | setRowAxis(QCategory3DAxis *axis) |
| void | setRowColors(const QList<QColor> &colors) |
| void | setRowLabels(const QStringList &labels) |
| void | setSelectedBar(QPoint position) |
| void | setValueAxis(QValue3DAxis *axis) |
| void | setValueColoringEnabled(bool enabled) |
| QValue3DAxis * | valueAxis() const |
Signale
| void | columnAxisChanged(QCategory3DAxis *axis) |
| void | columnLabelsChanged() |
| void | customColumnLabelsChanged(const QStringList &newCustomColumnLabels) |
| void | customRowLabelsChanged(const QStringList &newCustomRowLabels) |
| void | dataArrayChanged(const QBarDataArray &array) |
| void | dataProxyChanged(QBarDataProxy *proxy) |
| void | meshAngleChanged(float angle) |
| void | rowAxisChanged(QCategory3DAxis *axis) |
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
| void | rowLabelsChanged() |
| void | selectedBarChanged(QPoint position) |
| void | valueAxisChanged(QValue3DAxis *axis) |
| void | valueColoringEnabledChanged(bool enabled) |
Statische öffentliche Mitglieder
| QPoint | invalidSelectionPosition() |
Ausführliche Beschreibung
Diese Klasse verwaltet die serienspezifischen visuellen Elemente sowie die Seriendaten (über einen Daten-Proxy).
Im Hinblick auf die Beziehung zwischen Proxy und Serie ist es wichtig, einige zentrale Punkte hervorzuheben. In diesem Zusammenhang werden Daten in Serien gespeichert, und Benutzer können über die Serie auf den Datensatz zugreifen. Diese Serie wird durch ein Proxy-Objekt gesteuert oder repräsentiert. Somit kann der Proxy verwendet werden, um verschiedene Operationen an den Daten durchzuführen und den eigentlichen Datensatz zu aktualisieren. Um den Datensatz zu bearbeiten, muss jedoch eine mit diesem Proxy verknüpfte Serie erstellt werden.
Wenn für die Reihe kein Daten-Proxy explizit festgelegt ist, erstellt die Reihe einen Standard-Proxy. Das Festlegen eines anderen Proxys löscht den bestehenden Proxy und alle der Reihe hinzugefügten Daten.
QBar3DSeries unterstützt die folgenden Format-Tags für „ QAbstract3DSeries::setItemLabelFormat “ ():
| @rowTitle | Titel aus der Zeilenachse |
| @colTitle | Titel der Spaltenachse |
| @valueTitle | Titel der Wertachse |
| @rowIdx | Index der sichtbaren Zeile. Lokalisierung erfolgt anhand der Grafiklokalisierung. |
| @colIdx | Index der sichtbaren Spalte. Lokalisiert anhand der Graf-Lokalisierung. |
| @rowLabel | Beschriftung der Zeilenachse |
| @colLabel | Beschriftung der Spaltenachse |
| @valueLabel | Elementwert, formatiert gemäß dem Format der dem Diagramm zugeordneten Werteachse. Weitere Informationen finden Sie unter QValue3DAxis::labelFormat. |
| @seriesName | Name der Reihe |
| %<Formatangabe> | Elementwert im angegebenen Format. Die Formatierung erfolgt nach denselben Regeln wie unter QValue3DAxis::labelFormat beschrieben. |
Beispiel:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));Siehe auch „Qt Graphs -Datenverarbeitung mit 3D “ und „ Q3DGraphsWidgetItem::locale “.
Eigenschaftsdokumentation
[since 6.11] columnAxis : QCategory3DAxis*
Enthält eine zusätzliche Spaltenachse für die Reihe
Hinweis: Die zusätzliche Achse hat keinen Einfluss auf die Darstellung des Diagramms, ermöglicht jedoch einen zusätzlichen Satz von Beschriftungen und ein Achsenraster.
Diese Aufzählung wurde in Qt 6.11 eingeführt.
Zugriffsfunktionen:
| QCategory3DAxis * | columnAxis() const |
| void | setColumnAxis(QCategory3DAxis *axis) |
| void | resetColumnAxis() |
Notifier-Signal:
| void | columnAxisChanged(QCategory3DAxis *axis) |
columnLabels : QStringList
Diese Eigenschaft enthält die optionalen Spaltenbezeichnungen für das Array.
Die Indizes in diesem Array entsprechen den Spaltenindizes in den Zeilen. 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() |
[since 6.11] customColumnLabels : QStringList
Diese Eigenschaft enthält die optionalen benutzerdefinierten Spaltenbezeichnungen für das Array.
Diese Beschriftungen überschreiben alle von einem Proxy generierten Beschriftungen. Die Indizes in diesem Array entsprechen den Spaltenindizes in den Zeilen. Ist die Liste kürzer als die längste Zeile, erhalten nicht alle Spalten eine Beschriftung.
Diese Aufzählung wurde in Qt 6.11 eingeführt.
Zugriffsfunktionen:
| QStringList | customColumnLabels() const |
| void | setCustomColumnLabels(const QStringList &labels) |
Notifier-Signal:
| void | customColumnLabelsChanged(const QStringList &newCustomColumnLabels) |
[since 6.11] customRowLabels : QStringList
Diese Eigenschaft enthält die optionalen benutzerdefinierten Zeilenbezeichnungen für das Array.
Diese Beschriftungen überschreiben alle von einem Proxy generierten Beschriftungen. 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.
Diese Enumeration wurde in Qt 6.11 eingeführt.
Zugriffsfunktionen:
| QStringList | customRowLabels() const |
| void | setCustomRowLabels(const QStringList &labels) |
Notifier-Signal:
| void | customRowLabelsChanged(const QStringList &newCustomRowLabels) |
dataArray : QBarDataArray
Datenarray für die Reihe.
Enthält den Verweis auf das Datenarray.
Das Signal „dataArrayChanged“ wird ausgelöst, wenn das Datenarray festgelegt wird, es sei denn, „ newDataArray “ ist identisch mit dem vorherigen.
Hinweis: Bevor Sie irgendwelche Aktionen bezüglich des „dataArray“ durchführen, muss für den entsprechenden Proxy eine Serie angelegt 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 die Verantwortung für jeden ihr zugewiesenen Proxy und löscht jeden zuvor festgelegten Proxy, wenn ein neuer hinzugefügt wird. Der Proxy darf nicht null sein oder auf eine andere Reihe 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.
Das Setzen dieser Eigenschaft entspricht dem folgenden Aufruf:
setMeshRotation(QQuaternion::fromAxisAndAngle(0.0f, 1.0f, 0.0f, angle))Hinweis: Beim Auslesen dieser Eigenschaft wird der Wert anhand des Werts „ QAbstract3DSeries::meshRotation “ mit Gleitkommagenauigkeit berechnet und gibt stets einen Wert zwischen 0 und 360 Grad zurück.
Zugriffsfunktionen:
| float | meshAngle() const |
| void | setMeshAngle(float angle) |
Benachrichtigungssignal:
| void | meshAngleChanged(float angle) |
Siehe auch „ QAbstract3DSeries::meshRotation “.
[since 6.11] rowAxis : QCategory3DAxis*
Enthält eine zusätzliche Zeilenachse für die Reihe
Hinweis: Die zusätzliche Achse hat keinen Einfluss auf die Darstellung des Diagramms, ermöglicht jedoch einen zusätzlichen Satz von Beschriftungen und ein Achsenraster.
Diese Aufzählung wurde in Qt 6.11 eingeführt.
Zugriffsfunktionen:
| QCategory3DAxis * | rowAxis() const |
| void | setRowAxis(QCategory3DAxis *axis) |
| void | resetRowAxis() |
Notifier-Signal:
| void | rowAxisChanged(QCategory3DAxis *axis) |
rowColors : QList<QColor>
Diese Eigenschaft enthält die Liste der Zeilenfarben in der Reihe.
Mit dieser Eigenschaft können die Zeilen der Reihe in verschiedenen Farben dargestellt werden. Um diese Eigenschaft nutzen zu können, muss die Eigenschaft „ QGraphsTheme::ColorStyle “ auf „ QGraphsTheme::ColorStyle::Uniform “ gesetzt sein.
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 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() |
selectedBar : QPoint
Diese Eigenschaft enthält den Balken der ausgewählten Serie.
Zugriffsfunktionen:
| QPoint | selectedBar() const |
| void | setSelectedBar(QPoint position) |
Benachrichtigungssignal:
| void | selectedBarChanged(QPoint position) |
[since 6.11] valueAxis : QValue3DAxis*
Enthält eine zusätzliche Werteachse für die Reihe. Wenn eine Achse angegeben wird, wird die Reihe an die Minimal- und Maximalwerte der Achse angepasst.
Diese Aufzählung wurde in Qt 6.11 eingeführt.
Zugriffsfunktionen:
| QValue3DAxis * | valueAxis() const |
| void | setValueAxis(QValue3DAxis *axis) |
| void | resetValueAxis() |
Notifier-Signal:
| void | valueAxisChanged(QValue3DAxis *axis) |
[since 6.9] valueColoringEnabled : bool
Verwende den angegebenen Wert, um den gesamten Balken entsprechend dem Bereichsverlauf einzufärben
Mit dieser Eigenschaft kann jeder Balken separat anhand seines Werts und des angegebenen Bereichsverlaufs eingefärbt werden. Um diese Eigenschaft zu nutzen, muss die Eigenschaft „ QGraphsTheme::ColorStyle “ auf „ QGraphsTheme::ColorStyle::RangeGradient “ gesetzt sein.
Diese Aufzählung wurde in Qt 6.9 eingeführt.
Zugriffsfunktionen:
| bool | isValueColoringEnabled() const |
| void | setValueColoringEnabled(bool enabled) |
Notifier-Signal:
| void | valueColoringEnabledChanged(bool enabled) |
Siehe auch „ QGraphsTheme::ColorStyle::RangeGradient “.
Dokumentation der Mitgliedsfunktionen
[explicit] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
Erstellt eine 3D-Balkendiagrammreihe mit der übergeordneten parent.
[explicit] QBar3DSeries::QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr)
Erstellt eine 3D-Balkendiagrammreihe mit dem Daten-Proxy „ dataProxy “ und dem übergeordneten Element „ parent “.
[override virtual noexcept] QBar3DSeries::~QBar3DSeries()
Löscht eine 3D-Balkendiagrammreihe.
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 der Eigenschaft „ selectedBar “ zugewiesen, um die Auswahl aus dieser Serie 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 Datenarray der Reihe angegeben ist.
Es kann jeweils nur ein Balken ausgewählt werden.
Um die Auswahl aus dieser Reihe zu löschen, wird ` invalidSelectionPosition()` auf ` position` gesetzt.
Wird diese Reihe zu einem Diagramm hinzugefügt, kann das Diagramm die Auswahl entsprechend der Benutzerinteraktion anpassen oder die Auswahl aufheben, wenn sie ungültig wird. Die Auswahl eines Balkens in einer anderen hinzugefügten Reihe hebt die Auswahl ebenfalls auf.
Das Entfernen oder Einfügen von Zeilen in die Reihe 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()“.
© 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.
