QBarSet Class
Die Klasse QBarSet repräsentiert einen Satz von Balken in einem Balkendiagramm. Mehr...
| Kopfzeile: | #include <QBarSet> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | BarSet |
| Vererbt: | QObject |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QBarSet ist Teil von Qt Graphs C++ Classes for 2D.
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 einen Datenwert für jede Kategorie. Es wird davon ausgegangen, dass der erste Wert eines Satzes zur ersten Kategorie gehört, der zweite Wert zur zweiten Kategorie usw. 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 QBarSeries.
Dokumentation der Eigenschaft
borderColor : QColor
Diese Eigenschaft enthält die Farbe des Rahmens des Balkensatzes.
Zugriffsfunktionen:
| QColor | borderColor() const |
| void | setBorderColor(QColor color) |
Benachrichtigungssignal:
| void | borderColorChanged(QColor color) |
borderWidth : qreal
Diese Eigenschaft enthält die Breite der Umrandungslinie. Standardmäßig ist die Breite -1, was bedeutet, dass die Breite des Rahmens durch das Thema definiert ist.
Zugriffsfunktionen:
| qreal | borderWidth() const |
| void | setBorderWidth(qreal borderWidth) |
Benachrichtigungssignal:
| void | borderWidthChanged(qreal width) |
color : QColor
Diese Eigenschaft enthält die Füllfarbe des Balkensatzes.
Zugriffsfunktionen:
Benachrichtigungssignal:
| void | colorChanged(QColor color) |
[read-only] count : const qsizetype
Diese Eigenschaft enthält die Anzahl der Werte in der Balkenmenge.
Zugriffsfunktionen:
| qsizetype | count() const | [see note below] |
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Melder-Signal:
| void | countChanged() |
label : QString
Diese Eigenschaft enthält die Bezeichnung des Balkensatzes.
Zugriffsfunktionen:
Melder-Signal:
| void | labelChanged() |
labelColor : QColor
Diese Eigenschaft enthält die Textfarbe (Beschriftung) des Balkensatzes.
Zugriffsfunktionen:
| QColor | labelColor() const |
| void | setLabelColor(QColor color) |
Melder-Signal:
| void | labelColorChanged(QColor color) |
[read-only] selectedBars : const QList<qsizetype>
Diese Eigenschaft enthält die Indizes der Takte, die gerade ausgewählt sind.
Zugriffsfunktionen:
| QList<qsizetype> | selectedBars() const |
Benachrichtigungssignal:
| void | selectedBarsChanged(const QList<qsizetype> &indexes) |
selectedColor : QColor
Diese Eigenschaft enthält die Füllfarbe der Auswahlmenge.
Zugriffsfunktionen:
| QColor | selectedColor() const |
| void | setSelectedColor(QColor color) |
Benachrichtigungssignal:
| void | selectedColorChanged(QColor color) |
values : QVariantList
Diese Eigenschaft enthält die Werte des Balkensatzes.
Sie können eine Liste der Typen real oder point als Werte festlegen.
Wenn Sie eine Liste von reellen Typen 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 seinen nullbasierten Index in der Balkenmenge an. Die Größe der Balkenmenge ist der höchste 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() |
Member Function Dokumentation
[explicit] QBarSet::QBarSet(const QString &label, QObject *parent = nullptr)
Konstruiert einen Balkensatz mit der Beschriftung label und dem übergeordneten parent.
[override virtual noexcept] QBarSet::~QBarSet()
Entfernt den Balkensatz.
[invokable] void QBarSet::append(const QList<qreal> &values)
Hängt die durch values angegebene Liste der reellen Werte an das Ende der Balkenmenge an.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch append().
[invokable] void QBarSet::append(qreal value)
Hängt den durch value angegebenen neuen Wert an das Ende der Taktmenge an.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] qreal QBarSet::at(qsizetype 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.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
QColor QBarSet::borderColor() const
Liefert die Linienfarbe für den eingestellten Balken.
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 Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
QColor QBarSet::color() const
Liefert die Füllfarbe für den Balkensatz.
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 Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Hinweis: Getter-Funktion für die Eigenschaft count.
[invokable] void QBarSet::deselectAllBars()
Deselektiert alle Takte in der Gruppe.
Hinweis: Gibt QBarSet::selectedBarsChanged aus.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch setBarSelected().
[invokable] void QBarSet::deselectBar(qsizetype index)
Deselektiert den Balken auf index.
Hinweis: Gibt QBarSet::selectedBarsChanged aus.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch setBarSelected().
[invokable] void QBarSet::deselectBars(const QList<qsizetype> &indexes)
Markiert mehrere in einer Liste indexes übergebene Takte als abgewählt.
Hinweis: Gibt QBarSet::selectedBarsChanged aus.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus 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 Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch remove().
[invokable] bool QBarSet::isBarSelected(qsizetype 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.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
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().
QColor QBarSet::labelColor() const
Liefert die Textfarbe für den eingestellten Balken.
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 Balkenmenge, beginnend mit dem durch index angegebenen Wert.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch insert().
[invokable] void QBarSet::replace(qsizetype index, qreal value)
Fügt den durch value angegebenen Wert an der durch index angegebenen Position zum Takt hinzu.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QBarSet::selectAllBars()
Markiert alle Takte in der Menge als ausgewählt.
Hinweis: Gibt QBarSet::selectedBarsChanged aus.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch setBarSelected().
[invokable] void QBarSet::selectBar(qsizetype index)
Markiert den Balken auf index als ausgewählt.
Hinweis: Gibt QBarSet::selectedBarsChanged aus.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch setBarSelected().
[invokable] void QBarSet::selectBars(const QList<qsizetype> &indexes)
Markiert mehrere in einer Liste indexes übergebene Takte als ausgewählt.
Hinweis: Gibt QBarSet::selectedBarsChanged aus.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch setBarSelected().
QList<qsizetype> QBarSet::selectedBars() const
Gibt eine Liste der als ausgewählt markierten Takte zurück.
Hinweis: Getter-Funktion für die Eigenschaft selectedBars.
Siehe auch setBarSelected().
[signal] void QBarSet::selectedBarsChanged(const QList<qsizetype> &indexes)
Dieses Signal wird ausgegeben, wenn sich der ausgewählte Takt ändert. indexes ist eine Liste ausgewählter Taktindizes.
Hinweis: Melder-Signal für die Eigenschaft selectedBars.
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.
Hinweis: Getter-Funktion für die Eigenschaft selectedColor.
Siehe auch setSelectedColor() und color.
[invokable] void QBarSet::setBarSelected(qsizetype index, bool selected)
Markiert den Balken auf index als ausgewählt oder abgewählt, wie unter selected angegeben.
Hinweis: Ausgewählte Balken werden mit der ausgewählten Farbe gezeichnet, sofern diese angegeben wurde. Gibt QBarSet::selectedBarsChanged aus.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
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::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::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::setSelectedColor(QColor color)
Setzt die color der ausgewählten Takte.
Hinweis: Setter-Funktion für die Eigenschaft selectedColor.
Siehe auch selectedColor.
[invokable] qreal QBarSet::sum() const
Gibt die Summe aller Werte in der Balkenmenge zurück.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QBarSet::toggleSelection(const QList<qsizetype> &indexes)
Ändert den Auswahlzustand der Balken auf der angegebenen indexes in den entgegengesetzten Zustand.
Hinweis: Gibt QBarSet::selectedBarsChanged aus.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus 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 Takte in dieser Menge aktualisiert werden.
[signal] void QBarSet::valueAdded(qsizetype index, qsizetype count)
Dieses Signal wird ausgegeben, wenn neue Werte in die Taktmenge eingefügt werden. index gibt die Position des ersten eingefügten Wertes an, und count ist die Anzahl der eingefügten Werte.
[signal] void QBarSet::valueChanged(qsizetype index)
Dieses Signal wird ausgegeben, 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 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.
[signal] void QBarSet::valuesAdded(qsizetype index, qsizetype 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(qsizetype index, qsizetype 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<<(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[](qsizetype 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.
