QBarSet Class
Die Klasse „QBarSet“ repräsentiert eine Gruppe von Balken in einem Balkendiagramm. Mehr...
| Header: | #include <QBarSet> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | BarSet |
| Erbt von: | QObject |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QBarSet ist Teil der C++-Klassen für 2D unterQt Graphs .
Eigenschaften
|
|
Öffentliche Funktionen
| QBarSet(const QString &label, QObject *parent = nullptr) | |
| virtual | ~QBarSet() override |
| void | append(const QList<qreal> &values) |
| void | append(qreal value) |
| qreal | at(qsizetype index) const |
| QColor | borderColor() const |
| qreal | borderWidth() const |
| void | clear() |
| QColor | color() const |
| qsizetype | count() const |
| void | deselectAllBars() |
| void | deselectBar(qsizetype index) |
| void | deselectBars(const QList<qsizetype> &indexes) |
| void | insert(qsizetype index, qreal value) |
| bool | isBarSelected(qsizetype index) const |
| QString | label() const |
| QColor | labelColor() const |
| void | remove(qsizetype index, qsizetype count = 1) |
| void | replace(qsizetype index, qreal value) |
| void | selectAllBars() |
| void | selectBar(qsizetype index) |
| void | selectBars(const QList<qsizetype> &indexes) |
| QList<qsizetype> | selectedBars() const |
| QColor | selectedColor() const |
| void | setBarSelected(qsizetype index, bool selected) |
| void | setBorderColor(QColor color) |
| void | setBorderWidth(qreal borderWidth) |
| void | setColor(QColor color) |
| void | setLabel(const QString &label) |
| void | setLabelColor(QColor color) |
| void | setSelectedColor(QColor color) |
| void | setValues(const QVariantList &values) |
| qreal | sum() const |
| void | toggleSelection(const QList<qsizetype> &indexes) |
| QVariantList | values() const |
| QBarSet & | operator<<(qreal value) |
| qreal | operator[](qsizetype index) const |
Signale
| void | borderColorChanged(QColor color) |
| void | borderWidthChanged(qreal width) |
| void | colorChanged(QColor color) |
| void | countChanged() |
| void | labelChanged() |
| void | labelColorChanged(QColor color) |
| void | selectedBarsChanged(const QList<qsizetype> &indexes) |
| void | selectedColorChanged(QColor color) |
| void | update() |
| void | updatedBars() |
| void | valueAdded(qsizetype index, qsizetype count) |
| void | valueChanged(qsizetype index) |
| void | valueRemoved(qsizetype index, qsizetype count) |
| void | valuesAdded(qsizetype index, qsizetype count) |
| void | valuesChanged() |
| void | valuesRemoved(qsizetype index, qsizetype count) |
Detaillierte Beschreibung
Ein Balkensatz enthält für jede Kategorie einen Datenwert. Es wird davon ausgegangen, 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 angenommen, 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 „ QBarSeries “.
Dokumentation zu Eigenschaften
borderColor : QColor
Diese Eigenschaft legt die Rahmenfarbe des Balkensatzes fest.
Zugriffsfunktionen:
| QColor | borderColor() const |
| void | setBorderColor(QColor color) |
Benachrichtigungssignal:
| void | borderColorChanged(QColor color) |
borderWidth : qreal
Diese Eigenschaft gibt die Breite der Rahmenlinie an. Standardmäßig ist die Breite auf -1 gesetzt, was bedeutet, dass die Rahmenbreite durch das Design vorgegeben wird.
Zugriffsfunktionen:
| qreal | borderWidth() const |
| void | setBorderWidth(qreal borderWidth) |
Notifier-Signal:
| void | borderWidthChanged(qreal width) |
color : QColor
Diese Eigenschaft enthält die Füllfarbe des Balkensatzes.
Zugriffsfunktionen:
Benachrichtigungssignal:
| void | colorChanged(QColor color) |
[read-only] count : qsizetype
Diese Eigenschaft gibt die Anzahl der Werte im Balkensatz an.
Zugriffsfunktionen:
| qsizetype | count() const | [see note below] |
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Notifier-Signal:
| void | countChanged() |
label : QString
Diese Eigenschaft enthält die Beschriftung des Balkensatzes.
Zugriffsfunktionen:
Benachrichtigungssignal:
| void | labelChanged() |
labelColor : QColor
Diese Eigenschaft legt die Textfarbe (Beschriftung) des Balkensatzes fest.
Zugriffsfunktionen:
| QColor | labelColor() const |
| void | setLabelColor(QColor color) |
Benachrichtigungssignal:
| void | labelColorChanged(QColor color) |
[read-only] selectedBars : QList<qsizetype>
Diese Eigenschaft enthält die Indizes der derzeit ausgewählten Balken.
Zugriffsfunktionen:
| QList<qsizetype> | selectedBars() const |
Benachrichtigungssignal:
| void | selectedBarsChanged(const QList<qsizetype> &indexes) |
selectedColor : QColor
Diese Eigenschaft enthält die Füllfarbe der ausgewählten Gruppe.
Zugriffsfunktionen:
| QColor | selectedColor() const |
| void | setSelectedColor(QColor color) |
Benachrichtigungssignal:
| void | selectedColorChanged(QColor color) |
values : QVariantList
Diese Eigenschaft enthält die Werte des Balkensatzes.
Als Werte können Sie eine Liste von Typen der Art „ real “ oder „ point “ festlegen.
Wenn Sie eine Liste von reellen Werten als Werte festlegen, definieren diese direkt die Werte des Balkensatzes.
Wenn Sie eine Liste von Punkttypen als Werte festlegen, gibt die x-Koordinate des Punktes dessen nullbasierten Index im Balkensatz an. Die Größe des Balkensatzes entspricht dem höchsten x-Koordinatenwert + 1. Fehlt ein Punkt für eine x-Koordinate zwischen Null und dem höchsten Wert, erhält er den Wert Null.
Zugriffsfunktionen:
| QVariantList | values() const |
| void | setValues(const QVariantList &values) |
Benachrichtigungssignal:
| void | valuesChanged() |
Dokumentation der Mitgliedsfunktionen
[explicit] QBarSet::QBarSet(const QString &label, QObject *parent = nullptr)
Erstellt eine Balkengruppe mit der Bezeichnung „ label “ und dem übergeordneten Element „ parent “.
[override virtual noexcept] QBarSet::~QBarSet()
Entfernt das Balkenset.
[invokable] void QBarSet::append(const QList<qreal> &values)
Fügt die Liste der durch values angegebenen reellen Werte am Ende der Balkenreihe an.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch append ().
[invokable] void QBarSet::append(qreal value)
Fügt den neuen Wert, der durch „ value “ angegeben wird, am Ende des Balkensatzes an.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] qreal QBarSet::at(qsizetype 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.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
QColor QBarSet::borderColor() const
Gibt die Linienfarbe für den Balkensatz zurück.
Hinweis: Getter -Funktion für die Eigenschaft „borderColor“.
Siehe auch „ setBorderColor()“.
[invokable] void QBarSet::clear()
Entfernt alle Werte aus der Menge.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
QColor QBarSet::color() const
Gibt die Füllfarbe für den Balkensatz zurück.
Hinweis: Getter -Funktion für die Eigenschaft „color“.
Siehe auch ` setColor()`.
[invokable] qsizetype QBarSet::count() const
Gibt die Anzahl der Werte in einem Balkensatz zurück.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Hinweis: Getter -Funktion für die Eigenschaft „count“.
[invokable] void QBarSet::deselectAllBars()
Hebt die Auswahl aller Balken im Set auf.
Hinweis: Löst „ QBarSet::selectedBarsChanged “aus .
Hinweis: Diese Funktion kann über das Metaobjekt-System und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch setBarSelected().
[invokable] void QBarSet::deselectBar(qsizetype index)
Hebt die Auswahl des Balkens unter index auf.
Hinweis: Löst „ QBarSet::selectedBarsChanged “aus .
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch setBarSelected().
[invokable] void QBarSet::deselectBars(const QList<qsizetype> &indexes)
Markiert mehrere in einer „ indexes “-Liste übergebene Balken als abgewählt.
Hinweis: Löst „ QBarSet::selectedBarsChanged “aus .
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe „ Q_INVOKABLE “.
Siehe auch „ setBarSelected()“.
[invokable] void QBarSet::insert(qsizetype index, 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.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch ` remove()`.
[invokable] bool QBarSet::isBarSelected(qsizetype index) const
Gibt „ true “ zurück, wenn sich der Balken an der angegebenen Position index unter den ausgewählten Balken befindet, andernfalls „ false “.
Hinweis: Ausgewählte Balken werden in der ausgewählten Farbe gezeichnet, sofern diese über ` QBarSet::setSelectedColor` festgelegt wurde.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
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()“.
QColor QBarSet::labelColor() const
Gibt die Textfarbe für den Balkensatz zurück.
Hinweis: Getter -Funktion für die Eigenschaft „labelColor“.
Siehe auch „ setLabelColor()“.
[invokable] void QBarSet::remove(qsizetype index, qsizetype count = 1)
Entfernt die durch „ count “ angegebene Anzahl von Werten aus der Balkengruppe, beginnend mit dem durch „ index “ angegebenen Wert.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch insert().
[invokable] void QBarSet::replace(qsizetype index, qreal value)
Fügt den durch value angegebenen Wert zu dem Balken hinzu, der an der durch index angegebenen Position festgelegt ist.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QBarSet::selectAllBars()
Markiert alle Balken in der Gruppe als ausgewählt.
Hinweis: Löst „ QBarSet::selectedBarsChanged “aus .
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch „ setBarSelected()“.
[invokable] void QBarSet::selectBar(qsizetype index)
Markiert die Leiste unter index als ausgewählt.
Hinweis: Gibt „ QBarSet::selectedBarsChanged “aus .
Hinweis: Diese Funktion kann über das Metaobjekt-System und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch setBarSelected().
[invokable] void QBarSet::selectBars(const QList<qsizetype> &indexes)
Markiert mehrere in einer „ indexes “-Liste übergebene Balken als ausgewählt.
Hinweis: Löst „ QBarSet::selectedBarsChanged “aus .
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe „ Q_INVOKABLE “.
Siehe auch ` setBarSelected()`.
QList<qsizetype> QBarSet::selectedBars() const
Gibt eine Liste der als ausgewählt markierten Balken zurück.
Hinweis: Getter -Funktion für die Eigenschaft „selectedBars“.
Siehe auch „ setBarSelected()“.
[signal] void QBarSet::selectedBarsChanged(const QList<qsizetype> &indexes)
Dieses Signal wird ausgelöst, wenn sich der ausgewählte Balken ändert. „ indexes “ ist eine Liste der Indizes der ausgewählten Balken.
Hinweis: Notifier -Signal für die Eigenschaft „ selectedBars “.
QColor QBarSet::selectedColor() const
Gibt die Farbe der ausgewählten Balken zurück.
Dies ist die Füllfarbe (Pinselfarbe) der als ausgewählt markierten Balken. Wenn kein Wert angegeben wird, wird standardmäßig der Wert von „ QBarSet::color “ verwendet.
Hinweis: Getter -Funktion für die Eigenschaft „selectedColor“.
Siehe auch „ setSelectedColor()“ und „ color “.
[invokable] void QBarSet::setBarSelected(qsizetype 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.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch „ isBarSelected()“ und „ setSelectedColor()“.
void QBarSet::setBorderColor(QColor color)
Legt die Linienfarbe für die auf „ color “ eingestellte Balkengruppe fest.
Hinweis: Setter -Funktion für die Eigenschaft „ borderColor “.
Siehe auch „ borderColor()“.
void QBarSet::setColor(QColor color)
Legt die Füllfarbe für den Balkensatz auf „ 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::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::setSelectedColor(QColor color)
Legt die Eigenschaft „ color “ der ausgewählten Takte fest.
Hinweis: Setter -Funktion für die Eigenschaft „ selectedColor “.
Siehe auch „ selectedColor “.
[invokable] qreal QBarSet::sum() const
Gibt die Summe aller Werte im Balkensatz zurück.
Hinweis: Diese Funktion kann über das Metaobjekt-System und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QBarSet::toggleSelection(const QList<qsizetype> &indexes)
Ändert den Auswahlstatus der Balken an der angegebenen Adresse indexes in den entgegengesetzten.
Hinweis: Löst „ QBarSet::selectedBarsChanged “aus .
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe „ Q_INVOKABLE “.
Siehe auch ` setBarSelected()`.
[signal] void QBarSet::update()
Dieses Signal wird ausgesendet, wenn der Barset aktualisiert wird.
[signal] void QBarSet::updatedBars()
Dieses Signal wird ausgegeben, wenn die Balken in diesem Satz aktualisiert werden.
[signal] void QBarSet::valueAdded(qsizetype index, qsizetype 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.
[signal] void QBarSet::valueChanged(qsizetype index)
Dieses Signal wird ausgelöst, wenn der Wert an der durch „ index “ angegebenen Position geändert wird.
Siehe auch at().
[signal] void QBarSet::valueRemoved(qsizetype index, qsizetype 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.
[signal] void QBarSet::valuesAdded(qsizetype index, qsizetype 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(qsizetype index, qsizetype 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<<(qreal value)
Ein Hilfsoperator, um den durch „ value “ angegebenen reellen Wert an das Ende der Balkenreihe anzuhängen.
Siehe auch append().
qreal QBarSet::operator[](qsizetype 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.
