Auf dieser Seite

QBarSeries Class

Die Klasse „QBarSeries“ stellt Daten in Balkendiagrammen dar. Mehr...

Kopfzeile: #include <QBarSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
In QML: BarSeries
Erbt von: QAbstractSeries

Öffentliche Typen

enum class BarsType { Groups, Stacked, StackedPercent }
enum class LabelsPosition { Center, InsideEnd, InsideBase, OutsideEnd }

Eigenschaften

Öffentliche Funktionen

QBarSeries(QObject *parent = nullptr)
bool append(QBarSet *set)
bool append(const QList<QBarSet *> &sets)
QBarSet *at(qsizetype index)
QQmlComponent *barDelegate() const
QList<QBarSet *> barSets() const
qreal barWidth() const
QBarSeries::BarsType barsType() const
QList<QColor> borderColors() const
void clear()
qsizetype count() const
qsizetype find(QBarSet *set) const
bool insert(qsizetype index, QBarSet *set)
qreal labelsAngle() const
QString labelsFormat() const
qreal labelsMargin() const
QBarSeries::LabelsPosition labelsPosition() const
int labelsPrecision() const
bool labelsVisible() const
bool remove(QBarSet *set)
bool remove(qsizetype index)
void removeMultiple(qsizetype index, qsizetype count)
bool replace(const QList<QBarSet *> &sets)
bool replace(QBarSet *oldValue, QBarSet *newValue)
void replace(qsizetype index, QBarSet *set)
QList<QColor> seriesColors() const
void setBarDelegate(QQmlComponent *newBarDelegate)
void setBarWidth(qreal width)
void setBarsType(QBarSeries::BarsType type)
void setBorderColors(const QList<QColor> &newBorderColors)
void setLabelsAngle(qreal angle)
void setLabelsFormat(const QString &format)
void setLabelsMargin(qreal margin)
void setLabelsPosition(QBarSeries::LabelsPosition position)
void setLabelsPrecision(int precision)
void setLabelsVisible(bool visible = true)
void setSeriesColors(const QList<QColor> &newSeriesColors)
bool take(QBarSet *set)

Neu implementierte öffentliche Funktionen

virtual QAbstractSeries::SeriesType type() const override

Signale

void barDelegateChanged()
void barSetsChanged()
void barWidthChanged()
void barsTypeChanged(QBarSeries::BarsType type)
void barsetsAdded(const QList<QBarSet *> &sets)
void barsetsRemoved(const QList<QBarSet *> &sets)
void borderColorsChanged()
void countChanged()
void labelsAngleChanged(qreal angle)
void labelsFormatChanged(const QString &format)
void labelsMarginChanged(qreal margin)
void labelsPositionChanged(QBarSeries::LabelsPosition position)
void labelsPrecisionChanged(int precision)
void labelsVisibleChanged(bool visible)
void seriesColorsChanged()
void setValueAdded(qsizetype index, qsizetype count, QBarSet *barset)
void setValueChanged(qsizetype index, QBarSet *barset)
void setValueRemoved(qsizetype index, qsizetype count, QBarSet *barset)
void updatedBars()

Detaillierte Beschreibung

Diese Klasse zeichnet Daten standardmäßig als eine Reihe von Balken dar, die nach Kategorien gruppiert sind, wobei pro Kategorie aus jedem Balkensatz ein Balken zur Reihe hinzugefügt wird. Sie unterstützt außerdem horizontale Balken und die Gruppierung von Balken als gestapelte Balken.

Für eine Balkenreihe muss die x-Achse „ GraphsView “ auf „ BarCategoryAxis “ und die y-Achse auf „ ValueAxis “ gesetzt sein.

Siehe auch „ QBarSet “ und „ QAbstractSeries “.

Dokumentation zu Mitgliedstypen

enum class QBarSeries::BarsType

Dieser Enum-Wert beschreibt den Typ der Balkenreihe:

KonstanteWertBeschreibung
QBarSeries::BarsType::Groups0Balkengruppen werden nach Kategorien gruppiert.
QBarSeries::BarsType::Stacked1Balkengruppen werden nach Kategorien übereinander angeordnet.
QBarSeries::BarsType::StackedPercent2Balkensätze werden nach Kategorien nacheinander gestapelt. Die Segmentgröße entspricht dem prozentualen Anteil des Segmentwerts am Gesamtwert aller Segmente im Stapel.

enum class QBarSeries::LabelsPosition

