Auf dieser Seite

QBarSet Class

Die Klasse „QBarSet“ repräsentiert eine Gruppe von Balken in einem Balkendiagramm. Mehr...

Header: #include <QBarSet>
In QML: BarSet
Inherits: QObject
Status: Deprecated

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Eigenschaften

Öffentliche Funktionen

QBarSet(const QString label, QObject *parent = nullptr)
virtual ~QBarSet()
void append(const QList<qreal> &values)
void append(const qreal value)
qreal at(const int index) const
QColor borderColor()
QBrush brush() const
QColor color()
int count() const
(since 6.2) void deselectAllBars()
(since 6.2) void deselectBar(int index)
(since 6.2) void deselectBars(const QList<int> &indexes)
void insert(const int index, const qreal value)
(since 6.2) bool isBarSelected(int index) const
QString label() const
QBrush labelBrush() const
QColor labelColor()
QFont labelFont() const
QPen pen() const
void remove(const int index, const int count = 1)
void replace(const int index, const qreal value)
(since 6.2) void selectAllBars()
(since 6.2) void selectBar(int index)
(since 6.2) void selectBars(const QList<int> &indexes)
(since 6.2) QList<int> selectedBars() const
(since 6.2) QColor selectedColor() const
(since 6.2) void setBarSelected(int index, bool selected)
void setBorderColor(QColor color)
void setBrush(const QBrush &brush)
void setColor(QColor color)
void setLabel(const QString label)
void setLabelBrush(const QBrush &brush)
void setLabelColor(QColor color)
void setLabelFont(const QFont &font)
void setPen(const QPen &pen)
(since 6.2) void setSelectedColor(const QColor &color)
qreal sum() const
(since 6.2) void toggleSelection(const QList<int> &indexes)
QBarSet &operator<<(const qreal &value)
qreal operator[](const int index) const

Signale

void borderColorChanged(QColor color)
void brushChanged()
void clicked(int index)
void colorChanged(QColor color)
void doubleClicked(int index)
void hovered(bool status, int index)
void labelBrushChanged()
void labelChanged()
void labelColorChanged(QColor color)
void labelFontChanged()
void penChanged()
void pressed(int index)
void released(int index)
void valueChanged(int index)
void valuesAdded(int index, int count)
void valuesRemoved(int index, int count)

Detaillierte Beschreibung

Ein Balkensatz enthält für jede Kategorie einen Datenwert. Es wird angenommen, dass der erste Wert eines Satzes zur ersten Kategorie gehört, der zweite zur zweiten Kategorie und so weiter. Wenn der Satz weniger Werte enthält, als es Kategorien gibt, wird davon ausgegangen, dass sich die fehlenden Werte am Ende des Satzes befinden. Bei fehlenden Werten in der Mitte einer Gruppe wird der numerische Wert Null verwendet. Beschriftungen für Gruppen mit dem Wert Null werden nicht angezeigt.

Siehe auch QAbstractBarSeries, QBarSeries, QStackedBarSeries, QPercentBarSeries, QHorizontalBarSeries, QHorizontalStackedBarSeries und QHorizontalPercentBarSeries.

Dokumentation zu Eigenschaften

borderColor : QColor

Diese Eigenschaft enthält die Linienfarbe (Stiftfarbe) des Balkensatzes.

Zugriffsfunktionen:

QColor borderColor()
void setBorderColor(QColor color)

Benachrichtigungssignal:

void borderColorChanged(QColor color)

brush : QBrush

Diese Eigenschaft enthält den Pinsel, mit dem die Balken im Balkensatz ausgefüllt werden.

Zugriffsfunktionen:

QBrush brush() const
void setBrush(const QBrush &brush)

Benachrichtigungssignal:

void brushChanged()

color : QColor

Diese Eigenschaft enthält die Füllfarbe (Pinsel) des Balkensatzes.

Zugriffsfunktionen:

QColor color()
void setColor(QColor color)

Benachrichtigungssignal:

void colorChanged(QColor color)

label : QString

Diese Eigenschaft enthält die Beschriftung des Balkensatzes.

Zugriffsfunktionen:

QString label() const
void setLabel(const QString label)

Benachrichtigungssignal:

void labelChanged()

labelBrush : QBrush

Diese Eigenschaft enthält den Pinsel, mit dem die Beschriftung des Balkensatzes gezeichnet wird.

Zugriffsfunktionen:

