Back to Qt.io
Contact Us Blog Download Qt

AreaSeries QML Type

Stellt Daten in Flächendiagrammen dar. Mehr...

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

AbstractSeries

Eigenschaften

Signale

Detaillierte Beschreibung

Eine Flächenreihe wird verwendet, um quantitative Daten darzustellen. Sie basiert auf einer Linienreihe, wobei die Fläche zwischen den Begrenzungslinien farblich hervorgehoben wird. Der Typ LineSeries definiert die obere Begrenzung des Bereichs. Das Flächendiagramm wird standardmäßig mit dem unteren Rand des Plotbereichs als untere Begrenzung gezeichnet. Anstelle des Bodens des Plotbereichs kann die untere Begrenzung auch durch eine andere Linie festgelegt werden. In diesem Fall sollte die AreaSeries zwei LineSeries Typen verwenden.

Hinweis: Die Begriffe obere und untere Begrenzung können irreführend sein, wenn der Wert der unteren Begrenzung größer ist als der der oberen Begrenzung. Die Hauptsache ist, dass der Bereich zwischen diesen beiden Begrenzungslinien gefüllt wird.

Die folgende QML zeigt, wie man ein einfaches Flächendiagramm erstellt:

ChartView {
    title: "NHL All-Star Team Players"
    anchors.fill: parent
    antialiasing: true

    // Define x-axis to be used with the series instead of default one
    ValueAxis {
        id: valueAxis
        min: 2000
        max: 2011
        tickCount: 12
        labelFormat: "%.0f"
    }

    AreaSeries {
        name: "Russian"
        axisX: valueAxis
        upperSeries: LineSeries {
            XYPoint { x: 2000; y: 1 }
            XYPoint { x: 2001; y: 1 }
            XYPoint { x: 2002; y: 1 }
            XYPoint { x: 2003; y: 1 }
            XYPoint { x: 2004; y: 1 }
            XYPoint { x: 2005; y: 0 }
            XYPoint { x: 2006; y: 1 }
            XYPoint { x: 2007; y: 1 }
            XYPoint { x: 2008; y: 4 }
            XYPoint { x: 2009; y: 3 }
            XYPoint { x: 2010; y: 2 }
            XYPoint { x: 2011; y: 1 }
        }
    }

Hinweis: Das Hinzufügen der gleichen Linienserie zu einem Diagramm und einer Flächenreihe wird nicht unterstützt. Die als Begrenzungslinien verwendeten Serien sollten nur für die Flächenserie definiert werden.

Dokumentation der Eigenschaft

axisAngular : AbstractAxis

Die für die Serie verwendete Winkelachse, die um die Polardiagrammansicht gezeichnet wird.

Siehe auch axisX und PolarChartView.


axisRadial : AbstractAxis

Die für die Reihe verwendete Radialachse, die innerhalb der Polardiagrammansicht gezeichnet wird.

Siehe auch axisY und PolarChartView.


axisX : AbstractAxis

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

Siehe auch axisXTop und ValueAxis.


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, nicht beide.

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 Wertachse für die Serie erstellt.

Siehe auch axisYRight und ValueAxis.


axisYRight : AbstractAxis

Die für die Serie verwendete y-Achse, die in der Diagrammansicht nach rechts gezeichnet wird.

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

Siehe auch axisY.


borderColor : color

Die Farbe der Linie (Stift) der Serie.


borderWidth : real

Die Breite der Umrandungslinie. Standardmäßig beträgt die Breite 2,0.


brush : brush

Der Pinsel, der zum Zeichnen der Linie für diese Serie verwendet wird.


brushFilename : QString

Der Name der Datei, die als Pinselbild für die Serie verwendet wird.


color : color

Farbe der Füllung (Pinsel) der Serie.


lowerSeries : LineSeries [read-only]

Die untere der beiden Linienserien, die zur Festlegung der Grenzen der Flächenserien verwendet werden.

Hinweis: Wenn AreaSeries ohne lowerSeries erstellt wurde, ist dieser Wert null.


pointLabelsClipping : bool

Definiert den Ausschnitt für Datenpunktbeschriftungen. Standardmäßig True. Die Beschriftungen am Rand des Plotbereichs werden abgeschnitten, wenn die Beschneidung aktiviert ist.

Siehe auch pointLabelsVisible.


pointLabelsColor : font

Legt die Farbe für die Datenpunktbeschriftungen fest. Standardmäßig ist die Farbe die Farbe des Pinsels, der für Beschriftungen im Thema definiert ist.

Siehe auch pointLabelsFormat.


pointLabelsFont : font

Legt die Schriftart für die Datenpunktbeschriftungen fest.

Siehe auch pointLabelsFormat.


pointLabelsFormat : string

Das Format, das für die Anzeige von Beschriftungen mit Serienpunkten verwendet wird.

Siehe auch QAreaSeries::pointLabelsFormat, pointLabelsVisible, pointLabelsFont, und pointLabelsColor.


pointLabelsVisible : bool

Legt die Sichtbarkeit von Datenpunktbeschriftungen fest.

Siehe auch pointLabelsFormat und pointLabelsClipping.


upperSeries : LineSeries [read-only]

Die obere der beiden Linienreihen, die zur Definition der Bereichsreihengrenzen verwendet werden.


Signal Dokumentation

clicked(point point)

Dieses Signal wird ausgegeben, wenn der Benutzer einen Druck auf point auslöst, indem er in einem Flächendiagramm darauf klickt.

Der entsprechende Signalhandler ist onClicked.

Hinweis: Der entsprechende Handler ist onClicked.

Siehe auch pressed, released, und doubleClicked.


doubleClicked(point point)

Dieses Signal wird ausgegeben, wenn der Benutzer den ersten Druck in einem Flächendiagramm durch einen Doppelklick auf point auslöst.

Der entsprechende Signal-Handler ist onDoubleClicked.

Hinweis: Der entsprechende Handler ist onDoubleClicked.

Siehe auch pressed, released, und clicked.


hovered(point point, bool state)

Dieses Signal wird ausgegeben, wenn der Benutzer den Mauszeiger über einer Reihe schwebt oder ihn von der Reihe wegbewegt. point zeigt den Ursprung (Koordinate) des Schwebeereignisses an. state ist true, wenn der Mauszeiger über der Reihe schwebt und wird falsch, wenn er sich von der Reihe wegbewegt.

Der entsprechende Signalhandler ist onHovered.

Hinweis: Der entsprechende Handler ist onHovered.


pressed(point point)

Dieses Signal wird ausgegeben, wenn der Benutzer in einem Flächendiagramm auf den durch point angegebenen Punkt drückt.

Der entsprechende Signalhandler ist onPressed.

Hinweis: Der entsprechende Handler ist onPressed.

Siehe auch clicked, released, und doubleClicked.


released(point point)

Dieses Signal wird ausgegeben, wenn der Benutzer einen Druck loslässt, der auf point in einem Flächendiagramm ausgelöst wurde.

Der entsprechende Signalhandler ist onReleased.

Hinweis: Der entsprechende Handler ist onReleased.

Siehe auch pressed, clicked, und doubleClicked.


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