QBarSet Class

Die Klasse QBarSet repräsentiert einen Satz von Balken in einem Balkendiagramm. Mehr...

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

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 einen Datenwert für jede Kategorie. Es wird davon ausgegangen, dass der erste Wert einer Menge zur ersten Kategorie gehört, der zweite zur zweiten Kategorie und so weiter. Wenn die Menge weniger Werte enthält als Kategorien vorhanden sind, wird davon ausgegangen, dass die fehlenden Werte sich am Ende der Menge befinden. Für fehlende Werte in der Mitte einer Menge wird der numerische Wert Null verwendet. Beschriftungen für Null-Werte-Sets werden nicht angezeigt.

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

Dokumentation der Eigenschaften

borderColor : QColor

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

Zugriffsfunktionen:

QColor borderColor()
void setBorderColor(QColor color)

Melder-Signal:

void borderColorChanged(QColor color)

brush : QBrush

Diese Eigenschaft enthält den Pinsel, der zum Füllen der Balken im Balkensatz verwendet wird.

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 Bezeichnung des Balkensatzes.

Zugriffsfunktionen:

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

Melder-Signal:

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)

Benachrichtigungssignal:

labelColor : QColor

Diese Eigenschaft enthält die Textfarbe (Beschriftung) des Balkensatzes.

Zugriffsfunktionen:

QColor labelColor()
void setLabelColor(QColor color)

Melder-Signal:

void labelColorChanged(QColor color)

labelFont : QFont

Diese Eigenschaft enthält die Schriftart, die zum Zeichnen der Beschriftung des Balkensatzes verwendet wird.

Zugriffsfunktionen:

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

Melder-Signal:

pen : QPen

Diese Eigenschaft enthält den Stift, mit dem die Linien der Takte im Taktsatz gezeichnet werden.

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void penChanged()

Member Function Dokumentation

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

Konstruiert einen Balkensatz mit dem Label label und dem übergeordneten parent.

[virtual noexcept] QBarSet::~QBarSet()

Entfernt den Balkensatz.

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

Hängt die durch values angegebene Liste der reellen Werte an das Ende der Balkenmenge an.

Siehe auch append().

void QBarSet::append(const qreal value)

Hängt den durch value angegebenen neuen Wert an das Ende der Taktmenge an.

qreal QBarSet::at(const int index) const

Gibt den durch index angegebenen Wert aus dem Bar-Set zurück. Wenn der Index außerhalb der Grenzen liegt, wird 0,0 zurückgegeben.

QColor QBarSet::borderColor()

Liefert die Linienfarbe für den eingestellten Balken.

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

Siehe auch setBorderColor().

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

Dieses Signal wird ausgegeben, wenn die Linienfarbe (Stiftfarbe) des Balkensatzes auf color wechselt.

Hinweis: Benachrichtigungssignal für die Eigenschaft borderColor.

QBrush QBarSet::brush() const

Gibt den Pinsel zurück, der zum Füllen der Balken im Balkensatz verwendet wird.

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

Siehe auch setBrush().

[signal] void QBarSet::brushChanged()

Dieses Signal wird ausgegeben, wenn sich der zum Zeichnen des Balkensatzes verwendete Pinsel ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft brush.

Siehe auch brush.

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

Dieses Signal wird ausgegeben, wenn der Benutzer den durch index angegebenen Balken in einem Balkensatz anklickt.

QColor QBarSet::color()

Liefert die Füllfarbe für den Balkensatz.

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

Siehe auch setColor().

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

Dieses Signal wird ausgegeben, wenn die Füllfarbe (Pinsel) des Balkensatzes auf color wechselt.

Hinweis: Benachrichtigungssignal für die Eigenschaft color.

int QBarSet::count() const

Gibt die Anzahl der Werte in einem Balkensatz zurück.

[since 6.2] void QBarSet::deselectAllBars()

Deselektiert alle Takte der Serie.

Hinweis: Gibt QBarSet::selectedBarsChanged aus.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setBarSelected().

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

Deselektiert den Balken auf index.

Hinweis: Gibt 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 Liste indexes übergebene Takte als abgewählt.

Hinweis: Gibt QBarSet::selectedBarsChanged aus.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setBarSelected().

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

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

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

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

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

Fügt value an der durch index angegebenen Position ein. Die auf den eingefügten Wert folgenden Werte 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 am angegebenen index zu den ausgewählten Balken gehört, und andernfalls false.

Hinweis: Ausgewählte Balken werden mit der ausgewählten Farbe gezeichnet, wenn diese mit 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 Beschriftung des Balkensatzes zurück.

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

Siehe auch setLabel().

QBrush QBarSet::labelBrush() const

Gibt den Pinsel zurück, der zum Zeichnen von Werten über diesem Balkensatz verwendet wird.

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

