QAbstractBarSeries Class
Die Klasse „QAbstractBarSeries“ ist eine abstrakte Oberklasse für alle Balkenreihenklassen. Mehr...
| Header: | #include <QAbstractBarSeries> |
| In QML: | AbstractBarSeries |
| Inherits: | QAbstractSeries |
| Inherited By: | QBarSeries, QHorizontalBarSeries, QHorizontalPercentBarSeries, QHorizontalStackedBarSeries, QPercentBarSeries, and QStackedBarSeries |
| Status: | Deprecated |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Öffentliche Typen
| enum | LabelsPosition { LabelsCenter, LabelsInsideEnd, LabelsInsideBase, LabelsOutsideEnd } |
Eigenschaften
|
|
Öffentliche Funktionen
| virtual | ~QAbstractBarSeries() |
| bool | append(QBarSet *set) |
| bool | append(const QList<QBarSet *> &sets) |
| QList<QBarSet *> | barSets() const |
| qreal | barWidth() const |
| void | clear() |
| int | count() const |
| bool | insert(int index, QBarSet *set) |
| bool | isLabelsVisible() const |
| qreal | labelsAngle() const |
| QString | labelsFormat() const |
| QAbstractBarSeries::LabelsPosition | labelsPosition() const |
| int | labelsPrecision() const |
| bool | remove(QBarSet *set) |
| void | setBarWidth(qreal width) |
| void | setLabelsAngle(qreal angle) |
| void | setLabelsFormat(const QString &format) |
| void | setLabelsPosition(QAbstractBarSeries::LabelsPosition position) |
| void | setLabelsPrecision(int precision) |
| void | setLabelsVisible(bool visible = true) |
| bool | take(QBarSet *set) |
Signale
| void | barsetsAdded(const QList<QBarSet *> &sets) |
| void | barsetsRemoved(const QList<QBarSet *> &sets) |
| void | clicked(int index, QBarSet *barset) |
| void | countChanged() |
| void | doubleClicked(int index, QBarSet *barset) |
| void | hovered(bool status, int index, QBarSet *barset) |
| void | labelsAngleChanged(qreal angle) |
| void | labelsFormatChanged(const QString &format) |
| void | labelsPositionChanged(QAbstractBarSeries::LabelsPosition position) |
| void | labelsPrecisionChanged(int precision) |
| void | labelsVisibleChanged() |
| void | pressed(int index, QBarSet *barset) |
| void | released(int index, QBarSet *barset) |
Ausführliche Beschreibung
In Balkendiagrammen werden Balken als Balkensätze definiert, die für jede Kategorie einen Datenwert enthalten. Die Position eines Balkens wird durch die Kategorie und seine Höhe durch den Datenwert bestimmt. Balkenreihen, die mehrere Balkensätze enthalten, gruppieren Balken, die zur selben Kategorie gehören. Die Art und Weise, wie die Balken dargestellt werden, hängt von der Unterklasse dieser Klasse ab, die zur Erstellung des Balkendiagramms ausgewählt wurde.
Wird für die Hauptbalkenachse anstelle von „ QBarCategoryAxis “ die Unterklasse „ QValueAxis “ verwendet, werden die Balken um den Indexwert der Kategorie gruppiert.
In der Galerie „Diagramme mit Widgets“ erfahren Sie, wie Sie mit der Klasse „ QBarSeries “ ein einfaches Balkendiagramm erstellen können.
Siehe auch „ QBarSet“ , „ QBarSeries “, „ QStackedBarSeries “, „ QPercentBarSeries “, „ QHorizontalBarSeries “, „ QHorizontalStackedBarSeries “ und „ QHorizontalPercentBarSeries “.
Dokumentation zu Mitgliedstypen
enum QAbstractBarSeries::LabelsPosition
Dieser Enum-Wert beschreibt die Position der Datenwertbeschriftungen:
| Konstante | Wert | Beschreibung |
|---|---|---|
QAbstractBarSeries::LabelsCenter | 0 | Die Beschriftung befindet sich in der Mitte des Balkens. |
QAbstractBarSeries::LabelsInsideEnd | 1 | Die Beschriftung befindet sich oben im Balken. |
QAbstractBarSeries::LabelsInsideBase | 2 | Die Beschriftung befindet sich unten im Balken. |
QAbstractBarSeries::LabelsOutsideEnd | 3 | Das Etikett befindet sich außen am Balken oben. |
Dokumentation der Eigenschaft
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.
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) |
Siehe auch „ QBarSeries “.
[read-only] count : int
Diese Eigenschaft gibt die Anzahl der Balkensätze in einer Balkenreihe an.
Zugriffsfunktionen:
| int | count() const |
Benachrichtigungssignal:
| 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.
QAbstractBarSeries Unterstützt das folgende Format-Tag:
| @value | Der 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 „%“ angehängt. 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.
labelsPosition : LabelsPosition
Diese Eigenschaft legt die Position der Wertbeschriftungen fest.
Zugriffsfunktionen:
| QAbstractBarSeries::LabelsPosition | labelsPosition() const |
| void | setLabelsPosition(QAbstractBarSeries::LabelsPosition position) |
Benachrichtigungssignal:
| void | labelsPositionChanged(QAbstractBarSeries::LabelsPosition position) |
Siehe auch labelsVisible und labelsFormat.
labelsPrecision : int
Diese Eigenschaft legt die maximale Anzahl der in Wertbeschriftungen angezeigten signifikanten Stellen fest.
Der Standardwert beträgt 6.
Zugriffsfunktionen:
| int | labelsPrecision() const |
| void | setLabelsPrecision(int precision) |
Benachrichtigungssignal:
| void | labelsPrecisionChanged(int precision) |
labelsVisible : bool
Diese Eigenschaft legt fest, ob die Beschriftungen in einer Balkenreihe sichtbar sind.
Zugriffsfunktionen:
| bool | isLabelsVisible() const |
| void | setLabelsVisible(bool visible = true) |
Benachrichtigungssignal:
| void | labelsVisibleChanged() |
Dokumentation der Member-Funktionen
[virtual noexcept] QAbstractBarSeries::~QAbstractBarSeries()
Entfernt die abstrakte Balkenreihe und die dazugehörigen Balkensätze.
bool QAbstractBarSeries::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.
bool QAbstractBarSeries::append(const QList<QBarSet *> &sets)
Fügt einer Balkenreihe eine Liste von Balkensätzen hinzu, die durch ` sets ` angegeben sind, und übernimmt die Eigentumsrechte an diesen Sätzen. Gibt „ true “ zurück, wenn alle Sätze erfolgreich angehängt wurden. Ist einer der Sätze null oder wurde er zuvor bereits an die Reihe angehängt, wird nichts angehängt und diese Funktion gibt „ false “ zurück. Taucht einer der Sätze mehr als einmal in der Liste auf, wird nichts angehängt und diese Funktion gibt „ false “ zurück.
QList<QBarSet *> QAbstractBarSeries::barSets() const
Gibt eine Liste der Balkensätze in einer Balkenreihe zurück. Behält die Eigentumsrechte an den Balkensätzen.
qreal QAbstractBarSeries::barWidth() const
Gibt die Breite der Balken der Reihe zurück.
Hinweis: Getter -Funktion für die Eigenschaft „barWidth“.
Siehe auch „ setBarWidth()“.
[signal] void QAbstractBarSeries::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 QAbstractBarSeries::barsetsRemoved(const QList<QBarSet *> &sets)
Dieses Signal wird ausgegeben, wenn die durch „ sets “ festgelegten Balken aus der Reihe entfernt werden.
Siehe auch „ remove()“.
void QAbstractBarSeries::clear()
Entfernt alle Balkensätze aus der Serie und löscht sie endgültig.
[signal] void QAbstractBarSeries::clicked(int index, QBarSet *barset)
Dieses Signal wird ausgelöst, wenn der Benutzer auf die Leiste klickt, die durch „ index “ in dem durch „ barset “ festgelegten Leisten-Set angegeben ist.
int QAbstractBarSeries::count() const
Gibt die Anzahl der Balkensätze in einer Balkenreihe zurück.
Hinweis: Getter -Funktion für die Eigenschaft „count“.
[signal] void QAbstractBarSeries::countChanged()
Dieses Signal wird ausgelöst, wenn die Anzahl der Balkensätze geändert wird, beispielsweise durch append() oder remove().
Hinweis: Notifier -Signal für die Eigenschaft count.
[signal] void QAbstractBarSeries::doubleClicked(int index, QBarSet *barset)
Dieses Signal wird ausgelöst, wenn der Benutzer auf die durch ` index ` angegebene Leiste in dem durch ` barset` angegebenen Leisten-Set doppelklickt.
[signal] void QAbstractBarSeries::hovered(bool status, int index, QBarSet *barset)
Dieses Signal wird ausgelöst, wenn der Mauszeiger über den Balken bewegt wird, der durch „ index “ in dem durch „ barset “ festgelegten Balkensatz angegeben ist. Wenn der Mauszeiger über den Balken bewegt wird, wechselt „ status “ zu „ true “, und wenn der Mauszeiger wieder wegbewegt wird, wechselt er zu „ false “.
bool QAbstractBarSeries::insert(int 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 dieser 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.
bool QAbstractBarSeries::isLabelsVisible() const
Gibt die Sichtbarkeit von Beschriftungen zurück.
Hinweis: Getter -Funktion für die Eigenschaft „ labelsVisible “.
[signal] void QAbstractBarSeries::labelsAngleChanged(qreal angle)
Dieses Signal wird ausgelöst, wenn sich die Eigenschaft „ angle “ der Wertbeschriftungen ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ labelsAngle “.
[signal] void QAbstractBarSeries::labelsFormatChanged(const QString &format)
Dieses Signal wird ausgelöst, wenn sich die Eigenschaft „ format “ der Datenwertbeschriftungen ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft „ labelsFormat “.
[signal] void QAbstractBarSeries::labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)
Dieses Signal wird ausgelöst, wenn sich die Eigenschaft „ position “ der Wertbeschriftungen ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ labelsPosition “.
[signal] void QAbstractBarSeries::labelsPrecisionChanged(int precision)
Dieses Signal wird ausgelöst, wenn sich die Eigenschaft „ precision “ der Wertbeschriftungen ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ labelsPrecision “.
[signal] void QAbstractBarSeries::labelsVisibleChanged()
Dieses Signal wird ausgelöst, wenn sich die Sichtbarkeit der Beschriftungen ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ labelsVisible “.
Siehe auch „ isLabelsVisible()“ und „ setLabelsVisible()“.
[signal] void QAbstractBarSeries::pressed(int index, QBarSet *barset)
Dieses Signal wird ausgelöst, wenn der Benutzer auf den durch „ index “ angegebenen Balken in dem durch „ barset “ angegebenen Balkensatz klickt und die Maustaste gedrückt hält.
[signal] void QAbstractBarSeries::released(int index, QBarSet *barset)
Dieses Signal wird ausgelöst, wenn der Benutzer den Mausklick auf dem durch ` index ` angegebenen Balken in dem durch ` barset` angegebenen Balkensatz loslässt.
bool QAbstractBarSeries::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.
void QAbstractBarSeries::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 QAbstractBarSeries::setLabelsVisible(bool visible = true)
Legt die Sichtbarkeit der Beschriftungen in einer Balkenreihe auf „ visible “ fest.
Hinweis: Setter -Funktion für die Eigenschaft „ labelsVisible “.
Siehe auch „ isLabelsVisible()“.
bool QAbstractBarSeries::take(QBarSet *set)
Ruft ein einzelnes „ set “ 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.
© 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.
