AreaSeries QML Type
Stellt Daten in Flächendiagrammen dar. Mehr...
| Import Statement: | import QtGraphs |
| In C++: | QAreaSeries |
| Inherits: |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- „AreaSeries“ ist Teil der „Qt Graphs “-QML-Typen für 2D.
Eigenschaften
- borderColor : color
- borderWidth : real
- color : color
- gradient : ShapeGradient
(since 6.11) - lowerSeries : XYSeries
- selected : bool
- selectedBorderColor : color
- selectedColor : color
- selectedGradient : ShapeGradient
(since 6.11) - upperSeries : XYSeries
Signale
- borderColorChanged(color newBorderColor)
- borderWidthChanged()
- clicked(point point)
- colorChanged(color newColor)
- doubleClicked(point point)
- gradientChanged()
(since 6.11) - lowerSeriesChanged()
- pressed(point point)
- released(point point)
- selectedBorderColorChanged(color newSelectedBorderColor)
- selectedChanged()
- selectedColorChanged(color newSelectedColor)
- selectedGradientChanged()
(since 6.11) - upperSeriesChanged()
Ausführliche Beschreibung
Ein Flächendiagramm wird verwendet, um eine aus Punkten bestehende Fläche darzustellen. Die Punkte werden durch zwei Reihen definiert: „ upperSeries “ und „ lowerSeries “. Die Fläche zwischen den Reihen wird als Diagramm dargestellt. Ist nur die „ upperSeries “ definiert, befindet sich die Fläche zwischen dem unteren Rand des Diagramms und der oberen Reihe.
Dokumentation zu den Eigenschaften
borderColor : color
Die Rahmenfarbe des Bereichs. Der Standardwert lautet „ transparent “, was bedeutet, dass die Rahmenfarbe durch das Design vorgegeben wird.
borderWidth : real
Die Breite der Linie, die den Bereich umrandet. Der Standardwert lautet „ -1 “, was bedeutet, dass die Rahmenbreite durch das Theme festgelegt wird.
color : color
Die Füllfarbe des Bereichs. Der Standardwert ist „ transparent “, was bedeutet, dass die Farbe durch das Design vorgegeben wird.
Hinweis: Wenn „ gradient “ auf einen anderen Wert als „ null “ gesetzt ist, haben diese Einstellungen Vorrang vor „ color “. Die „ color “ werden in diesem Fall ignoriert.
gradient : ShapeGradient [since 6.11]
Diese Eigenschaft definiert den Füllverlauf. Standardmäßig ist kein Verlauf aktiviert und der Wert lautet „ null “. In diesem Fall richtet sich die Füllung nach der Eigenschaft „ color “.
Hinweis: Der Typ „Gradient“ kann hier nicht verwendet werden. Verwenden Sie stattdessen lieber einen der erweiterten Untertypen, wie beispielsweise „ LinearGradient “.
Hinweis: Wenn ein anderer Wert als „ null “ festgelegt wird, hat die Eigenschaft „ gradient “ Vorrang vor „ color “.
Diese Eigenschaft wurde in Qt 6.11 eingeführt.
lowerSeries : XYSeries
Legt die untere Grenze des Bereichs fest. Ist dieser Wert null, gilt die Unterkante des Diagramms als untere Grenze.
selected : bool
Legt diesen Bereich als ausgewählten Bereich fest. Der Standardwert lautet „ false “.
selectedBorderColor : color
Die Rahmenfarbe des Bereichs, wenn dieser ausgewählt ist. Der Standardwert lautet „ transparent “, was bedeutet, dass die Rahmenfarbe bei Auswahl durch das Design vorgegeben wird.
selectedColor : color
Die Füllfarbe des Bereichs bei Auswahl. Der Standardwert ist „ transparent “, was bedeutet, dass die ausgewählte Farbe durch das Design vorgegeben wird.
Hinweis: Wenn „ selectedGradient “ auf einen anderen Wert als „ null “ gesetzt ist, haben diese Einstellungen Vorrang vor „ selectedColor “. Die „ selectedColor “ werden in diesem Fall ignoriert.
selectedGradient : ShapeGradient [since 6.11]
Diese Eigenschaft definiert den Füllverlauf des Bereichs, wenn dieser ausgewählt ist. Standardmäßig ist kein Verlauf aktiviert und der Wert lautet „ null “. In diesem Fall richtet sich die Füllung nach der Eigenschaft „ selectedColor “.
Hinweis: Der Typ „Gradient“ kann hier nicht verwendet werden. Verwenden Sie stattdessen lieber einen der erweiterten Untertypen, wie z. B. „ LinearGradient “.
Hinweis: Wenn ein anderer Wert als „ null “ festgelegt wird, hat die Eigenschaft „ selectedGradient “ Vorrang vor „ selectedColor “.
Diese Eigenschaft wurde in Qt 6.11 eingeführt.
upperSeries : XYSeries
Legt die obere Grenze des Bereichs fest. Ist dieser Wert null, wird kein Bereich gezeichnet.
Signal-Dokumentation
borderColorChanged(color newBorderColor)
Dieses Signal wird ausgelöst, wenn sich die Farbe des Bereichsrandes auf newBorderColor ändert.
Hinweis: Der entsprechende Handler lautet „ onBorderColorChanged “.
borderWidthChanged()
Dieses Signal wird ausgelöst, wenn sich die Breite des Bereichsrandes ändert.
Hinweis: Der entsprechende Handler lautet „ onBorderWidthChanged “.
clicked(point point)
Dieses Signal wird ausgelöst, wenn der Benutzer auf einen Bereichsgraphen klickt oder tippt. Der point gibt die Position an, an der das Ereignis ausgelöst wurde.
Hinweis: Der entsprechende Handler ist „ onClicked “.
colorChanged(color newColor)
Dieses Signal wird ausgelöst, wenn sich der Bereich color auf newColor ändert.
Hinweis: Der entsprechende Handler lautet onColorChanged.
doubleClicked(point point)
Dieses Signal wird ausgelöst, wenn der Benutzer auf ein Flächendiagramm doppelklickt oder zweimal darauf tippt. Die Variable „ point “ gibt die Position an, an der das Ereignis ausgelöst wurde. Dieses Signal tritt immer nach dem Signal „ clicked “ auf.
Hinweis: Der entsprechende Handler ist „ onDoubleClicked “.
[since 6.11] gradientChanged()
Dieses Signal wird ausgegeben, wenn sich der Gradient ändert.
Hinweis: Der entsprechende Handler lautet „ onGradientChanged “.
Dieses Signal wurde in Qt 6.11 eingeführt.
lowerSeriesChanged()
Dieses Signal wird ausgegeben, wenn sich die untere Reihe ändert.
Hinweis: Der entsprechende Handler lautet „ onLowerSeriesChanged “.
pressed(point point)
Dieses Signal wird ausgelöst, wenn der Benutzer auf den Flächendiagrammbereich klickt oder tippt und die Maustaste oder Geste gedrückt hält. Der point gibt die Position an, an der das Ereignis ausgelöst wurde.
Hinweis: Der entsprechende Handler ist „ onPressed “.
released(point point)
Dieses Signal wird ausgelöst, wenn der Benutzer einen gedrückten Mausklick oder ein Antippen loslässt. Der „ point “ gibt die Position an, an der das Ereignis ausgelöst wurde.
Hinweis: Der entsprechende Handler ist „ onReleased “.
selectedBorderColorChanged(color newSelectedBorderColor)
Dieses Signal wird ausgelöst, wenn sich die Rahmenfarbe eines ausgewählten Bereichs auf newSelectedBorderColor ändert.
Hinweis: Der entsprechende Handler lautet „ onSelectedBorderColorChanged “.
selectedChanged()
Dieses Signal wird ausgelöst, wenn der aktuelle Bereich ausgewählt wird.
Hinweis: Der entsprechende Handler lautet „ onSelectedChanged “.
selectedColorChanged(color newSelectedColor)
Dieses Signal wird ausgelöst, wenn sich die Farbe eines ausgewählten Bereichs zu „ newSelectedColor “ ändert.
Hinweis: Der entsprechende Handler ist „ onSelectedColorChanged “.
[since 6.11] selectedGradientChanged()
Dieses Signal wird ausgegeben, wenn sich der Gradient eines ausgewählten Bereichs ändert.
Hinweis: Der entsprechende Handler lautet „ onSelectedGradientChanged “.
Dieses Signal wurde in Qt 6.11 eingeführt.
upperSeriesChanged()
Dieses Signal wird ausgegeben, wenn sich die obere Reihe ändert.
Hinweis: Der entsprechende Handler lautet „ onUpperSeriesChanged “.
© 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.
