AreaSeries QML Type
Stellt Daten in Flächendiagrammen dar. Mehr...
| Import Statement: | import QtCharts 2.12 |
| In C++: | QAreaSeries |
| Inherits: | |
| Status: | Deprecated |
Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
- axisAngular : AbstractAxis
- axisRadial : AbstractAxis
- axisX : AbstractAxis
- axisXTop : AbstractAxis
- axisY : AbstractAxis
- axisYRight : AbstractAxis
- borderColor : color
- borderWidth : real
- brush : brush
- brushFilename : string
- color : color
- lowerSeries : LineSeries
- pointLabelsClipping : bool
- pointLabelsColor : font
- pointLabelsFont : font
- pointLabelsFormat : string
- pointLabelsVisible : bool
- upperSeries : LineSeries
Signale
- clicked(point point)
- doubleClicked(point point)
- hovered(point point, bool state)
- pressed(point point)
- released(point point)
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.

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.