QBrush labelBrush() const
void setLabelBrush(const QBrush &brush)

Notifier-Signal:

labelColor : QColor

Diese Eigenschaft legt die Textfarbe (Beschriftung) des Balkensatzes fest.

Zugriffsfunktionen:

QColor labelColor()
void setLabelColor(QColor color)

Benachrichtigungssignal:

void labelColorChanged(QColor color)

labelFont : QFont

Diese Eigenschaft gibt die Schriftart an, die zum Zeichnen der Beschriftung des Balkensatzes verwendet wird.

Zugriffsfunktionen:

QFont labelFont() const
void setLabelFont(const QFont &font)

Benachrichtigungssignal:

pen : QPen

Diese Eigenschaft enthält den Stift, mit dem die Linien der Balken im Balkensatz gezeichnet wurden.

Zugriffsfunktionen:

QPen pen() const
void setPen(const QPen &pen)

Benachrichtigungssignal:

void penChanged()

Dokumentation der Member-Funktionen

[explicit] QBarSet::QBarSet(const QString label, QObject *parent = nullptr)

Erstellt eine Balkengruppe mit der Bezeichnung „ label “ und dem übergeordneten Element „ parent “.

[virtual noexcept] QBarSet::~QBarSet()

Entfernt das Balkenset.

void QBarSet::append(const QList<qreal> &values)

Fügt die durch ` values ` angegebene Liste von reellen Werten am Ende des Balkensatzes an.

Siehe auch append ().

void QBarSet::append(const qreal value)

Fügt den neuen Wert, der durch „ value “ angegeben wird, am Ende der Taktserie an.

qreal QBarSet::at(const int index) const

Gibt den durch ` index ` angegebenen Wert aus dem Balkensatz zurück. Liegt der Index außerhalb des zulässigen Bereichs, wird 0,0 zurückgegeben.

QColor QBarSet::borderColor()

Gibt die Linienfarbe für den Balkensatz zurück.

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

Siehe auch „ setBorderColor()“.

[signal] void QBarSet::borderColorChanged(QColor color)

Dieses Signal wird ausgelöst, wenn sich die Linienfarbe (Stiftfarbe) des Balkensatzes auf „ color “ ändert.

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

QBrush QBarSet::brush() const

Gibt den Pinsel zurück, der zum Ausfüllen der Balken im Balkensatz verwendet wurde.

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

Siehe auch „ setBrush()“.

[signal] void QBarSet::brushChanged()

Dieses Signal wird ausgelöst, wenn sich der Pinsel ändert, der zum Zeichnen der Balkengruppe verwendet wird.

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

Siehe auch „ brush “.

[signal] void QBarSet::clicked(int index)

Dieses Signal wird ausgelöst, wenn der Benutzer in einem Balkensatz auf den Balken klickt, der durch „ index “ angegeben ist.

QColor QBarSet::color()

Gibt die Füllfarbe für den Balkensatz zurück.

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

Siehe auch „ setColor()“.

[signal] void QBarSet::colorChanged(QColor color)

Dieses Signal wird ausgelöst, wenn sich die Füllfarbe (Pinsel) der Balkengruppe auf „ color “ ändert.

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

int QBarSet::count() const

Gibt die Anzahl der Werte in einer Balkenreihe zurück.

[since 6.2] void QBarSet::deselectAllBars()

Hebt die Auswahl aller Balken in der Reihe auf.

Hinweis: Sendet „ QBarSet::selectedBarsChanged “aus .

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch ` setBarSelected()`.

[since 6.2] void QBarSet::deselectBar(int index)

Hebt die Auswahl des Balkens unter index auf.

Hinweis: Löst „ QBarSet::selectedBarsChanged “aus .

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setBarSelected().

[since 6.2] void QBarSet::deselectBars(const QList<int> &indexes)

Markiert mehrere in einer „ indexes “-Liste übergebene Balken als abgewählt.

Hinweis: Löst „ QBarSet::selectedBarsChanged “aus .

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch ` setBarSelected()`.

[signal] void QBarSet::doubleClicked(int index)

Dieses Signal wird ausgelöst, wenn der Benutzer in einem Balkensatz auf den durch „ index “ angegebenen Balken doppelklickt.

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

Dieses Signal wird ausgelöst, wenn der Mauszeiger über den Balken bewegt wird, der in einem Balkensatz durch „ index “ festgelegt ist. Wenn der Mauszeiger über den Balken bewegt wird, wechselt „ status “ zu „ true “, und wenn der Mauszeiger wieder wegbewegt wird, wechselt er zu „ false “.

