BarSet QML Type
Stellt einen Satz von Balken in einem Balkendiagramm dar. Mehr...
| Import Statement: | import QtCharts 2.12 |
| In C++: | QBarSet |
| Status: | Deprecated |
Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
- borderColor : color
- borderWidth : real
- brushFilename : string
- color : color
- count : int
- label : string
- labelColor : color
- labelFont : font
- values : list<var>
Signale
- clicked(int index)
- doubleClicked(int index)
- pressed(int index)
- released(int index)
- valueChanged(int index)
- valuesAdded(int index, int count)
- valuesRemoved(int index, int count)
Methoden
- void append(real value)
- real at(int index)
- void remove(int index, int count)
- void replace(int index, real value)
Ausführliche 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 Datenreihe wird der numerische Wert Null verwendet. Beschriftungen für Datenreihen mit dem Wert Null werden nicht angezeigt.
Siehe auch AbstractBarSeries, BarSeries, StackedBarSeries, PercentBarSeries, HorizontalBarSeries, HorizontalStackedBarSeries und HorizontalPercentBarSeries.
Dokumentation zu Eigenschaften
borderColor : color
Die Linienfarbe (Stiftfarbe) des Balkensatzes.
borderWidth : real
Die Breite der Rahmenlinie. Standardmäßig beträgt die Breite 2,0.
brushFilename : string
Der Name der Datei, die als Pinsel für das Set verwendet wird.
color : color
Die Füllfarbe (Pinsel) des Balkensatzes.
count : int
Die Anzahl der Werte in der Balkenreihe.
label : string
Das Etikett des Bar-Sets.
labelColor : color
Die Textfarbe (Beschriftung) der Balkengruppe.
labelFont : font
Die Schriftart, die zum Zeichnen der Beschriftung des Balkensatzes verwendet wird.
Weitere Informationen finden Sie unter font.
values : list<var>
Die Werte des Balkensatzes. Als Werte können Sie entweder eine Liste von „ real “- oder „ point “-Typen 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 weisen die folgenden Balkensätze gleiche Werte auf:
myBarSet1.values = [5, 0, 1, 5];
myBarSet2.values = [Qt.point(0, 5), Qt.point(2, 1), Qt.point(3, 5)];Signal-Dokumentation
clicked(int index)
Dieses Signal wird ausgelöst, wenn der Benutzer in einem Balkensatz auf den durch „ index “ angegebenen Balken klickt.
Der zugehörige Signal-Handler ist „ onClicked “.
Hinweis: Der entsprechende Handler ist „ onClicked “.
doubleClicked(int index)
Dieses Signal wird ausgelöst, wenn der Benutzer in einem Balkensatz auf den durch „ index “ angegebenen Balken doppelklickt.
Der zugehörige Signal-Handler ist „ onDoubleClicked “.
Hinweis: Der entsprechende Handler ist „ onDoubleClicked “.
pressed(int index)
Dieses Signal wird ausgelöst, wenn der Benutzer in einem Balkensatz auf den unter index angegebenen Balken klickt und die Maustaste gedrückt hält.
Der zugehörige Signal-Handler ist „ onPressed “.
Hinweis: Der entsprechende Handler ist „ onPressed “.
released(int index)
Dieses Signal wird ausgelöst, wenn der Benutzer den Mausklick auf dem Balken, der durch „ index “ in einem Balkensatz angegeben ist, aufhebt.
Der entsprechende Signal-Handler ist „ onReleased “.
Hinweis: Der entsprechende Handler ist „ onReleased “.
valueChanged(int index)
Dieses Signal wird ausgelöst, wenn der Wert an der durch index angegebenen Position geändert wird.
Der zugehörige Signal-Handler ist „ onValueChanged “.
Hinweis: Der entsprechende Handler ist „ onValueChanged “.
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.
Der zugehörige Signal-Handler lautet „ onValuesAdded “.
Hinweis: Der entsprechende Handler ist onValuesAdded.
valuesRemoved(int index, int count)
Dieses Signal wird ausgelöst, wenn Werte aus der Balkenmenge entfernt werden. „ index “ gibt die Position des ersten entfernten Werts an, und „ count “ ist die Anzahl der entfernten Werte.
Der zugehörige Signal-Handler lautet „ onValuesRemoved “.
Hinweis: Der zugehörige Handler ist „ onValuesRemoved “.
Methodendokumentation
void append(real value)
Fügt den neuen Wert, der durch „ value “ angegeben wird, am Ende der Taktserie 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 remove(int index, int count)
Entfernt die Anzahl der Werte, die durch „ count “ angegeben ist, aus der Balkenreihe, 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.
© 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.