Dieser Enum-Wert beschreibt die Position der Datenwertbeschriftungen:

KonstanteWertBeschreibung
QBarSeries::LabelsPosition::Center0Die Beschriftung befindet sich in der Mitte des Balkens.
QBarSeries::LabelsPosition::InsideEnd1Die Beschriftung befindet sich oben im Balken.
QBarSeries::LabelsPosition::InsideBase2Die Beschriftung befindet sich innerhalb des Balkens unten.
QBarSeries::LabelsPosition::OutsideEnd3Das Etikett befindet sich oben außerhalb des Balkens.

Dokumentation zur Eigenschaft

barDelegate : QQmlComponent*

Diese Eigenschaft enthält eine benutzerdefinierte QML-Komponente, die zur Visualisierung der einzelnen Balken verwendet wird. Für jeden Balken wird eine Instanz dieser Komponente erstellt. Ist diese nicht definiert, wird eine Standardvisualisierung in Form eines Rechtecks für die Balken verwendet.

Die für diese Komponente verfügbaren dynamischen Eigenschaften sind:

TypNameBeschreibung
QColorbarColorDie Füllfarbe des Balkens. Dieser Wert stammt entweder aus der Eigenschaft „ QGraphsTheme “ oder aus „ QBarSet::color “, falls die Eigenschaft „ QBarSet “ die Farbe überschreibt.
QColorbarBorderColorDie Rahmenfarbe des Balkens. Dieser Wert stammt entweder aus der Datei „ QGraphsTheme “ oder aus der Datei „ QBarSet::borderColor “, falls die Datei „ QBarSet “ die Farbe überschreibt.
qrealbarBorderWidthDie Breite des Balkenrandes. Dieser Wert stammt entweder aus „ QGraphsTheme “ oder aus „ QBarSet::borderWidth “, falls „ QBarSet “ die Breite überschreibt.
qrealbarValueDer Wert des Balkens. Dieser Wert stammt aus dem „ QBarSet::values “.
QStringbarLabelDie Beschriftung des Balkens. Dieser Wert stammt aus der „ QBarSet::label “.
boolbarSelectedDieser Wert ist „true“, wenn der Balken ausgewählt ist, was bedeutet, dass der Balkenindex in „ QBarSet::selectedBars “ enthalten ist.
intbarIndexIndex des Balkens, von 0 bis zur Anzahl der Balken minus 1. [seit 6.9]

Um eine dieser Eigenschaften zu verwenden, fügen Sie eine Eigenschaft mit dem entsprechenden Namen in Ihre benutzerdefinierte Komponente ein. Zum Beispiel „ "property color barColor" “ und „ "property real barValue" “.

Zugriffsfunktionen:

QQmlComponent *barDelegate() const
void setBarDelegate(QQmlComponent *newBarDelegate)

Notifier-Signal:

void barDelegateChanged()

[read-only] barSets : QList<QBarSet *>

Diese Eigenschaft enthält eine Liste der Mengen, die der Reihe hinzugefügt wurden.

Zugriffsfunktionen:

QList<QBarSet *> barSets() const

Benachrichtigungssignal:

void barSetsChanged()

barWidth : qreal

Diese Eigenschaft gibt die Breite der Balken der Reihe an.

Die Einheit der Breite ist die Einheit der x-Achse. Die Mindestbreite für Balken beträgt null, und negative Werte werden als null behandelt. Wenn die Breite auf null gesetzt wird, beträgt die Breite des Balkens auf dem Bildschirm unabhängig vom Maßstab der x-Achse einen Pixel. Balken, die breiter als null sind, werden entsprechend dem Maßstab der x-Achse skaliert.

Standardmäßig beträgt „barWidth“ 0,5 (die Balken nehmen 50 % der verfügbaren Breite ein). Die gültigen Werte reichen von 0,0 (0 %) bis 1,0 (100 %).

Hinweis: Bei Verwendung mit ` QBarSeries` gibt dieser Wert die Breite einer Gruppe von Balken an, nicht die eines einzelnen Balkens.

Zugriffsfunktionen:

qreal barWidth() const
void setBarWidth(qreal width)

Benachrichtigungssignal:

void barWidthChanged()

Siehe auch „ QBarSeries “.

barsType : BarsType

Diese Eigenschaft gibt den Typ der Balkenreihe an.

Zugriffsfunktionen:

QBarSeries::BarsType barsType() const
void setBarsType(QBarSeries::BarsType type)

