BarSeries QML Type
Stellt Daten in Balkendiagrammen dar. Mehr...
| Import Statement: | import QtGraphs |
| In C++: | QBarSeries |
| Inherits: |
- Liste aller Elemente, einschließlich vererbter Elemente
- „BarSeries“ ist Teil der „Qt Graphs “-QML-Typen für 2D.
Eigenschaften
- barDelegate : Component
- barSets : list<BarSet>
- barWidth : real
- barsType : enumeration
- borderColors : list<color>
- count : int
- labelsAngle : real
- labelsFormat : string
- labelsMargin : real
- labelsPosition : enumeration
- labelsPrecision : real
- labelsVisible : bool
- seriesColors : list<color>
Signale
- barsetsAdded()
- barsetsRemoved()
- clicked(int index, BarSet barset)
- doubleClicked(int index, BarSet barset)
- pressed(int index, BarSet barset)
- released(int index, BarSet barset)
Methoden
- bool append(BarSet barset)
- BarSet at(int index)
- Barset at(int index)
- void clear()
- int find(BarSet barset)
- BarSet insert(int index, BarSet barset)
- bool remove(BarSet barset)
- bool remove(int index)
- void removeMultiple(int index, int count)
- bool replace(list<BarSet> sets)
- bool replace(BarSet oldSet, BarSet newSet)
- bool replace(int index, BarSet barset)
Ausführliche Beschreibung
Zeichnet Daten standardmäßig als eine Reihe von Balken, die nach Kategorien gruppiert sind, wobei pro Kategorie aus jedem Balkensatz ein Balken zur Reihe hinzugefügt wird. Es werden auch horizontale Balken sowie die Gruppierung von Balken als gestapelte Balken unterstützt.
Dokumentation zu den Eigenschaften
barDelegate : Component
Eine benutzerdefinierte QML-Komponente zur Darstellung der einzelnen Balken. Für jeden Balken wird eine Instanz dieser Komponente erstellt. Ist diese nicht definiert, wird eine Standarddarstellung der Balken als Rechtecke verwendet.
Die für diese Komponente verfügbaren dynamischen Eigenschaften sind:
| Typ | Name | Beschreibung |
|---|---|---|
| Farbe | barColor | Die Füllfarbe des Balkens. Dieser Wert stammt entweder aus der „ GraphsTheme “ oder aus „ BarSet::color “, falls die „ BarSet “ die Farbe überschreibt. |
| Farbe | barBorderColor | Die Rahmenfarbe des Balkens. Dieser Wert stammt entweder aus der „ GraphsTheme “ oder aus „ BarSet::borderColor “, falls die „ BarSet “ die Farbe überschreibt. |
| real | barBorderWidth | Die Breite des Balkenrahmens. Dieser Wert stammt entweder aus der „ GraphsTheme “ oder aus der „ BarSet::borderWidth “, falls die „ BarSet “ die Breite überschreibt. |
| real | barValue | Der Wert des Balkens. Dieser Wert stammt aus dem „ BarSet::values “. |
| Zeichenkette | barLabel | Die Beschriftung des Balkens. Dieser Wert stammt aus dem ` BarSet::label`. |
| bool | barSelected | Dieser Wert ist „true“, wenn der Balken ausgewählt ist, d. h., wenn der Balkenindex in „ BarSet::selectedBars “ enthalten ist. |
| int | barIndex | Index des Balkens, von 0 bis zur Anzahl der Balken minus 1. [seit 6.9] |
Um eine dieser Eigenschaften zu verwenden, fügen Sie eine Eigenschaft mit dem entsprechenden Namen in Ihre benutzerdefinierte Komponente ein. Zum Beispiel „ "property color barColor" “ und „ "property real barValue" “.
barSets : list<BarSet> [read-only]
Eine Liste der Sets, die der Serie hinzugefügt wurden.
barWidth : real
Die Breiten-Einheit entspricht der Einheit der x-Achse. Die Mindestbreite für Balken beträgt null, und negative Werte werden als null behandelt. Wird die Breite auf null gesetzt, bedeutet dies, dass die Breite des Balkens auf dem Bildschirm unabhängig vom Maßstab der x-Achse einen Pixel beträgt. Balken, die breiter als null sind, werden entsprechend dem Maßstab der x-Achse skaliert.
Standardmäßig beträgt „barWidth“ 0,5 (die Balken nehmen 50 % der verfügbaren Breite ein). Die gültigen Werte reichen von 0,0 (0 %) bis 1,0 (100 %).
Hinweis: Bei Verwendung mit dem Typ „ BarSeries “ gibt dieser Wert die Breite einer Gruppe von Balken an, nicht die eines einzelnen Balkens.
barsType : enumeration
Der Typ der Stabreihe:
| Konstant | Beschreibung |
|---|---|
BarSeries.BarsType.Groups | Balkensätze werden nach Kategorien gruppiert. Dies ist der Standardwert. |
BarSeries.BarsType.Stacked | Balkensätze werden nach Kategorien übereinander gestapelt. |
BarSeries.BarsType.StackedPercent | Balkensätze werden nach Kategorien nacheinander gestapelt. Die Segmentgröße entspricht dem prozentualen Anteil des Segmentwerts am Gesamtwert aller Segmente im Stapel. |
borderColors : list<color>
Die Liste der Rahmenfarben, die für alle Objekte der Serie verwendet werden sollen.
Wenn es mehr Reihen als Farben gibt, wird die Farbliste umgebrochen und beginnt erneut mit der ersten Farbe in der Liste. Wenn dieser Parameter nicht festgelegt ist (Standard), werden Farben aus der „ GraphsTheme::borderColors “ verwendet.
count : int [read-only]
Die Anzahl der Balkensätze in einer Balkenreihe.
labelsAngle : real
Der Winkel der Wertbeschriftungen in Grad.
labelsFormat : string
Das Format, das für die Darstellung von Beschriftungen in einer Balkenreihe verwendet wird.
Siehe auch „ QBarSeries::labelsFormat “, „ labelsVisible “ und „ labelsPosition “.
labelsMargin : real
Der Rand der Wertbeschriftungen in Pixeln.
Dieser seitliche Rand wird verwendet, wenn „ labelsPosition “ auf einen anderen Wert als „ LabelsPosition.Center “ gesetzt ist. Der Standardwert ist „ 0 “.
labelsPosition : enumeration
Die Position der Datenwertbeschriftungen:
| Konstante | Beschreibung |
|---|---|
BarSeries.LabelsPosition.Center | Die Beschriftung befindet sich in der Mitte des Balkens. |
BarSeries.LabelsPosition.InsideEnd | Die Beschriftung befindet sich oben im Balken. |
BarSeries.LabelsPosition.InsideBase | Die Beschriftung befindet sich innerhalb des Balkens am unteren Rand. |
BarSeries.LabelsPosition.OutsideEnd | Die Beschriftung befindet sich außerhalb des Balkens oben. |
Siehe auch labelsVisible und labelsFormat.
labelsPrecision : real
Die maximale Anzahl der in Wertbeschriftungen angezeigten signifikanten Ziffern.
Der Standardwert beträgt 6.
labelsVisible : bool
Die Sichtbarkeit der Beschriftungen in einer Balkenreihe. Die Standard-Sichtbarkeit der Beschriftungen ist „ false “.
Hinweis: Die Standardbeschriftung zeigt nur den Wert für die Menge an. Sie können benutzerdefinierte Beschriftungen mit „ barDelegate “ erstellen.
Siehe auch „ barDelegate “.
seriesColors : list<color>
Die Liste der Grundfarben, die für alle Objekte der Serie verwendet werden sollen.
Wenn es mehr Serien als Farben gibt, wird die Farbliste umgebrochen und beginnt wieder mit der ersten Farbe in der Liste. Wenn diese Option nicht festgelegt ist (Standard), werden Farben aus der „ GraphsTheme::seriesColors “ verwendet.
Signal-Dokumentation
barsetsAdded()
Dieses Signal wird ausgegeben, wenn Balkensätze zur Serie hinzugefügt werden.
Hinweis: Der entsprechende Handler lautet „ onBarsetsAdded “.
barsetsRemoved()
Dieses Signal wird ausgegeben, wenn Balkensätze aus der Serie entfernt werden.
Hinweis: Der entsprechende Handler lautet „ onBarsetsRemoved “.
clicked(int index, BarSet barset)
Dieses Signal wird ausgelöst, wenn der Benutzer auf die Leiste klickt oder tippt, die durch „ index “ in dem durch „ barset “ festgelegten Leisten-Set angegeben ist.
Hinweis: Der entsprechende Handler lautet „ onClicked “.
doubleClicked(int index, BarSet barset)
Dieses Signal wird ausgelöst, wenn der Benutzer auf die durch „ index “ angegebene Leiste im durch „ barset “ angegebenen Leisten-Set doppelklickt oder doppelt antippt. Dieses Signal tritt immer nach „ clicked “ auf.
Hinweis: Der entsprechende Handler lautet „ onDoubleClicked “.
pressed(int index, BarSet barset)
Dieses Signal wird ausgelöst, wenn der Benutzer auf die durch „ index “ angegebene Leiste in dem durch „ barset “ festgelegten Leisten-Set klickt oder tippt und dabei die Maustaste oder Geste gedrückt hält.
Hinweis: Der entsprechende Handler lautet „ onPressed “.
released(int index, BarSet barset)
Dieses Signal wird ausgelöst, wenn der Benutzer eine zuvor gedrückte Maustaste loslässt oder eine Geste auf der Leiste ausführt, die durch index in dem durch barset festgelegten Leisten-Set angegeben ist.
Hinweis: Der entsprechende Handler lautet onReleased.
Methodendokumentation
bool append(BarSet barset)
Fügt der Balkenreihe eine durch ` barset ` angegebene Gruppe von Balken hinzu und übernimmt die Verantwortung dafür. Ist die Gruppe null oder gehört sie bereits zur Reihe, wird sie nicht angehängt.
Gibt ` true ` zurück, wenn das Anhängen erfolgreich war.
Siehe auch ` insert()`.
BarSet at(int index)
Gibt den unter index festgelegten Balken zurück. Gibt „null“ zurück, wenn der Index ungültig ist.
Barset at(int index)
Gibt die durch „ index “ angegebene Balkengruppe aus der Reihe zurück. Andernfalls wird „ null “ zurückgegeben.
void clear()
Entfernt alle Stangensätze aus der Serie.
int find(BarSet barset)
Gibt den Index des durch „ barset “ angegebenen Balkensatzes aus der Reihe zurück. Gibt „ -1 “ zurück, wenn dieser nicht gefunden wird.
BarSet insert(int index, BarSet barset)
Fügt eine durch barset angegebene Balkengruppe an der durch index angegebenen Position in eine Reihe ein. Wenn die Gruppe null ist oder bereits zur Reihe gehört, wird sie nicht angehängt. Gibt true zurück, wenn das Einfügen erfolgreich war.
Siehe auch append().
bool remove(BarSet barset)
Entfernt den durch „ barset “ angegebenen Balkensatz aus der Reihe. Gibt bei Erfolg „ true “ zurück, andernfalls „ false “.
bool remove(int index)
Entfernt den durch „ index “ angegebenen Balkensatz aus der Reihe. Gibt „ true “ zurück, wenn das Entfernen erfolgreich war, andernfalls „ false “.
void removeMultiple(int index, int count)
Entfernt eine Reihe von Bar-Sets, wie unter index und count angegeben. Der Aufruf durchläuft alle Sets, auch wenn das Entfernen eines Sets fehlschlägt.
bool replace(list<BarSet> sets)
Ersetzt das gesamte aktuelle Balkenset vollständig durch sets. Die Größe muss nicht übereinstimmen. Gibt „false“ zurück, wenn eines der in sets festgelegten Balkensets ungültig ist.
bool replace(BarSet oldSet, BarSet newSet)
Ersetzt das durch ` oldSet ` angegebene Bar-Set durch `newSet`. Gibt ` true ` zurück, wenn das Entfernen erfolgreich war, andernfalls ` false `. ` oldSet ` wird bei Erfolg gelöscht.
bool replace(int index, BarSet barset)
Ersetzt den Balken an der durch ` index ` angegebenen Position in der Reihe durch ` barset`. Gibt bei Erfolg ` true ` zurück, andernfalls ` false `.
© 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.