Siehe auch setLabelBrush().

[signal] void QBarSet::labelBrushChanged()

Dieses Signal wird ausgegeben, wenn sich der Pinsel zum Zeichnen der Beschriftung des Balkensatzes ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft labelBrush.

Siehe auch labelBrush.

[signal] void QBarSet::labelChanged()

Dieses Signal wird ausgesendet, wenn sich die Beschriftung des Balkensatzes ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft label.

Siehe auch label.

QColor QBarSet::labelColor()

Liefert die Textfarbe für den eingestellten Balken.

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

Siehe auch setLabelColor().

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

Dieses Signal wird ausgegeben, wenn die Textfarbe (Label) des Balkensatzes auf color wechselt.

Hinweis: Benachrichtigungssignal für die Eigenschaft labelColor.

QFont QBarSet::labelFont() const

Gibt den Stift zurück, der zum Zeichnen von Werten über diesem Balkensatz verwendet wird.

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

Siehe auch setLabelFont().

[signal] void QBarSet::labelFontChanged()

Dieses Signal wird ausgegeben, wenn sich die Schriftart der Beschriftung des Balkensets ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft labelFont.

Siehe auch labelBrush.

QPen QBarSet::pen() const

Gibt den Stift zurück, der zum Zeichnen der Linien im Balkensatz verwendet wurde.

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

Siehe auch setPen().

[signal] void QBarSet::penChanged()

Dieses Signal wird ausgegeben, wenn sich der zum Zeichnen des Balkensatzes verwendete Stift ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft pen.

Siehe auch pen.

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

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

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

Entfernt die durch count angegebene Anzahl von Werten aus der Taktmenge, 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 Takt hinzu, der an der durch index angegebenen Position steht.

[since 6.2] void QBarSet::selectAllBars()

Markiert alle Takte der Serie als ausgewählt.

Hinweis: Gibt QBarSet::selectedBarsChanged aus.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setBarSelected().

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

Markiert den Balken auf index als ausgewählt.

Hinweis: Gibt 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 Liste indexes übergebene Takte als ausgewählt.

Hinweis: Gibt 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) der als ausgewählt markierten Balken. Wenn nicht angegeben, wird der Wert von QBarSet::color als Standard 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 auf index als ausgewählt oder abgewählt, wie durch selected angegeben.

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

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch isBarSelected() und setSelectedColor().

void QBarSet::setBorderColor(QColor color)

Setzt die Linienfarbe für den auf color gesetzten Balken.

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

Siehe auch borderColor().

void QBarSet::setBrush(const QBrush &brush)

Legt den Pinsel fest, der zum Füllen der Balken im Balkensatz brush verwendet wird.

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

Siehe auch brush().

void QBarSet::setColor(QColor color)

Setzt die Füllfarbe für den auf color gesetzten Balken.

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

Siehe auch color().

void QBarSet::setLabel(const QString label)

Setzt label als neue Beschriftung für den Balkensatz.

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

Siehe auch label().

void QBarSet::setLabelBrush(const QBrush &brush)

Legt den Pinsel fest, der zum Zeichnen von Werten über diesem Balken verwendet wird, der auf brush gesetzt ist.

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

Siehe auch labelBrush().

void QBarSet::setLabelColor(QColor color)

Setzt die Textfarbe für den auf color gesetzten Balken.

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

Siehe auch labelColor().

void QBarSet::setLabelFont(const QFont &font)

Legt die Schriftart fest, die verwendet wird, um die Werte oben auf diesem Balken zu zeichnen, der auf font eingestellt ist.

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 Balken verwendet wird, der auf pen eingestellt ist.

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

Siehe auch pen().

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

Setzt die color der ausgewählten Balken.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch selectedColor.

qreal QBarSet::sum() const

Gibt die Summe aller Werte in der Balkenmenge zurück.

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

Ändert den Auswahlzustand der Balken auf der angegebenen indexes in den entgegengesetzten Zustand.

Hinweis: Gibt QBarSet::selectedBarsChanged aus.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setBarSelected().

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

Dieses Signal wird ausgegeben, 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 ausgegeben, wenn dem Balkensatz neue Werte hinzugefügt werden. index gibt die Position des ersten eingefügten Wertes 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 ausgegeben, wenn Werte aus dem Balkensatz entfernt werden. index gibt die Position des ersten entfernten Wertes an, und count ist die Anzahl der entfernten Werte.

Siehe auch remove().

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

Ein bequemer Operator zum Anhängen des durch value angegebenen reellen Wertes an das Ende der Taktmenge.

Siehe auch append().

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

Gibt den Wert des durch index angegebenen Balkensatzes zurück. Wenn der Index außerhalb der Grenzen liegt, wird 0,0 zurückgegeben.

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