Benachrichtigungssignal:

void barsTypeChanged(QBarSeries::BarsType type)

borderColors : QList<QColor>

Diese Eigenschaft enthält die Liste der Rahmenfarben, die für alle Objekte in der Serie verwendet werden sollen.

Wenn es mehr Reihen als Farben gibt, wird die Farbliste umgebrochen und beginnt erneut mit der ersten Farbe in der Liste. Wenn diese Eigenschaft nicht festgelegt ist (Standard), werden Farben aus dem „ QGraphsTheme::borderColors “ verwendet.

Zugriffsfunktionen:

QList<QColor> borderColors() const
void setBorderColors(const QList<QColor> &newBorderColors)

Benachrichtigungssignal:

void borderColorsChanged()

[read-only] count : qsizetype

Diese Eigenschaft gibt die Anzahl der Balkensätze in einer Balkenreihe an.

Zugriffsfunktionen:

qsizetype count() const[see note below]

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

Notifier-Signal:

void countChanged()

labelsAngle : qreal

Diese Eigenschaft gibt den Winkel der Wertbeschriftungen in Grad an.

Zugriffsfunktionen:

qreal labelsAngle() const
void setLabelsAngle(qreal angle)

Benachrichtigungssignal:

void labelsAngleChanged(qreal angle)

labelsFormat : QString

Diese Eigenschaft legt das Format fest, das für die Anzeige von Beschriftungen in einer Balkenreihe verwendet wird.

QBarSeries Unterstützt das folgende Format-Tag:

@valueDer Wert des Balkens

Beispielsweise würde die folgende Verwendung der Format-Tags Beschriftungen erzeugen, die den Wert gefolgt von der Einheit (u) anzeigen:

series->setLabelsFormat("@value u");

Standardmäßig zeigen die Beschriftungen den Wert des Balkens an. Bei Prozent-Balkenreihen wird hinter dem Wert ein „%“ hinzugefügt. Die Beschriftungen werden im Diagrammbereich angezeigt; liegen die Balken dicht beieinander, können sich die Beschriftungen überlappen.

Zugriffsfunktionen:

QString labelsFormat() const
void setLabelsFormat(const QString &format)

Benachrichtigungssignal:

void labelsFormatChanged(const QString &format)

Siehe auch labelsVisible, labelsPosition und labelsPrecision.

labelsMargin : qreal

Diese Eigenschaft legt den Rand der Wertbeschriftungen in Pixeln fest.

Dieser seitliche Rand wird verwendet, wenn „ labelsPosition “ auf einen anderen Wert als „ LabelsPosition.Center “ gesetzt ist. Der Standardwert ist „ 0 “.

Zugriffsfunktionen:

qreal labelsMargin() const
void setLabelsMargin(qreal margin)

Benachrichtigungssignal:

void labelsMarginChanged(qreal margin)

labelsPosition : LabelsPosition

Diese Eigenschaft legt die Position der Wertbeschriftungen fest.

Zugriffsfunktionen:

QBarSeries::LabelsPosition labelsPosition() const
void setLabelsPosition(QBarSeries::LabelsPosition position)

Benachrichtigungssignal:

void labelsPositionChanged(QBarSeries::LabelsPosition position)

Siehe auch labelsVisible und labelsFormat.

labelsPrecision : int

Diese Eigenschaft legt die maximale Anzahl der in Wertbeschriftungen angezeigten signifikanten Ziffern fest.

Der Standardwert beträgt 6.

Zugriffsfunktionen:

int labelsPrecision() const
void setLabelsPrecision(int precision)

Benachrichtigungssignal:

void labelsPrecisionChanged(int precision)

labelsVisible : bool

Diese Eigenschaft legt die Sichtbarkeit der Beschriftungen in einer Balkenreihe fest. Die Standardsichtbarkeit der Beschriftungen ist „ false “.

Hinweis: Die Standardbeschriftung zeigt nur den Wert des Datensatzes an. Sie können benutzerdefinierte Beschriftungen mit „ barDelegate “ erstellen.

Zugriffsfunktionen:

bool labelsVisible() const
void setLabelsVisible(bool visible = true)

Benachrichtigungssignal:

void labelsVisibleChanged(bool visible)

Siehe auch „ barDelegate “.

seriesColors : QList<QColor>

Diese Eigenschaft enthält die Liste der Grundfarben, die für alle Objekte der Serie verwendet werden sollen.