void QBarSet::insert(const int index, const qreal value)

Fügt „ value “ an der durch „ index “ angegebenen Position ein. Die Werte, die auf den eingefügten Wert folgen, werden um eine Position nach oben verschoben.

Siehe auch remove().

[since 6.2] bool QBarSet::isBarSelected(int index) const

Gibt „ true “ zurück, wenn der Balken unter der angegebenen Adresse „ index “ zu den ausgewählten Balken gehört, andernfalls „ false “.

Hinweis: Ausgewählte Balken werden in der ausgewählten Farbe gezeichnet, sofern diese über ` QBarSet::setSelectedColor` angegeben wurde.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch selectedBars(), setBarSelected() und setSelectedColor().

QString QBarSet::label() const

Gibt die Bezeichnung des Balkensatzes zurück.

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

Siehe auch ` setLabel()`.

QBrush QBarSet::labelBrush() const

Gibt den Pinsel zurück, mit dem Werte auf dieses Balkenset gezeichnet wurden.

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

Siehe auch „ setLabelBrush()“.

[signal] void QBarSet::labelBrushChanged()

Dieses Signal wird ausgelöst, wenn sich der Pinsel ändert, der zum Zeichnen der Beschriftung des Balkensatzes verwendet wird.

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

Siehe auch „ labelBrush “.

[signal] void QBarSet::labelChanged()

Dieses Signal wird ausgelöst, wenn sich die Beschriftung des Balkensatzes ändert.

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

Siehe auch „ label “.

QColor QBarSet::labelColor()

Gibt die Textfarbe für den Balkensatz zurück.

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

Siehe auch „ setLabelColor()“.

[signal] void QBarSet::labelColorChanged(QColor color)

Dieses Signal wird ausgelöst, wenn sich die Textfarbe (Beschriftung) des Balkensatzes auf „ color “ ändert.

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

QFont QBarSet::labelFont() const

Gibt den Stift zurück, mit dem Werte auf diesem Balkensatz eingezeichnet wurden.

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

Siehe auch „ setLabelFont()“.

[signal] void QBarSet::labelFontChanged()

Dieses Signal wird ausgelöst, wenn sich die Schriftart der Beschriftung des Balkensatzes ändert.

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

Siehe auch ` labelBrush`.

QPen QBarSet::pen() const

Gibt den Stift zurück, mit dem die Linien im Balkensatz gezeichnet wurden.

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

Siehe auch „ setPen()“.

[signal] void QBarSet::penChanged()

Dieses Signal wird ausgegeben, wenn der Stift, mit dem die Balkengruppe gezeichnet wird, wechselt.

Hinweis: Benachrichtigungssignal für die Eigenschaft „ pen “.

Siehe auch „ pen “.

[signal] void QBarSet::pressed(int index)

Dieses Signal wird ausgelöst, wenn der Benutzer auf den durch „ index “ angegebenen Balken in einem Balkensatz klickt und die Maustaste gedrückt hält.

[signal] void QBarSet::released(int index)

Dieses Signal wird ausgelöst, wenn der Benutzer den Mausklick auf dem Balken aufhebt, der durch „ index “ in einem Balkensatz angegeben ist.

void QBarSet::remove(const int index, const int count = 1)

Entfernt die Anzahl der Werte, die durch count angegeben ist, aus der Balkengruppe, beginnend mit dem durch index angegebenen Wert.

Siehe auch insert().

void QBarSet::replace(const int index, const qreal value)

Fügt den durch value angegebenen Wert zu dem Balken hinzu, der an der durch index angegebenen Position gesetzt ist.

[since 6.2] void QBarSet::selectAllBars()

Markiert alle Balken der Reihe als ausgewählt.

Hinweis: Löst „ QBarSet::selectedBarsChanged “aus .

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch „ setBarSelected()“.

[since 6.2] void QBarSet::selectBar(int index)

Markiert die Leiste unter index als ausgewählt.

Hinweis: Löst „ QBarSet::selectedBarsChanged “aus .

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setBarSelected().

[since 6.2] void QBarSet::selectBars(const QList<int> &indexes)

Markiert mehrere in einer „ indexes “-Liste übergebene Balken als ausgewählt.

Hinweis: Löst „ QBarSet::selectedBarsChanged “aus .

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch ` setBarSelected()`.

