BarSeries QML Type
Stellt Daten in Balkendiagrammen dar. Mehr...
| Import Statement: | import QtGraphs |
| In C++: | QBarSeries |
| Inherits: |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- BarSeries ist Teil von Qt Graphs QML Types for 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)
- clear()
- int find(BarSet barset)
- BarSet insert(int index, string label, VariantList values)
- bool remove(BarSet barset)
- bool remove(int index)
- removeMultiple(int index, int count)
- bool replace(list<BarSet> sets)
- bool replace(BarSet oldSet, BarSet newSet)
- bool replace(int index, BarSet barset)
Detaillierte Beschreibung
Zeichnet Daten standardmäßig als eine Reihe von Balken, die nach Kategorien gruppiert sind, wobei ein Balken pro Kategorie aus jedem Balkensatz zur Reihe hinzugefügt wird. Unterstützt auch horizontale Balken und gruppierte Balken als gestapelt.
Eigenschaft Dokumentation
barDelegate : Component |
Eine benutzerdefinierte QML-Komponente, die für die Visualisierung der einzelnen Balken verwendet wird. Eine Instanz dieser Komponente wird für jeden der Balken erstellt. Wenn diese Komponente nicht definiert ist, wird eine standardmäßige Rechteckdarstellung für Balken verwendet.
Die folgenden dynamischen Eigenschaften sind für diese Komponente verfügbar:
| Typ | Name | Beschreibung |
|---|---|---|
| Farbe | barColor | Die Füllfarbe des Balkens. Dieser Wert stammt entweder von GraphsTheme oder von BarSet::color, wenn BarSet die Farbe überschreibt. |
| Farbe | barBorderColor | Die Farbe des Rahmens des Balkens. Dieser Wert stammt entweder aus GraphsTheme oder aus BarSet::borderColor, wenn BarSet die Farbe übersteuert. |
| real | barBorderWidth | Die Breite der Umrandung des Balkens. Dieser Wert stammt entweder aus GraphsTheme oder aus BarSet::borderWidth, wenn BarSet die Breite überschreibt. |
| real | barValue | Der Wert des Balkens. Dieser Wert stammt aus der BarSet::values. |
| string | barLabel | Die Beschriftung des Balkens. Dieser Wert stammt aus dem BarSet::label. |
| bool | barSelected | Dieser Wert ist wahr, wenn der Balken ausgewählt ist, was bedeutet, dass der Balkenindex in BarSet::selectedBars steht. |
| int | barIndex | Index des Balkens, von 0 bis zur Anzahl der Balken - 1. [seit 6.9] |
Um eine dieser Eigenschaften zu verwenden, fügen Sie die Eigenschaft mit dem definierten Namen in Ihre benutzerdefinierte Komponente ein. Zum Beispiel "property color barColor" und "property real barValue".
barWidth : real |
Die Einheit der Breite ist die Einheit der x-Achse. Die Mindestbreite für Balken ist Null, und negative Werte werden als Null behandelt. Die Einstellung der Breite auf Null bedeutet, dass die Breite des Balkens auf dem Bildschirm ein Pixel beträgt, unabhängig von der Skalierung der x-Achse. Balken, die breiter als Null sind, werden anhand der Skala der x-Achse skaliert.
Die Standardeinstellung für barWidth ist 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 anstelle der eines einzelnen Balkens an.
barsType : enumeration |
Der Typ der Balkenreihe:
| Konstante | Beschreibung |
|---|---|
BarSeries.BarsType.Groups | Balkensätze werden nach Kategorie gruppiert. Dies ist der Standardwert. |
BarSeries.BarsType.Stacked | Balkensätze werden nach Kategorie hintereinander gestapelt. |
BarSeries.BarsType.StackedPercent | Balkensätze werden nach Kategorie hintereinander gestapelt. Die Segmentgröße entspricht dem prozentualen Anteil des Segmentwertes im Vergleich zum Gesamtwert aller Segmente im Stapel. |
Die Liste der Rahmenfarben, die für alle Objekte in der Serie verwendet werden sollen.
Wenn es mehr Serien als Farben gibt, wird die Farbliste umbrochen und beginnt wieder mit der ersten Farbe in der Liste. Wenn dies nicht eingestellt ist (Standard), werden die Farben von GraphsTheme::borderColors verwendet.
count : int |
Die Anzahl der Balkensätze in einer Balkenserie.
labelsAngle : real |
Der Winkel der Wertelabels in Grad.
labelsFormat : string |
Das Format, das für die Anzeige der Beschriftungen in einer Balkenreihe verwendet wird.
Siehe auch QBarSeries::labelsFormat, labelsVisible, und labelsPosition.
labelsMargin : real |
Der Rand der Wertelabels in Pixeln.
Dieser Seitenabstand wird verwendet, wenn labelsPosition auf einen anderen Wert als LabelsPosition.Center eingestellt ist. Der Standardwert ist 0.
labelsPosition : enumeration |
Die Position der Datenwertbeschriftungen:
| Konstante | Beschreibung |
|---|---|
BarSeries.LabelsPosition.Center | Das Etikett befindet sich in der Mitte des Balkens. |
BarSeries.LabelsPosition.InsideEnd | Das Etikett befindet sich innerhalb des Balkens am oberen Rand. |
BarSeries.LabelsPosition.InsideBase | Die Beschriftung befindet sich innerhalb des Balkens am unteren Rand. |
BarSeries.LabelsPosition.OutsideEnd | Die Beschriftung befindet sich außerhalb des oberen Balkens. |
Siehe auch labelsVisible und labelsFormat.
labelsPrecision : real |
Die maximale Anzahl signifikanter Ziffern, die in Wertelabels angezeigt werden.
Der Standardwert ist 6.
labelsVisible : bool |
Die Sichtbarkeit der Beschriftungen in einer Balkenreihe. Der Standardwert für die Sichtbarkeit der Beschriftungen ist false.
Die Liste der Grundfarben, die für alle Objekte in der Reihe verwendet werden sollen.
Wenn es mehr Serien als Farben gibt, wird die Farbliste umbrochen und beginnt wieder mit der ersten Farbe in der Liste. Wenn dies nicht festgelegt ist (Voreinstellung), werden die Farben aus GraphsTheme::seriesColors verwendet.
Signal Dokumentation
barsetsAdded() |
Dieses Signal wird ausgegeben, wenn Taktsätze zu den Serien hinzugefügt werden.
Hinweis: Der entsprechende Handler ist onBarsetsAdded.
barsetsRemoved() |
Dieses Signal wird ausgegeben, wenn Taktsätze aus der Serie entfernt werden.
Hinweis: Der entsprechende Handler ist onBarsetsRemoved.
Dieses Signal wird ausgegeben, wenn der Benutzer auf den durch index angegebenen Balken im durch barset angegebenen Balkensatz klickt oder tippt.
Hinweis: Der entsprechende Handler ist onClicked.
Dieses Signal wird ausgegeben, wenn der Benutzer auf die durch index angegebene Leiste in der durch barset angegebenen Leistengruppe doppelt klickt oder doppelt tippt. Dieses Signal tritt immer nach clicked auf.
Hinweis: Der entsprechende Handler ist onDoubleClicked.
Dieses Signal wird ausgegeben, wenn der Benutzer auf den durch index angegebenen Balken in der durch barset angegebenen Balkengruppe klickt oder tippt und die Maustaste oder die Geste gedrückt hält.
Hinweis: Der entsprechende Handler ist onPressed.
Dieses Signal wird ausgegeben, wenn der Benutzer eine zuvor gedrückte Maustaste oder Geste auf der durch index spezifizierten Leiste in dem durch barset spezifizierten Leistensatz loslässt.
Hinweis: Der entsprechende Handler ist onReleased.
Methode Dokumentation
Fügt eine durch barset angegebene Gruppe von Takten zur Taktreihe hinzu und übernimmt sie. Wenn der Satz null ist oder bereits zur Serie gehört, wird er nicht angehängt.
Gibt true zurück, wenn das Anhängen erfolgreich war.
Siehe auch insert().
Gibt das Bar-Set unter index zurück. Gibt null zurück, wenn der Index ungültig ist.
Barset at(int index) |
Gibt den durch index angegebenen Taktsatz aus der Serie zurück. Gibt andernfalls null zurück.
clear() |
Entfernt alle Balkensätze aus der Serie.
Gibt den Index des durch barset angegebenen Balkensatzes aus der Serie zurück. Gibt -1 zurück, falls nicht gefunden.
Fügt einen neuen Balkensatz mit label und values zu index hinzu. values kann eine Liste von realen Werten oder eine Liste von XYPoint Typen sein.
Wenn der Indexwert gleich oder kleiner als Null ist, wird die neue Taktmenge der Taktreihe vorangestellt. Ist der Indexwert gleich oder größer als die Anzahl der Taktsätze in der Taktreihe, wird der neue Taktsatz an die Taktreihe angehängt.
Siehe auch append().
Entfernt den durch barset angegebenen Balkensatz aus der Serie. Gibt bei Erfolg true zurück, andernfalls false.
Entfernt den durch index angegebenen Balkensatz aus der Serie. Gibt true zurück, wenn das Entfernen erfolgreich war, andernfalls false.
Entfernt einen Bereich von Taktsätzen, wie durch index und count angegeben. Der Aufruf durchläuft alle Gruppen, auch wenn das Entfernen einer Gruppe fehlschlägt.
Ersetzt alle aktuellen Balkengruppen vollständig durch sets. Die Größe muss nicht übereinstimmen. Gibt false zurück, wenn einer der Taktsätze in sets ungültig ist.
Ersetzt die durch oldSet angegebene Taktmenge durch newSet. Gibt true zurück, wenn das Entfernen erfolgreich war, andernfalls false. oldSet wird zerstört, wenn dies erfolgreich ist.
Ersetzt den Taktsatz an der durch index angegebenen Position aus der Serie und ersetzt ihn durch barset. Gibt im Erfolgsfall true zurück, andernfalls false.
© 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.