Wenn es mehr Serien als Farben gibt, wird die Farbliste umgebrochen und beginnt erneut mit der ersten Farbe in der Liste. Ist diese Eigenschaft nicht festgelegt (Standard), werden Farben aus dem „ QGraphsTheme::seriesColors “ verwendet.

Zugriffsfunktionen:

QList<QColor> seriesColors() const
void setSeriesColors(const QList<QColor> &newSeriesColors)

Benachrichtigungssignal:

void seriesColorsChanged()

Dokumentation der Member-Funktionen

[explicit] QBarSeries::QBarSeries(QObject *parent = nullptr)

Erstellt eine leere Balkenreihe, die ein „ QObject “ ist und zu „ parent “ gehört.

[invokable] bool QBarSeries::append(QBarSet *set)

Fügt der Balkenreihe eine durch ` set ` angegebene Gruppe von Balken hinzu und übernimmt die Verantwortung dafür. Ist die Gruppe null oder gehört sie bereits zur Reihe, wird sie nicht angehängt. Gibt ` true ` zurück, wenn das Anhängen erfolgreich war.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] bool QBarSeries::append(const QList<QBarSet *> &sets)

Fügt einer Balkenreihe eine Liste von Balkensätzen hinzu, die durch ` sets ` angegeben sind, und übernimmt die Verantwortung für diese Sätze. Gibt „ true “ zurück, wenn alle Sets erfolgreich angehängt wurden. Ist eines der Sets null oder wurde es zuvor bereits an die Serie angehängt, wird nichts angehängt und diese Funktion gibt „ false “ zurück. Taucht eines der Sets mehr als einmal in der Liste auf, wird nichts angehängt und diese Funktion gibt „ false “ zurück.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] QBarSet *QBarSeries::at(qsizetype index)

Ruft das unter der Adresse index angegebene „ BarSet “ ab. Gibt „null“ zurück, wenn kein „ BarSet “ gefunden wurde.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

QList<QBarSet *> QBarSeries::barSets() const

Gibt eine Liste der Balkensätze in einer Balkenreihe zurück. Behält die Eigentumsrechte an den Balkensätzen.

Hinweis: Getter -Funktion für die Eigenschaft `barSets`.

qreal QBarSeries::barWidth() const

Gibt die Breite der Balken der Reihe zurück.

Hinweis: Getter- Funktion für die Eigenschaft `barWidth`.

Siehe auch „ setBarWidth()“.

[signal] void QBarSeries::barsetsAdded(const QList<QBarSet *> &sets)

Dieses Signal wird ausgegeben, wenn die unter sets angegebenen Balken zur Reihe hinzugefügt werden.

Siehe auch append() und insert().

[signal] void QBarSeries::barsetsRemoved(const QList<QBarSet *> &sets)

Dieses Signal wird ausgegeben, wenn die unter „ sets “ festgelegten Balken aus der Reihe entfernt werden.

Siehe auch „ remove()“.

[invokable] void QBarSeries::clear()

Entfernt alle Balkensätze aus der Serie und löscht sie endgültig.

Hinweis: Diese Funktion kann über das Metaobjekt-System und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] qsizetype QBarSeries::count() const

Gibt die Anzahl der Balkensätze in einer Balkenreihe zurück.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

Hinweis: Getter -Funktion für die Eigenschaft „count“.

[invokable] qsizetype QBarSeries::find(QBarSet *set) const

Gibt den Index des ersten gefundenen „ BarSet “ zurück, wie in set definiert. Gibt -1 zurück, wenn kein „ BarSet “ gefunden wurde.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] bool QBarSeries::insert(qsizetype index, QBarSet *set)

Fügt eine durch ` set ` angegebene Balkengruppe an der durch ` index ` angegebenen Position in eine Reihe ein und übernimmt die Eigentumsrechte an der Gruppe. Ist die Gruppe null oder gehört sie bereits zur Reihe, wird sie nicht angehängt. Gibt ` true ` zurück, wenn das Einfügen erfolgreich war.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

bool QBarSeries::labelsVisible() const

Gibt die Sichtbarkeit von Beschriftungen zurück.

Hinweis: Getter -Funktion für die Eigenschaft „labelsVisible“.

Siehe auch „ setLabelsVisible()“.

[signal] void QBarSeries::labelsVisibleChanged(bool visible)

Dieses Signal wird ausgelöst, wenn sich die Sichtbarkeit der Beschriftungen auf „ visible “ ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ labelsVisible “.

