AbstractBarSeries QML Type

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

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

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] }
    }
}

Eigenschaft Dokumentation

axisX : AbstractAxis

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

Siehe auch axisXTop.

axisXTop : AbstractAxis

Die für die Serie verwendete x-Achse, die oben in der Diagrammansicht gezeichnet wird.

Siehe auch axisX.

axisY : AbstractAxis

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

Siehe auch axisYRight.

axisYRight : AbstractAxis

Die für die Reihe verwendete y-Achse, die rechts von der Diagrammansicht gezeichnet wird.

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.

count : int [read-only]

Die Anzahl der Taktsätze in einer Taktreihe.

labelsAngle : real

Der Winkel der Wertelabels in Grad.

labelsFormat : string

Das Format, das für die Anzeige 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 signifikanter Ziffern, die in den Wertelabels angezeigt werden.

Der Standardwert ist 6.

labelsVisible : bool

Die Sichtbarkeit der Beschriftungen in einer Balkenreihe.

Signal-Dokumentation

barsetsAdded()

Dieses Signal wird ausgegeben, wenn der Reihe Takte hinzugefügt werden.

Der entsprechende Signalhandler ist onBarsetsAdded.

barsetsRemoved()

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

Der entsprechende Signalhandler ist onBarsetsRemoved.

clicked(int index, BarSet barset)

Dieses Signal wird ausgegeben, wenn der Benutzer auf den durch index angegebenen Balken im durch barset angegebenen Balkensatz klickt.

Der entsprechende Signalhandler 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 Balkenmenge ausführt.

Der entsprechende Signalhandler ist onDoubleClicked.

hovered(bool status, int index, BarSet barset)

Dieses Signal wird ausgegeben, wenn der Mauszeiger über den durch index angegebenen Balken in dem durch barset angegebenen Balkensatz 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.

pressed(int index, BarSet barset)

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

Der entsprechende Signalhandler ist onPressed.

released(int index, BarSet barset)

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

Der entsprechende Signalhandler ist onReleased.

Dokumentation der Methode

BarSet append(string label, VariantList values)

Fügt einen neuen Taktsatz mit label und values zum Index hinzu. values ist eine Liste von realen 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 unter index eingestellten Balken zurück. Gibt null zurück, wenn der Index nicht gültig ist.

void clear()

Entfernt alle Taktsätze aus der Serie.

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

Fügt eine neue Taktreihe 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 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 Taktsatz aus der Reihe. Gibt bei Erfolg true zurück, andernfalls false.