AbstractBarSeries QML Type

Ein abstrakter übergeordneter Typ für alle Bar-Serien-Typen. Mehr...

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• axisX : AbstractAxis
• axisXTop : AbstractAxis
• axisY : AbstractAxis
• axisYRight : AbstractAxis
• barWidth : real
• count : int
• labelsAngle : real
• labelsFormat : string
• labelsPosition : enumeration
• labelsPrecision : real
• labelsVisible : bool

Signale

• barsetsAdded()
• barsetsRemoved()
• clicked(int index, BarSet barset)
• doubleClicked(int index, BarSet barset)
• hovered(bool status, int index, BarSet barset)
• pressed(int index, BarSet barset)
• released(int index, BarSet barset)

Methoden

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

Ausführliche Beschreibung

In Balkendiagrammen werden Balken als Balkensätze definiert, die für jede Kategorie einen Datenwert enthalten. Die Position eines Balkens wird durch die Kategorie bestimmt, seine Höhe durch den Datenwert. Balkenreihen, die mehrere Balkensätze enthalten, fassen Balken zusammen, die zur selben Kategorie gehören. Die Art und Weise, wie die Balken dargestellt werden, hängt vom gewählten Typ bei der Erstellung des Balkendiagramms ab: „ BarSeries “, „ StackedBarSeries “, „ PercentBarSeries “, „ HorizontalBarSeries “, „ HorizontalStackedBarSeries “ oder „ HorizontalPercentBarSeries “.

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

Der folgende QML-Codeausschnitt zeigt, wie man mit den Typen „ BarSeries “ und „ BarCategoryAxis “ ein einfaches Balkendiagramm erstellt:

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 zu den Eigenschaften

axisX : AbstractAxis

Die für die Reihe verwendete x-Achse. Wenn Sie sowohl „axisX“ als auch „ axisXTop “ nicht definieren, wird für die Reihe eine „BarCategoryAxis“ erstellt.

Siehe auch „ axisXTop “.

axisXTop : AbstractAxis

Die für die Reihe verwendete x-Achse, die über der Diagrammansicht eingezeichnet wird.

Siehe auch „ axisX “.

axisY : AbstractAxis

Die für die Reihe verwendete y-Achse. Wenn Sie sowohl „axisY“ als auch „ axisYRight “ nicht definieren, wird für die Reihe eine „ValueAxis“ erstellt.

Siehe auch „ axisYRight “.

axisYRight : AbstractAxis

Die für die Reihe verwendete y-Achse, die rechts neben der Diagrammansicht eingezeichnet ist.

Siehe auch „ axisY “.

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.

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

labelsPosition : enumeration

Die Position der Datenwertbeschriftungen:

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.

Signal-Dokumentation

barsetsAdded()

Dieses Signal wird ausgelöst, wenn Balkensätze zur Serie hinzugefügt werden.

Der zugehörige Signal-Handler lautet onBarsetsAdded.

barsetsRemoved()

Dieses Signal wird ausgelöst, wenn Balkensätze aus der Serie entfernt werden.

Der zugehörige Signal-Handler lautet „ onBarsetsRemoved “.

clicked(int index, BarSet barset)

Dieses Signal wird ausgelöst, wenn der Benutzer auf den Balken klickt, der durch index in dem durch barset festgelegten Balkensatz angegeben ist.

Der zugehörige Signal-Handler ist „ onClicked “.

doubleClicked(int index, BarSet barset)

Dieses Signal wird ausgelöst, wenn der Benutzer auf die durch index angegebene Leiste in dem durch barset angegebenen Leisten-Set doppelklickt.

Der zugehörige Signal-Handler ist onDoubleClicked.

hovered(bool status, int index, BarSet barset)

Dieses Signal wird ausgelöst, wenn der Mauszeiger über den durch index angegebenen Balken in dem durch barset festgelegten Balkensatz bewegt wird. Wenn der Mauszeiger über den Balken bewegt wird, wechselt status zu true, und wenn der Mauszeiger wieder wegbewegt wird, wechselt er zu false.

Der zugehörige Signal-Handler lautet „ onHovered “.

pressed(int index, BarSet barset)

Dieses Signal wird ausgelöst, 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 Signal-Handler ist „ onPressed “.

released(int index, BarSet barset)

Dieses Signal wird ausgelöst, wenn der Benutzer den Mausklick auf dem durch index angegebenen Balken innerhalb des durch barset angegebenen Balkensatzes aufhebt.

Der zugehörige Signal-Handler lautet „ onReleased “.

Methodendokumentation

BarSet append(string label, VariantList values)

Fügt dem Index einen neuen Balkensatz mit den Werten „ label “ und „ values “ hinzu. „ values “ ist eine Liste reeller Werte.

Beispiel:

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

BarSet at(int index)

Gibt den unter index festgelegten Balken zurück. Gibt null zurück, wenn der Index ungültig ist.

void clear()

Entfernt alle Stangensätze aus der Serie.

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

Fügt der Bar-Reihe „ index “ einen neuen Bar-Satz mit den Werten „ label “ und „ values “ hinzu. „ values “ kann eine Liste von reellen Werten oder eine Liste von Objekten vom Typ „XYPoint“ sein.

Ist der Indexwert gleich oder kleiner als Null, wird der neue Balkensatz an den Anfang der Balkenreihe angefügt. Ist der Indexwert gleich oder größer als die Anzahl der Balkensätze in der Balkenreihe, wird der neue Balkensatz an das Ende der Balkenreihe angehängt.

Siehe auch „ append()“.

bool remove(BarSet barset)

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