Siehe auch „ labelsVisible()“ und „ setLabelsVisible()“.

[invokable] bool QBarSeries::remove(QBarSet *set)

Entfernt die durch ` set ` angegebene Balkengruppe aus der Serie und löscht sie endgültig, sofern das Entfernen erfolgreich war. Gibt ` true ` zurück, wenn die Gruppe entfernt wurde.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] bool QBarSeries::remove(qsizetype index)

Entfernt das „ BarSet “ an der Stelle „ index “. Das „ BarSet “ wird endgültig gelöscht.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QBarSeries::removeMultiple(qsizetype index, qsizetype count)

Entfernt mehrere BarSets aus der Serie, beginnend bei „ index “ bis zur Anzahl „ count “. Die BarSets werden dauerhaft gelöscht.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] bool QBarSeries::replace(const QList<QBarSet *> &sets)

Ersetzt die gesamte Liste „ BarSet “ innerhalb dieses „ BarSeries “ durch die unter „ sets “ angegebenen BarSets. Alle ursprünglichen BarSets werden dauerhaft gelöscht. Gibt „ true “ zurück, wenn alle BarSets ersetzt wurden.

Hinweis: Diese Funktion kann über das Metaobjekt-System und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] bool QBarSeries::replace(QBarSet *oldValue, QBarSet *newValue)

Ersetzt das unter oldValue angegebene „ BarSet “ durch das unter newValue angegebene. Das „ BarSet “ unter oldValue wird dauerhaft gelöscht, sofern es innerhalb der Serie gefunden wird. Gibt „ true “ zurück, wenn das Ersetzen erfolgreich war.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QBarSeries::replace(qsizetype index, QBarSet *set)

Ersetzt die Seite „ BarSet “, die unter index zu finden ist, durch set. Die ursprüngliche Seite BarSet wird endgültig gelöscht.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

void QBarSeries::setBarWidth(qreal width)

Legt die Breite der Balken der Reihe auf „ width “ fest.

Hinweis: Setter -Funktion für die Eigenschaft „ barWidth “.

Siehe auch ` barWidth()`.

void QBarSeries::setLabelsVisible(bool visible = true)

Legt die Sichtbarkeit von Beschriftungen in einer Balkenreihe auf „ visible “ fest.

Hinweis: Setter -Funktion für die Eigenschaft „ labelsVisible “.

Siehe auch ` labelsVisible()`.

[signal] void QBarSeries::setValueAdded(qsizetype index, qsizetype count, QBarSet *barset)

Dieses Signal wird ausgelöst, wenn der Wert eines Barsets geändert wird. ` index ` ist der Index des Barsets in der Serie. Die Anzahl der hinzugefügten Werte wird unter ` count` angegeben. ` barset ` ist ein Zeiger auf das geänderte Set.

[signal] void QBarSeries::setValueChanged(qsizetype index, QBarSet *barset)

Dieses Signal wird ausgelöst, wenn der Wert eines Balkensatzes geändert wird. „ index “ ist der Index des Balkensatzes in der Reihe. „ barset “ ist ein Zeiger auf den geänderten Satz.

[signal] void QBarSeries::setValueRemoved(qsizetype index, qsizetype count, QBarSet *barset)

Dieses Signal wird ausgelöst, wenn der Wert eines Barsets geändert wird. „ index “ ist der Index des Barsets in der Reihe. Die Anzahl der entfernten Werte wird unter „ count “ angegeben. „ barset “ ist ein Zeiger auf das geänderte Set.

[invokable] bool QBarSeries::take(QBarSet *set)

Ruft ein einzelnes „ set “-Objekt aus der Serie ab. Das Barset-Objekt wird dabei nicht gelöscht.

Hinweis: Die Serie bleibt das übergeordnete Objekt des Bar-Sets. Sie müssen das übergeordnete Objekt festlegen, um die vollständige Eigentümerschaft zu übernehmen.

Gibt ` true ` zurück, wenn der `take`-Vorgang erfolgreich war.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

[override virtual] QAbstractSeries::SeriesType QBarSeries::type() const

Implementiert eine Zugriffsfunktion für die Eigenschaft „ QAbstractSeries::type “ neu.

Gibt die Balkenreihe zurück.

[signal] void QBarSeries::updatedBars()

Dieses Signal wird ausgegeben, wenn die Balken aktualisiert werden.

© 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.