BarSet QML Type
Stellt einen Satz von Balken in einem Balkendiagramm dar. Mehr...
| Import Statement: | import QtGraphs |
| In C++: | QBarSet |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- BarSet ist Teil von „Qt Graphs “ – QML-Typen für 2D.
Eigenschaften
- borderColor : color
- borderWidth : real
- color : color
- count : int
- label : string
- labelColor : color
- selectedBars : list
- selectedColor : color
- values : list<variant>
Signale
- borderColorChanged(color)
- borderWidthChanged(real width)
- colorChanged(color)
- countChanged()
- labelChanged()
- labelColorChanged(color)
- selectedBarsChanged(list<int> indexes)
- selectedColorChanged(color color)
- update()
- updatedBars()
- valueAdded(int index, int count)
- valueChanged(int index)
- valueRemoved(int index, int count)
- valuesAdded(int index, int count)
- valuesChanged()
- valuesRemoved(int index, int count)
Methoden
- void append(list<real> values)
- void append(real value)
- real at(int index)
- void clear()
- int count()
- void deselectAllBars()
- void deselectBar(int index)
- void deselectBars(list<int> indexes)
- void insert(int index, real value)
- bool isBarSelected(int index)
- void remove(int index, int count)
- void replace(int index, real value)
- void selectAllBars()
- void selectBar(int index)
- void selectBars(list<int> indexes)
- void setBarSelected(int index, bool selected)
- real sum()
- void toggleSelection(list<int> indexes)
Ausführliche 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 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 Reihe wird der numerische Wert Null verwendet. Beschriftungen für Reihen mit dem Wert Null werden nicht angezeigt.
Siehe auch „ BarSeries “.
Dokumentation zu Eigenschaften
borderColor : color
Die Rahmenfarbe des Balkensatzes.
borderWidth : real
Standardmäßig ist die Breite auf -1 gesetzt, was bedeutet, dass die Rahmenbreite durch das Theme festgelegt wird.
color : color
Die Füllfarbe der Balkengruppe.
count : int [read-only]
Die Anzahl der Werte in der Balkenreihe.
label : string
Das Etikett des Bar-Sets.
labelColor : color
Die Textfarbe (Beschriftung) der Balkenreihe.
selectedBars : list [read-only]
Die Indizes der derzeit ausgewählten Balken.
selectedColor : color
Die Füllfarbe der ausgewählten Gruppe.
values : list<variant>
Die Werte des Balkensatzes. Als Werte können Sie eine Liste mit Typen vom Typ „ 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.
Beispielsweise haben die folgenden Balkensätze gleiche Werte:
myBarSet1.values = [5, 0, 1, 5];
myBarSet2.values = [Qt.point(0, 5), Qt.point(2, 1), Qt.point(3, 5)];Signal-Dokumentation
borderColorChanged(color)
Dieses Signal wird ausgelöst, wenn sich die Rahmenfarbe des Balkensatzes auf „ color “ ändert.
Hinweis: Der entsprechende Handler lautet „ onBorderColorChanged “.
borderWidthChanged(real width)
Dieses Signal wird ausgelöst, wenn sich die Rahmenbreite des Barsets ändert. Die neue Breite lautet width.
Hinweis: Der entsprechende Handler lautet onBorderWidthChanged.
colorChanged(color)
Dieses Signal wird ausgelöst, wenn sich die Füllfarbe des Balkensatzes auf „ color “ ändert.
Hinweis: Der entsprechende Handler lautet „ onColorChanged “.
countChanged()
Dieses Signal wird ausgelöst, wenn sich die Anzahl der Werte im Barset ändert.
Hinweis: Der entsprechende Handler lautet „ onCountChanged “.
labelChanged()
Dieses Signal wird ausgegeben, wenn sich die Beschriftung des Balkensatzes ändert.
Hinweis: Der entsprechende Handler lautet „ onLabelChanged “.
Siehe auch label.
labelColorChanged(color)
Dieses Signal wird ausgelöst, wenn sich die Textfarbe (Beschriftungsfarbe) der Balkengruppe auf „ color “ ändert.
Hinweis: Der entsprechende Handler lautet „ onLabelColorChanged “.
selectedBarsChanged(list<int> indexes)
Dieses Signal wird ausgelöst, wenn sich der ausgewählte Balken ändert. „ indexes “ ist eine Liste mit den Indizes der ausgewählten Balken.
Hinweis: Der entsprechende Handler ist „ onSelectedBarsChanged “.
selectedColorChanged(color color)
Dieses Signal wird ausgelöst, wenn sich die Farbe des ausgewählten Balkens ändert. Die neue Farbe lautet „ color “.
Hinweis: Der entsprechende Handler lautet „ onSelectedColorChanged “.
update()
Dieses Signal wird ausgegeben, wenn der Barset aktualisiert wird.
Hinweis: Der entsprechende Handler lautet „ onUpdate “.
updatedBars()
Dieses Signal wird ausgelöst, wenn die Balken in diesem Satz aktualisiert werden.
Hinweis: Der entsprechende Handler lautet „ onUpdatedBars “.
valueAdded(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.
Hinweis: Der entsprechende Handler lautet onValueAdded.
valueChanged(int index)
Dieses Signal wird ausgelöst, wenn der Wert an der durch index angegebenen Position geändert wird.
Hinweis: Der entsprechende Handler lautet „ onValueChanged “.
valueRemoved(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.
Hinweis: Der entsprechende Handler lautet onValueRemoved.
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.
Hinweis: Der entsprechende Handler lautet onValuesAdded.
valuesChanged()
Dieses Signal wird ausgelöst, wenn sich die Werte des Balkensatzes ändern.
Hinweis: Der entsprechende Handler lautet „ onValuesChanged “.
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.
Hinweis: Der entsprechende Handler lautet onValuesRemoved.
Methodendokumentation
void append(list<real> values)
Fügt die durch ` values ` angegebene Liste von reellen Werten am Ende des Balkensatzes an.
Siehe auch append ().
void append(real value)
Fügt den neuen Wert, der durch ` value ` angegeben wird, am Ende der Balkenreihe an.
real at(int index)
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.
void clear()
Entfernt alle Werte aus der Menge.
int count()
Gibt die Anzahl der Werte in einer Balkenreihe zurück.
void deselectAllBars()
Hebt die Auswahl aller Balken im Satz auf.
Hinweis: Löst „ BarSet::selectedBarsChanged “aus .
Siehe auch ` setBarSelected()`.
void deselectBar(int index)
Hebt die Auswahl des Balkens unter index auf.
Hinweis: Gibt „ BarSet::selectedBarsChanged “aus .
Siehe auch setBarSelected().
void deselectBars(list<int> indexes)
Markiert mehrere in einer „ indexes “-Liste übergebene Balken als abgewählt.
Hinweis: Löst „ BarSet::selectedBarsChanged “aus .
Siehe auch ` setBarSelected()`.
void insert(int index, real 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()“.
bool isBarSelected(int index)
Gibt „ true “ zurück, wenn sich der Balken unter der angegebenen Adresse „ index “ unter den ausgewählten Balken befindet, andernfalls „ false “.
Hinweis: Ausgewählte Balken werden in der ausgewählten Farbe dargestellt, sofern diese mit `BarSet::setSelectedColor` festgelegt wurde.
Siehe auch „ selectedBars“ , „ setBarSelected()“ und „ selectedColor “.
void remove(int index, int count)
Entfernt die Anzahl der durch „ count “ angegebene Werte aus der Balkengruppe, beginnend mit dem durch „ index “ angegebenen Wert.
Wenn Sie „ count “ weglassen, wird nur der durch „ index “ angegebene Wert entfernt.
void replace(int index, real value)
Fügt den durch value angegebenen Wert zu dem Balken hinzu, der an der durch index angegebenen Position gesetzt ist.
void selectAllBars()
Markiert alle Balken in der Gruppe als ausgewählt.
Hinweis: Gibt „ BarSet::selectedBarsChanged “aus .
Siehe auch „ setBarSelected()“.
void selectBar(int index)
Markiert die Leiste unter index als ausgewählt.
Hinweis: Gibt ` BarSet::selectedBarsChanged`aus .
Siehe auch setBarSelected().
void selectBars(list<int> indexes)
Markiert mehrere in einer „ indexes “-Liste übergebene Balken als ausgewählt.
Hinweis: Löst „ BarSet::selectedBarsChanged “aus .
Siehe auch ` setBarSelected()`.
void 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. Gibt ` BarSet::selectedBarsChanged` aus.
Siehe auch „ isBarSelected()“ und „ selectedColor “.
real sum()
Gibt die Summe aller Werte im Balkensatz zurück.
void toggleSelection(list<int> indexes)
Ändert den Auswahlstatus der Balken an der angegebenen Adresse indexes in den entgegengesetzten.
Hinweis: Löst „ BarSet::selectedBarsChanged “aus .
Siehe auch ` setBarSelected()`.
© 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.
