BarSeries QML Type

Stellt Daten in Balkendiagrammen dar. Mehr...

Import Statement:	`import QtGraphs`
In C++:	QBarSeries
Inherits:	AbstractSeries

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()

Methoden

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.

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".

barSets : list<BarSet> [read-only]

Eine Liste der zur Serie hinzugefügten Sets.

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.

borderColors : list<color>

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 [read-only]

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`	Die Beschriftung 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.

seriesColors : list<color>

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 der Serie Balkensätze 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.

Dokumentation der Methode

BarSet at(int index)

Gibt den Taktsatz 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.

int find(BarSet barset)

Gibt den Index des durch barset angegebenen Balkensatzes aus der Serie zurück. Gibt -1 zurück, falls nicht gefunden.

BarSet insert(int index, string label, VariantList values)

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().

bool remove(BarSet barset)

Entfernt den durch barset angegebenen Balkensatz aus der Serie. Gibt bei Erfolg true zurück, andernfalls false.

bool remove(int index)

Entfernt den durch index angegebenen Balkensatz aus der Serie. Gibt true zurück, wenn das Entfernen erfolgreich war, andernfalls false.

removeMultiple(int index, int count)

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.

bool replace(list<BarSet> sets)

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.

bool replace(BarSet oldSet, BarSet newSet)

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.

bool replace(int index, BarSet barset)

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.