Auf dieser Seite

AreaSeries QML Type

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

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

AbstractSeries

Status: Deprecated

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

Eigenschaften

Signale

Ausführliche Beschreibung

Eine Flächenreihe dient zur Darstellung quantitativer Daten. Sie basiert auf einer Linienreihe, wobei der Bereich zwischen den Begrenzungslinien farblich hervorgehoben wird. Der Typ „ LineSeries “ definiert die obere Begrenzung des Bereichs. Das Flächendiagramm wird standardmäßig so gezeichnet, dass der untere Rand des Darstellungsbereichs als untere Begrenzung dient. Anstelle des unteren Randes des Darstellungsbereichs 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 Grenze“ können irreführend sein, wenn der Wert der unteren Grenze größer ist als der der oberen Grenze. Entscheidend ist, dass der Bereich zwischen diesen beiden Begrenzungslinien ausgefüllt wird.

Flächen Diagramm mit der Anzahl der russischen, schwedischen und finnischen Spieler nach Jahr von 2000 bis 2011

Der folgende QML-Code 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 derselben Linienreihe sowohl zu einem Diagramm als auch zu einer Flächenreihe wird nicht unterstützt. Die als Begrenzungslinien verwendeten Reihen sollten ausschließlich für die Flächenreihe definiert werden.

Dokumentation zu den Eigenschaften

axisAngular : AbstractAxis

Die für die Reihe verwendete Winkelachse, die um die Polardiagrammansicht herum eingezeichnet ist.

Siehe auch axisX und PolarChartView.

axisRadial : AbstractAxis

Die für die Reihe verwendete Radialachse, die innerhalb der Polardiagrammansicht eingezeichnet ist.

Siehe auch axisY und PolarChartView.

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 Werteachse erstellt.

Siehe auch „ axisXTop “ und „ ValueAxis “.

axisXTop : AbstractAxis

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

Hinweis: Sie können entweder „ axisX “ oder „axisXTop“ angeben, jedoch nicht beides.

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 Werteachse erstellt.

Siehe auch „ axisYRight “ und „ ValueAxis “.

axisYRight : AbstractAxis

Die für die Reihe verwendete y-Achse, die in der Diagrammansicht nach rechts ausgerichtet ist.

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

Siehe auch „ axisY “.

borderColor : color

Farbe der Linien (Stift) der Serie.

borderWidth : real

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

brush : brush

Der Pinsel, mit dem die Linie für diese Serie gezeichnet wurde.

brushFilename : string

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

color : color

Füllfarbe (Pinsel) der Serie.

lowerSeries : LineSeries [read-only]

Die untere der beiden Linienreihen, die zur Definition der Grenzen der Flächenreihe verwendet werden.

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

pointLabelsClipping : bool

Legt die Beschneidung für Datenpunktbeschriftungen fest. Standardmäßig auf „True“ gesetzt. Die Beschriftungen am Rand des Darstellungsbereichs werden abgeschnitten, wenn die Beschneidung aktiviert ist.

Siehe auch „ pointLabelsVisible “.

pointLabelsColor : font

Legt die Farbe fest, die für die Beschriftungen der Datenpunkte verwendet wird. Standardmäßig entspricht die Farbe der Pinselfarbe, die im Design für Beschriftungen definiert ist.

Siehe auch pointLabelsFormat.

pointLabelsFont : font

Legt die Schriftart fest, die für die Beschriftungen der Datenpunkte verwendet wird.

Siehe auch „ pointLabelsFormat “.

pointLabelsFormat : string

Das Format, das für die Darstellung von Beschriftungen bei Zeitreihenpunkten 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 Festlegung der Grenzen von Flächenreihen verwendet werden.

Signal-Dokumentation

clicked(point point)

Dieses Signal wird ausgelöst, wenn der Benutzer einen Klick auf „ point “ auslöst, indem er in einem Flächendiagramm darauf klickt.

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

Hinweis: Der entsprechende Handler ist „ onClicked “.

Siehe auch „ pressed “, „ released “ und „ doubleClicked “.

doubleClicked(point point)

Dieses Signal wird ausgelöst, wenn der Benutzer durch Doppelklick auf „ point “ den ersten Klick in einem Flächendiagramm auslöst.

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

Hinweis: Der entsprechende Handler ist „ onDoubleClicked “.

Siehe auch „ pressed “, „ released “ und „ clicked “.

hovered(point point, bool state)

Dieses Signal wird ausgelöst, wenn der Benutzer den Mauszeiger über eine Reihe bewegt oder ihn von der Reihe wegbewegt. point gibt den Ursprung (die Koordinate) des Hover-Ereignisses an. state ist „ true “, wenn sich der Mauszeiger über der Reihe befindet, und wechselt zu „false“, wenn er von der Reihe wegbewegt wird.

Der entsprechende Signal-Handler ist onHovered.

Hinweis: Der zugehörige Handler ist „ onHovered “.

pressed(point point)

Dieses Signal wird ausgelöst, wenn der Benutzer in einem Flächendiagramm auf den unter point angegebenen Punkt klickt.

Der entsprechende Signal-Handler ist „ onPressed “.

Hinweis: Der entsprechende Handler lautet „ onPressed “.

Siehe auch „ clicked “, „ released “ und „ doubleClicked “.

released(point point)

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

Der entsprechende Signal-Handler lautet „ onReleased “.

Hinweis: Der entsprechende Handler ist „ onReleased “.

Siehe auch „ pressed “, „ clicked “ und „ doubleClicked “.

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