QBar3DSeries Class
Die Klasse „QBar3DSeries“ stellt eine Datenreihe in einem 3D-Balkendiagramm dar. Mehr...
| Header: | #include <QBar3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Seit: | QtDataVisualization 1.0 |
| In QML: | Bar3DSeries |
| Erbt von: | QAbstract3DSeries |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Eigenschaften
- dataProxy : QBarDataProxy*
- meshAngle : float
(since 6.3)rowColors : QList<QColor>- selectedBar : QPoint
Öffentliche Funktionen
| QBar3DSeries(QObject *parent = nullptr) | |
| QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QBar3DSeries() |
| QBarDataProxy * | dataProxy() const |
| float | meshAngle() const |
| QList<QColor> | rowColors() const |
| QPoint | selectedBar() const |
| void | setDataProxy(QBarDataProxy *proxy) |
| void | setMeshAngle(float angle) |
| void | setRowColors(const QList<QColor> &colors) |
| void | setSelectedBar(const QPoint &position) |
Signale
| void | dataProxyChanged(QBarDataProxy *proxy) |
| void | meshAngleChanged(float angle) |
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
| void | selectedBarChanged(const QPoint &position) |
Statische öffentliche Mitglieder
| QPoint | invalidSelectionPosition() |
Detaillierte Beschreibung
Diese Klasse verwaltet die serienspezifischen visuellen Elemente sowie die Seriendaten (über einen Daten-Proxy).
Wird für die Reihe kein Datenproxy explizit festgelegt, erstellt die Reihe einen Standardproxy. Das Festlegen eines anderen Proxys löscht den bestehenden Proxy und alle ihm 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. Lokalisierung erfolgt 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 Data Visualization -Datenverarbeitung “ und „ QAbstract3DGraph::locale “.
Eigenschaftsdokumentation
dataProxy : QBarDataProxy*
Diese Eigenschaft enthält den aktiven Datenproxy.
Die Reihe übernimmt die Verwaltung aller ihr zugewiesenen Proxys und löscht alle zuvor zugewiesenen Proxys, sobald 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 null und 360 Grad zurück.
Zugriffsfunktionen:
| float | meshAngle() const |
| void | setMeshAngle(float angle) |
Benachrichtigungssignal:
| void | meshAngleChanged(float angle) |
Siehe auch „ QAbstract3DSeries::meshRotation “.
[since 6.3] rowColors : QList<QColor>
Diese Eigenschaft enthält die Liste der Zeilenfarben in der Reihe.
Mit dieser Eigenschaft können die Zeilen der Serie in verschiedenen Farben dargestellt werden. Um diese Eigenschaft nutzen zu können, muss die Eigenschaft „ Q3DTheme::ColorStyle “ auf „ Q3DTheme::ColorStyleUniform “ gesetzt sein.
Diese Enumeration wurde in Qt 6.3 eingeführt.
Zugriffsfunktionen:
| QList<QColor> | rowColors() const |
| void | setRowColors(const QList<QColor> &colors) |
Notifier-Signal:
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
Siehe auch „ Q3DTheme::ColorStyleUniform “.
selectedBar : QPoint
Diese Eigenschaft enthält den Balken der ausgewählten Reihe.
Zugriffsfunktionen:
| QPoint | selectedBar() const |
| void | setSelectedBar(const QPoint &position) |
Benachrichtigungssignal:
| void | selectedBarChanged(const QPoint &position) |
Dokumentation der Member-Funktionen
[explicit] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
Erstellt eine 3D-Stab-Serie mit dem übergeordneten Element „ parent “.
[explicit] QBar3DSeries::QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr)
Erstellt eine 3D-Balkendiagrammreihe mit dem Daten-Proxy „ dataProxy “ und dem übergeordneten Element „ parent “.
[virtual noexcept] QBar3DSeries::~QBar3DSeries()
Löscht eine 3D-Balkenreihe.
[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 Reihe zu löschen.
Siehe auch „ QAbstract3DGraph::clearSelection()“.
void QBar3DSeries::setSelectedBar(const QPoint &position)
Wählt den Balken an der Position „ position “ aus, der 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 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 „ QAbstract3DGraph::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.
