QBar3DSeries Class
Die Klasse QBar3DSeries stellt eine Datenreihe in einem 3D-Balkendiagramm dar. Mehr...
| Kopfzeile: | #include <QBar3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Since: | QtDataVisualization 1.0 |
| In QML: | Bar3DSeries |
| Vererbt: | QAbstract3DSeries |
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).
Wenn kein Daten-Proxy explizit für die Serie gesetzt ist, erstellt die Serie einen Standard-Proxy. Das Setzen eines anderen Proxys zerstört den bestehenden Proxy und alle ihm 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 Data Visualization Datenverarbeitung und QAbstract3DGraph::locale.
Dokumentation der Eigenschaft
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.
[since 6.3] 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 Q3DTheme::ColorStyle muss auf Q3DTheme::ColorStyleUniform gesetzt werden, um diese Eigenschaft zu verwenden.
Diese Eigenschaft 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 ausgewählten Takt der Serie.
Zugriffsfunktionen:
| QPoint | selectedBar() const |
| void | setSelectedBar(const QPoint &position) |
Benachrichtigungssignal:
| void | selectedBarChanged(const QPoint &position) |
Member Function Dokumentation
[explicit] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
Konstruiert eine 3D-Stabserie mit dem übergeordneten parent.
[explicit] QBar3DSeries::QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr)
Konstruiert eine 3D-Balkenreihe mit dem Datenproxy dataProxy und dem übergeordneten parent.
[virtual noexcept] QBar3DSeries::~QBar3DSeries()
Löscht eine 3D-Balkenserie.
[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 QAbstract3DGraph::clearSelection().
void QBar3DSeries::setSelectedBar(const 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 für diese Reihe aufzuheben, 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 aufgehoben.
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 QAbstract3DGraph::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.