[since 6.2] QList<int> QBarSet::selectedBars() const

Gibt eine Liste der als ausgewählt markierten Balken zurück.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch „ setBarSelected()“.

[since 6.2] QColor QBarSet::selectedColor() const

Gibt die Farbe der ausgewählten Balken zurück.

Dies ist die Füllfarbe (Pinsel Farbe) der als ausgewählt markierten Balken. Wenn kein Wert angegeben wird, wird standardmäßig der Wert von ` QBarSet::color ` verwendet.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch „ setSelectedColor()“ und „ color “.

[since 6.2] void QBarSet::setBarSelected(int index, bool selected)

Markiert den Balken unter „ index “ entsprechend der Angabe unter „ selected “ als ausgewählt oder nicht ausgewählt.

Hinweis: Ausgewählte Balken werden mit der ausgewählten Farbe gezeichnet, sofern diese angegeben wurde. Sendet „ QBarSet::selectedBarsChanged “.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch „ isBarSelected()“ und „ setSelectedColor()“.

void QBarSet::setBorderColor(QColor color)

Legt die Linienfarbe für den Balkensatz auf „ color “ fest.

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

Siehe auch „ borderColor()“.

void QBarSet::setBrush(const QBrush &brush)

Legt den Pinsel fest, der zum Ausfüllen der Balken im Balkensatz verwendet wird, auf „ brush “.

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

Siehe auch „ brush()“.

void QBarSet::setColor(QColor color)

Legt die Füllfarbe für die Balkengruppe „ color “ fest.

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

Siehe auch „ color()“.

void QBarSet::setLabel(const QString label)

Legt „ label “ als neue Bezeichnung für den Balkensatz fest.

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

Siehe auch label().

void QBarSet::setLabelBrush(const QBrush &brush)

Legt den Pinsel fest, mit dem Werte auf diesem Balkensatz gezeichnet werden, auf „ brush “.

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

Siehe auch „ labelBrush()“.

void QBarSet::setLabelColor(QColor color)

Legt die Textfarbe für die auf „ color “ eingestellte Leiste fest.

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

Siehe auch ` labelColor()`.

void QBarSet::setLabelFont(const QFont &font)

Legt die Schriftart fest, mit der Werte auf diesem Balkensatz dargestellt werden: font.

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

Siehe auch labelFont().

void QBarSet::setPen(const QPen &pen)

Legt den Stift fest, der zum Zeichnen der Linien im Balkensatz verwendet wird, auf „ pen “.

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

Siehe auch „ pen()“.

[since 6.2] void QBarSet::setSelectedColor(const QColor &color)

Legt die „ color “ der ausgewählten Takte fest.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch „ selectedColor “.

qreal QBarSet::sum() const

Gibt die Summe aller Werte im Balkensatz zurück.

[since 6.2] void QBarSet::toggleSelection(const QList<int> &indexes)

Ändert den Auswahlstatus der Balken an der angegebenen Adresse indexes in den entgegengesetzten.

Hinweis: Löst „ QBarSet::selectedBarsChanged “aus .

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch ` setBarSelected()`.

[signal] void QBarSet::valueChanged(int index)

Dieses Signal wird ausgelöst, wenn der Wert an der durch „ index “ angegebenen Position geändert wird.

Siehe auch at().

[signal] void QBarSet::valuesAdded(int index, int count)

Dieses Signal wird ausgelöst, wenn dem Balkensatz neue Werte hinzugefügt werden. „ index “ gibt die Position des ersten eingefügten Werts an, und „ count “ ist die Anzahl der eingefügten Werte.

Siehe auch append() und insert().

[signal] void QBarSet::valuesRemoved(int index, int count)

Dieses Signal wird ausgelöst, wenn Werte aus der Balkengruppe entfernt werden. „ index “ gibt die Position des ersten entfernten Werts an, und „ count “ ist die Anzahl der entfernten Werte.

Siehe auch remove().

QBarSet &QBarSet::operator<<(const qreal &value)

Ein Komfortoperator, mit dem der durch „ value “ angegebene reelle Wert an das Ende der Balkenreihe angehängt wird.

Siehe auch append().

qreal QBarSet::operator[](const int index) const

Gibt den Wert des durch ` index` angegebenen Balkensatzes zurück. Liegt der Index außerhalb des zulässigen Bereichs, wird 0,0 zurückgegeben.

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