Back to Qt.io
Contact Us Blog Download Qt

AbstractBarSeries QML Type

Ein abstrakter übergeordneter Typ für alle Balkentypen. Mehr...

Import Statement: import QtCharts 2.8
In C++: QAbstractBarSeries
Inherits:

AbstractSeries

Inherited By:

BarSeries, HorizontalBarSeries, HorizontalPercentBarSeries, HorizontalStackedBarSeries, PercentBarSeries, and StackedBarSeries

Eigenschaften

Signale

Methoden

  • BarSet append(string label, VariantList values)
  • BarSet at(int index)
  • clear()
  • BarSet insert(int index, string label, VariantList values)
  • bool remove(BarSet barset)

Detaillierte Beschreibung

In Balkendiagrammen werden die Balken als Balkensätze definiert, die für jede Kategorie einen Datenwert enthalten. Die Position eines Balkens wird durch die Kategorie und seine Höhe durch den Datenwert bestimmt. Balkenserien, die mehrere Balkensätze enthalten, fassen Balken zusammen, die zur gleichen Kategorie gehören. Die Art und Weise, wie die Balken angezeigt werden, wird durch den für die Erstellung des Balkendiagramms gewählten Typ bestimmt: BarSeries StackedBarSeries , PercentBarSeries, HorizontalBarSeries, HorizontalStackedBarSeries, oder HorizontalPercentBarSeries.

Wenn für die Hauptachse des Balkendiagramms der Typ ValueAxis anstelle des Typs BarCategoryAxis verwendet wird, werden die Balken um den Indexwert der Kategorie gruppiert.

Der folgende QML-Codeausschnitt zeigt, wie man die Typen BarSeries und BarCategoryAxis verwendet, um ein einfaches Balkendiagramm zu erstellen:

ChartView {
    title: "Bar Chart"
    anchors.fill: parent
    legend.alignment: Qt.AlignBottom
    antialiasing: true

    BarSeries {
        id: mySeries
        axisX: BarCategoryAxis { categories: ["2007", "2008", "2009", "2010", "2011", "2012" ] }
        BarSet { label: "Bob"; values: [2, 2, 3, 4, 5, 6] }
        BarSet { label: "Susan"; values: [5, 1, 2, 4, 1, 7] }
        BarSet { label: "James"; values: [3, 5, 8, 13, 5, 8] }
    }
}


Dokumentation der Eigenschaft

axisX : AbstractAxis

Die für die Serie verwendete x-Achse. Wenn Sie sowohl axisX als auch axisXTop undefiniert lassen, wird eine BarCategoryAxis für die Serie erstellt.

Siehe auch axisXTop.


axisXTop : AbstractAxis

Die für die Serie verwendete x-Achse, die im oberen Bereich der Diagrammansicht gezeichnet wird.

Hinweis: Sie können nur entweder axisX oder axisXTop angeben, aber nicht beides.

Siehe auch axisX.


axisY : AbstractAxis

Die y-Achse, die für die Reihe verwendet wird. Wenn Sie sowohl axisY als auch axisYRight undefiniert lassen, wird eine ValueAxis für die Serie erstellt.

Siehe auch axisYRight.


axisYRight : AbstractAxis

Die für die Serie verwendete y-Achse, die auf der rechten Seite der Diagrammansicht gezeichnet wird.

Hinweis: Sie können nur entweder axisY oder axisYRight angeben, aber nicht beides.

Siehe auch axisY.


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.

Hinweis: Bei Verwendung des Typs BarSeries gibt dieser Wert die Breite einer Gruppe von Balken anstelle der eines einzelnen Balkens an.


count : int [read-only]

Die Anzahl der Balkengruppen in einer Balkenreihe.


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 QAbstractBarSeries::labelsFormat, labelsVisible, und labelsPosition.


labelsPosition : enumeration

Die Position der Datenwertbeschriftungen:

KonstanteBeschreibung
AbstractBarSeries.LabelsCenterDie Beschriftung befindet sich in der Mitte des Balkens.
AbstractBarSeries.LabelsInsideEndDas Etikett befindet sich oben innerhalb des Balkens.
AbstractBarSeries.LabelsInsideBaseDie Beschriftung befindet sich innerhalb des Balkens am unteren Rand.
AbstractBarSeries.LabelsOutsideEndDie 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.


Signal Dokumentation

barsetsAdded()

Dieses Signal wird ausgegeben, wenn Balkengruppen zur Serie hinzugefügt werden.

Der entsprechende Signalhandler ist onBarsetsAdded.

Hinweis: Der entsprechende Handler ist onBarsetsAdded.


barsetsRemoved()

Dieses Signal wird ausgegeben, wenn Taktsätze aus der Serie entfernt werden.

Der entsprechende Signalhandler ist onBarsetsRemoved.

Hinweis: Der entsprechende Handler ist onBarsetsRemoved.


clicked(int index, BarSet barset)

Dieses Signal wird ausgegeben, wenn der Benutzer den durch index angegebenen Takt in der durch barset angegebenen Taktgruppe anklickt.

Der entsprechende Signalhandler ist onClicked.

Hinweis: Der entsprechende Handler ist onClicked.


doubleClicked(int index, BarSet barset)

Dieses Signal wird ausgegeben, wenn der Benutzer einen Doppelklick auf den durch index angegebenen Balken in der durch barset angegebenen Balkengruppe ausführt.

Der entsprechende Signalhandler ist onDoubleClicked.

Hinweis: Der entsprechende Handler ist onDoubleClicked.


hovered(bool status, int index, BarSet barset)

Dieses Signal wird ausgegeben, wenn der Mauszeiger über die durch index angegebene Leiste in der durch barset angegebenen Leistengruppe bewegt wird. Wenn sich die Maus über den Balken bewegt, wird status zu true, und wenn sich die Maus wieder entfernt, wird sie zu false.

Der entsprechende Signalhandler ist onHovered.

Hinweis: Der entsprechende Handler ist onHovered.


pressed(int index, BarSet barset)

Dieses Signal wird ausgegeben, wenn der Benutzer auf den durch index angegebenen Balken in dem durch barset angegebenen Balkensatz klickt und die Maustaste gedrückt hält.

Der entsprechende Signalhandler ist onPressed.

Hinweis: Der entsprechende Handler ist onPressed.


released(int index, BarSet barset)

Dieses Signal wird ausgegeben, wenn der Benutzer die Maustaste auf dem durch index spezifizierten Balken in der durch barset spezifizierten Balkenmenge loslässt.

Der entsprechende Signalhandler ist onReleased.

Hinweis: Der entsprechende Handler ist onReleased.


Dokumentation der Methode

BarSet append(string label, VariantList values)

Fügt einen neuen Balkensatz mit label und values zum Index hinzu. values ist eine Liste von reellen Werten.

Zum Beispiel:

myBarSeries.append("set 1", [0, 0.2, 0.2, 0.5, 0.4, 1.5, 0.9]);

BarSet at(int index)

Gibt den Taktsatz mit index zurück. Gibt null zurück, wenn der Index ungültig ist.


clear()

Entfernt alle Balkensätze aus der Serie.


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 reellen Werten oder eine Liste von XYPoint Typen sein.

Wenn der Indexwert gleich oder kleiner als Null ist, wird der neue Taktsatz 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.


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