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

Ö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

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():

@rowTitleTitel der Zeilenachse
@colTitleTitel der Spaltenachse
@valueTitleTitel aus der Wertachse
@rowIdxSichtbarer Zeilenindex. Lokalisiert unter Verwendung des Gebietsschemas der Grafik.
@colIdxSichtbarer Spaltenindex. Wird unter Verwendung des Diagrammgebietsschemas lokalisiert.
@rowLabelBeschriftung der Zeilenachse
@colLabelLabel von der Spaltenachse
@valueLabelElementwert, formatiert unter Verwendung des Formats der dem Diagramm zugeordneten Wertachse. Für weitere Informationen, siehe QValue3DAxis::labelFormat.
@ReihennameName 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.