Back to Qt.io
Contact Us Blog Download Qt

QAbstractBarSeries Class

Die Klasse QAbstractBarSeries ist eine abstrakte Elternklasse für alle Balkenreihenklassen. Mehr...

Header: #include <QAbstractBarSeries>
In QML: AbstractBarSeries
Inherits: QAbstractSeries
Inherited By:

QBarSeries, QHorizontalBarSeries, QHorizontalPercentBarSeries, QHorizontalStackedBarSeries, QPercentBarSeries, and QStackedBarSeries

Ö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)

Detaillierte 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. Balkenserien, die mehrere Balkensätze enthalten, fassen Balken zusammen, die zur gleichen Kategorie gehören. Die Art und Weise, wie die Balken angezeigt werden, wird durch die Unterklasse dieser Klasse bestimmt, die zur Erstellung des Balkendiagramms gewählt wurde.

Wenn für die Hauptbalkenachse QValueAxis anstelle von QBarCategoryAxis verwendet wird, 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.

Member-Typ-Dokumentation

enum QAbstractBarSeries::LabelsPosition

Dieser Enum-Wert beschreibt die Position der Datenwertbeschriftungen:

KonstanteWertBeschreibung
QAbstractBarSeries::LabelsCenter0Das Etikett befindet sich in der Mitte des Balkens.
QAbstractBarSeries::LabelsInsideEnd1Die Beschriftung befindet sich oben innerhalb des Balkens.
QAbstractBarSeries::LabelsInsideBase2Die Beschriftung befindet sich innerhalb des Balkens am unteren Rand.
QAbstractBarSeries::LabelsOutsideEnd3Die Beschriftung befindet sich außerhalb des oberen Balkens.

Eigenschaft Dokumentation

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.

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)

Siehe auch QBarSeries.

[read-only] count : const int

Diese Eigenschaft gibt die Anzahl der Takte in einer Taktreihe an.

Zugriffsfunktionen:

int count() const

Benachrichtigungssignal:

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.

QAbstractBarSeries unterstützt das folgende Format-Tag:

@valueDer 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.

labelsPosition : LabelsPosition

Diese Eigenschaft enthält die Position der Wertelabels.

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

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void labelsVisibleChanged()

Member Function Dokumentation

[virtual noexcept] QAbstractBarSeries::~QAbstractBarSeries()

Entfernt die abstrakte Taktserie und die ihr zugehörigen Taktsätze.

bool QAbstractBarSeries::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.

bool QAbstractBarSeries::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.

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

Liefert eine Liste von Taktsätzen in einer Taktreihe. Behält die Eigentümerschaft der Taktsätze bei.

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 durch sets angegebenen Taktsätze zur Serie hinzugefügt werden.

Siehe auch append() und insert().

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

Dieses Signal wird ausgegeben, wenn die durch sets angegebenen Taktsätze aus der Reihe entfernt werden.

Siehe auch remove().

void QAbstractBarSeries::clear()

Entfernt alle Taktsätze aus der Serie und löscht sie dauerhaft.

[signal] void QAbstractBarSeries::clicked(int index, QBarSet *barset)

Dieses Signal wird ausgegeben, wenn der Benutzer auf den durch index angegebenen Balken in der durch barset angegebenen Balkenmenge klickt.

int QAbstractBarSeries::count() const

Gibt die Anzahl der Taktsätze in einer Taktreihe zurück.

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

[signal] void QAbstractBarSeries::countChanged()

Dieses Signal wird ausgegeben, wenn die Anzahl der Taktsätze geändert wird, zum Beispiel durch append() oder remove().

Hinweis: Meldersignal für die Eigenschaft count.

[signal] void QAbstractBarSeries::doubleClicked(int index, QBarSet *barset)

Dieses Signal wird ausgegeben, wenn der Benutzer einen Doppelklick auf den durch index angegebenen Balken in der durch barset angegebenen Balkenmenge ausführt.

[signal] void QAbstractBarSeries::hovered(bool status, int index, QBarSet *barset)

Dieses Signal wird ausgegeben, wenn der Mauszeiger über den durch index angegebenen Balken in dem durch barset angegebenen Balkensatz bewegt wird. Wenn sich die Maus über den Balken bewegt, wird status zu true, und wenn sich die Maus wieder entfernt, wird sie zu false.

bool QAbstractBarSeries::insert(int 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.

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 ausgesendet, wenn sich die angle der Wertelabels ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft labelsAngle.

[signal] void QAbstractBarSeries::labelsFormatChanged(const QString &format)

Dieses Signal wird ausgesendet, wenn sich die format von Datenwertkennzeichnungen ändert.

Hinweis: Meldersignal für die Eigenschaft labelsFormat.

[signal] void QAbstractBarSeries::labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)

Dieses Signal wird ausgegeben, wenn sich die position von Wertelabels ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft labelsPosition.

[signal] void QAbstractBarSeries::labelsPrecisionChanged(int precision)

Dieses Signal wird ausgesendet, wenn sich die precision der Wertelabels ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft labelsPrecision.

[signal] void QAbstractBarSeries::labelsVisibleChanged()

Dieses Signal wird ausgegeben, wenn sich die Sichtbarkeit der Etiketten ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft labelsVisible.

Siehe auch isLabelsVisible() und setLabelsVisible().

[signal] void QAbstractBarSeries::pressed(int index, QBarSet *barset)

Dieses Signal wird ausgegeben, 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 ausgegeben, wenn der Benutzer die Maustaste auf dem durch index angegebenen Balken in dem durch barset angegebenen Balkensatz loslässt.

bool QAbstractBarSeries::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.

void QAbstractBarSeries::setBarWidth(qreal width)

Setzt die Breite der Balken der Reihe auf width.

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

Siehe auch barWidth().

void QAbstractBarSeries::setLabelsVisible(bool visible = true)

Setzt die Sichtbarkeit von Beschriftungen in einer Balkenreihe auf visible.

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

Siehe auch isLabelsVisible().

bool QAbstractBarSeries::take(QBarSet *set)

Entnimmt einen einzelnen set aus der Serie. Löscht nicht das Objekt der Balkengruppe.

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.

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