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 |
| Vererbt: | QAbstractSeries |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QBarSeries ist Teil von Qt Graphs C++ Classes for 2D.
Ö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) |
Reimplementierte ö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, die nach Kategorien gruppiert sind, wobei ein Balken pro Kategorie aus jedem Balkensatz zur Reihe hinzugefügt wird. Sie unterstützt auch horizontale Balken und gruppierte Balken als gestapelt.
Für eine Balkenreihe muss die x-Achse GraphsView auf BarCategoryAxis und die y-Achse auf ValueAxis gesetzt werden.
Siehe auch QBarSet und QAbstractSeries.
Dokumentation der Mitgliedsarten
enum class QBarSeries::BarsType
Dieser Enum-Wert beschreibt den Typ der Balkenreihe:
| Konstante | Wert | Beschreibung |
|---|---|---|
QBarSeries::BarsType::Groups | 0 | Balkensätze werden nach Kategorie gruppiert. |
QBarSeries::BarsType::Stacked | 1 | Balkensätze werden nach Kategorie hintereinander gestapelt. |
QBarSeries::BarsType::StackedPercent | 2 | Balkensätze werden nach Kategorie hintereinander gestapelt. Die Segmentgröße entspricht dem prozentualen Anteil des Segmentwertes im Vergleich zum Gesamtwert aller Segmente im Stapel. |
enum class QBarSeries::LabelsPosition
Dieser Enum-Wert beschreibt die Position der Datenwertbeschriftungen:
| Konstante | Wert | Beschreibung |
|---|---|---|
QBarSeries::LabelsPosition::Center | 0 | Das Etikett befindet sich in der Mitte des Balkens. |
QBarSeries::LabelsPosition::InsideEnd | 1 | Die Beschriftung befindet sich oben innerhalb des Balkens. |
QBarSeries::LabelsPosition::InsideBase | 2 | Die Beschriftung befindet sich innerhalb des Balkens am unteren Rand. |
QBarSeries::LabelsPosition::OutsideEnd | 3 | Die Beschriftung befindet sich außerhalb des oberen Balkens. |
Eigenschaft Dokumentation
barDelegate : QQmlComponent*
Diese Eigenschaft enthält eine benutzerdefinierte QML-Komponente, die für die Visualisierung der einzelnen Balken verwendet wird. Eine Instanz dieser Komponente wird für jeden Balken erstellt. Wenn diese Komponente nicht definiert ist, wird eine standardmäßige Rechteckdarstellung für Balken verwendet.
Die für diese Komponente verfügbaren dynamischen Eigenschaften sind:
| Typ | Name | Beschreibung |
|---|---|---|
| QColor | barColor | Die Füllfarbe des Balkens. Dieser Wert stammt entweder von QGraphsTheme oder von QBarSet::color, wenn QBarSet die Farbe überschreibt. |
| QColor | barBorderColor | Die Farbe des Rahmens des Balkens. Dieser Wert stammt entweder aus QGraphsTheme oder aus QBarSet::borderColor, wenn QBarSet die Farbe überschreibt. |
| qreal | barBorderWidth | Die Breite der Umrandung des Balkens. Dieser Wert stammt entweder aus QGraphsTheme oder aus QBarSet::borderWidth, wenn QBarSet die Breite überschreibt. |
| qreal | barValue | Der Wert des Balkens. Dieser Wert stammt aus dem QBarSet::values. |
| QString | barLabel | Die Beschriftung des Balkens. Dieser Wert stammt aus dem QBarSet::label. |
| bool | barSelected | Dieser Wert ist wahr, wenn der Balken ausgewählt ist, was bedeutet, dass der Balkenindex in QBarSet::selectedBars steht. |
Um eine dieser Eigenschaften zu verwenden, fügen Sie die Eigenschaft mit dem definierten Namen in Ihre benutzerdefinierte Komponente ein. Zum Beispiel "property color barColor" und "property real barValue".
Zugriffsfunktionen:
| QQmlComponent * | barDelegate() const |
| void | setBarDelegate(QQmlComponent *newBarDelegate) |
Benachrichtigungssignal:
| void | barDelegateChanged() |
[read-only] barSets : QList<QBarSet *> const
Diese Eigenschaft enthält eine Liste der zur Serie hinzugefügten Sets.
Zugriffsfunktionen:
| QList<QBarSet *> | barSets() const |
Benachrichtigungssignal:
| void | barSetsChanged() |
barWidth : qreal
Diese Eigenschaft bestimmt die Breite der Balken der Reihe.
Die Einheit der Breite ist die Einheit der x-Achse. Die Mindestbreite für Balken ist Null, und negative Werte werden als Null behandelt. Die Einstellung der Breite auf Null bedeutet, dass die Breite des Balkens auf dem Bildschirm ein Pixel beträgt, unabhängig von der Skalierung der x-Achse. Balken, die breiter als Null sind, werden anhand der Skala der x-Achse skaliert.
Die Standardeinstellung für barWidth ist 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 anstelle der eines einzelnen Balkens an.
Zugriffsfunktionen:
| qreal | barWidth() const |
| void | setBarWidth(qreal width) |
Melder-Signal:
| void | barWidthChanged() |
Siehe auch QBarSeries.
barsType : BarsType
Diese Eigenschaft enthält den Typ der Balkenreihe.
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 der Serie verwendet werden sollen.
Wenn es mehr Serien als Farben gibt, wird die Farbliste umbrochen und beginnt wieder mit der ersten Farbe in der Liste. Wenn diese Eigenschaft nicht gesetzt ist (Standard), werden die Farben aus QGraphsTheme::borderColors verwendet.
Zugriffsfunktionen:
| QList<QColor> | borderColors() const |
| void | setBorderColors(const QList<QColor> &newBorderColors) |
Benachrichtigungssignal:
| void | borderColorsChanged() |
[read-only] count : const qsizetype
Diese Eigenschaft gibt die Anzahl der Takte in einer Taktreihe an.
Zugriffsfunktionen:
| qsizetype | count() const | [see note below] |
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Melder-Signal:
| void | countChanged() |
labelsAngle : qreal
Diese Eigenschaft enthält den Winkel der Wertelabels in Grad.
Zugriffsfunktionen:
| qreal | labelsAngle() const |
| void | setLabelsAngle(qreal angle) |
Melder-Signal:
| void | labelsAngleChanged(qreal angle) |
labelsFormat : QString
Diese Eigenschaft enthält das Format, das für die Anzeige von Beschriftungen in einer Balkenreihe verwendet wird.
QBarSeries unterstützt das folgende Format-Tag:
| @value | Der Wert des Balkens |
Die folgende Verwendung der Format-Tags würde zum Beispiel Beschriftungen erzeugen, die den Wert gefolgt von der Einheit (u) anzeigen:
series->setLabelsFormat("@value u");
Standardmäßig zeigen die Etiketten den Wert des Balkens an. Bei der prozentualen Balkenreihe wird nach dem Wert ein % hinzugefügt. Wenn die Balken nahe beieinander liegen, 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 enthält den Rand der Wertelabels in Pixeln.
Dieser Seitenrand 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 enthält die Position der Wertelabels.
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 signifikanter Ziffern fest, die in Wertelabels angezeigt werden.
Der Standardwert ist 6.
Zugriffsfunktionen:
| int | labelsPrecision() const |
| void | setLabelsPrecision(int precision) |
Melder-Signal:
| void | labelsPrecisionChanged(int precision) |
labelsVisible : bool
Diese Eigenschaft bestimmt die Sichtbarkeit der Beschriftungen in einer Balkenreihe. Die Standardeinstellung für die Sichtbarkeit der Beschriftungen ist false.
Zugriffsfunktionen:
| bool | labelsVisible() const |
| void | setLabelsVisible(bool visible = true) |
Melder-Signal:
| void | labelsVisibleChanged(bool visible) |
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 umbrochen und beginnt wieder mit der ersten Farbe in der Liste. Wenn diese Eigenschaft nicht gesetzt ist (Standard), werden die Farben aus QGraphsTheme::seriesColors verwendet.
Zugriffsfunktionen:
| QList<QColor> | seriesColors() const |
| void | setSeriesColors(const QList<QColor> &newSeriesColors) |
Benachrichtigungssignal:
| void | seriesColorsChanged() |
Dokumentation der Mitgliedsfunktionen
[explicit] QBarSeries::QBarSeries(QObject *parent = nullptr)
Konstruiert eine leere Balkenreihe, die eine QObject und ein Kind von parent ist.
[invokable] bool QBarSeries::append(QBarSet *set)
Fügt einen Satz von Takten, der durch set angegeben wird, zur Taktreihe hinzu und übernimmt den Besitz an ihm. Wenn der Satz null ist oder bereits zur Serie gehört, wird er nicht angehängt. Gibt true zurück, wenn das Anhängen erfolgreich war.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] bool QBarSeries::append(const QList<QBarSet *> &sets)
Fügt eine Liste von Taktsätzen, die durch sets angegeben wird, zu einer Taktreihe hinzu und übernimmt den Besitz an den Sätzen. Gibt true zurück, wenn alle Sätze erfolgreich angehängt wurden. Wenn einer der Sätze null ist oder zuvor an die Serie angehängt wurde, wird nichts angehängt und diese Funktion gibt false zurück. Wenn einer der Sätze mehr als einmal in der Liste erscheint, wird nichts angehängt und diese Funktion gibt false zurück.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] QBarSet *QBarSeries::at(qsizetype index)
Ruft die BarSet ab, die an der Stelle index angegeben ist. Gibt null zurück, wenn kein BarSet gefunden wurde.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
QList<QBarSet *> QBarSeries::barSets() const
Liefert eine Liste von Taktsätzen in einer Taktreihe. Behält die Eigenschaft der Taktsätze bei.
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 durch sets angegebenen Taktsätze zur Serie hinzugefügt werden.
Siehe auch append() und insert().
[signal] void QBarSeries::barsetsRemoved(const QList<QBarSet *> &sets)
Dieses Signal wird ausgegeben, wenn die durch sets angegebenen Taktsätze aus der Reihe entfernt werden.
Siehe auch remove().
[invokable] void QBarSeries::clear()
Entfernt alle Taktsätze aus der Serie und löscht sie dauerhaft.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] qsizetype QBarSeries::count() const
Gibt die Anzahl der Takte in einer Taktreihe zurück.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus 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 durch set definiert. Gibt -1 zurück, wenn kein BarSet gefunden wurde.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] bool QBarSeries::insert(qsizetype index, QBarSet *set)
Fügt einen durch set angegebenen Taktsatz an der durch index angegebenen Position in eine Reihe ein und übernimmt den Satz. Wenn die Menge null ist oder bereits zur Serie gehört, wird sie nicht angefügt. Gibt true zurück, wenn das Einfügen erfolgreich war.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
bool QBarSeries::labelsVisible() const
Gibt die Sichtbarkeit von Labels zurück.
Hinweis: Getter-Funktion für die Eigenschaft labelsVisible.
Siehe auch setLabelsVisible().
[signal] void QBarSeries::labelsVisibleChanged(bool visible)
Dieses Signal wird ausgegeben, wenn sich die Sichtbarkeit der Etiketten auf visible ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft labelsVisible.
Siehe auch labelsVisible() und setLabelsVisible().
[invokable] bool QBarSeries::remove(QBarSet *set)
Entfernt die durch set angegebene Taktmenge aus der Serie und löscht sie dauerhaft, wenn die Entfernung erfolgreich war. Gibt true zurück, wenn der Satz entfernt wurde.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] bool QBarSeries::remove(qsizetype index)
Entfernt die Datei BarSet an der Stelle index. Das BarSet wird dauerhaft gelöscht.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QBarSeries::removeMultiple(qsizetype index, qsizetype count)
Entfernt mehrere BarSets aus der Serie beginnend mit index bis zu einer Anzahl von count. Die BarSets werden dauerhaft gelöscht.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] bool QBarSeries::replace(const QList<QBarSet *> &sets)
Ersetzt die gesamte Liste BarSet innerhalb dieser BarSeries durch die in 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 Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] bool QBarSeries::replace(QBarSet *oldValue, QBarSet *newValue)
Ersetzt die in oldValue angegebene BarSet durch die in newValue angegebene. Die BarSet in oldValue wird dauerhaft gelöscht, wenn sie innerhalb der Serie gefunden wird. Gibt true zurück, wenn das Ersetzen erfolgreich war.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QBarSeries::replace(qsizetype index, QBarSet *set)
Ersetzt das unter index vorhandene BarSet durch set. Das Original BarSet wird dauerhaft gelöscht.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
void QBarSeries::setBarWidth(qreal width)
Setzt die Breite der Balken der Reihe auf width.
Hinweis: Setter-Funktion für die Eigenschaft barWidth.
Siehe auch barWidth().
void QBarSeries::setLabelsVisible(bool visible = true)
Setzt die Sichtbarkeit von Beschriftungen in einer Balkenreihe auf visible.
Hinweis: Setter-Funktion für die Eigenschaft labelsVisible.
Siehe auch labelsVisible().
[signal] void QBarSeries::setValueAdded(qsizetype index, qsizetype count, QBarSet *barset)
Dieses Signal wird ausgegeben, wenn der Wert eines Barsets geändert wird. index ist der Index des Barsets in der Serie. Die Anzahl der hinzugefügten Werte wird mit count angegeben. Bei barset handelt es sich um einen Zeiger auf den geänderten Satz.
[signal] void QBarSeries::setValueChanged(qsizetype index, QBarSet *barset)
Dieses Signal wird ausgegeben, wenn der Wert eines Barsets geändert wird. index ist der Index des Barsets in der Serie. barset ist ein Zeiger auf den geänderten Satz.
[signal] void QBarSeries::setValueRemoved(qsizetype index, qsizetype count, QBarSet *barset)
Dieses Signal wird ausgegeben, wenn der Wert eines Barsets geändert wird. index ist der Index des Barsets in der Serie. Die Anzahl der entfernten Werte wird mit count angegeben. barset ist ein Zeiger auf den geänderten Satz.
[invokable] bool QBarSeries::take(QBarSet *set)
Entnimmt einen einzelnen set aus der Serie. Das Objekt der Taktreihe wird nicht gelöscht.
Hinweis: Die Serie bleibt das übergeordnete Objekt des Taktsatzes. Sie müssen das übergeordnete Objekt setzen, um den vollen Besitz zu übernehmen.
Gibt true zurück, wenn der Vorgang "take" erfolgreich war.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[override virtual] QAbstractSeries::SeriesType QBarSeries::type() const
Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QAbstractSeries::type.
Gibt die Balkenreihe zurück.
[signal] void QBarSeries::updatedBars()
Dieses Signal wird ausgegeben, wenn die Balken aktualisiert werden.
© 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.
