Auf dieser Seite

QAreaSeries Class

Die Klasse QAreaSeries stellt Daten in Flächendiagrammen dar. Mehr...

Kopfzeile: #include <QAreaSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
In QML: AreaSeries
Vererbt: QAbstractSeries

Eigenschaften

Öffentliche Funktionen

QColor borderColor() const
qreal borderWidth() const
QColor color() const
QQuickShapeGradient *gradient() const
bool isSelected() const
QXYSeries *lowerSeries() const
QColor selectedBorderColor() const
QColor selectedColor() const
QQuickShapeGradient *selectedGradient() const
void setBorderColor(QColor newBorderColor)
void setBorderWidth(qreal newBorderWidth)
void setColor(QColor newColor)
void setGradient(QQuickShapeGradient *newGradient)
void setLowerSeries(QXYSeries *newLowerSeries)
void setSelected(bool newSelected)
void setSelectedBorderColor(QColor newSelectedBorderColor)
void setSelectedColor(QColor newColor)
void setSelectedGradient(QQuickShapeGradient *newSelectedGradient)
void setUpperSeries(QXYSeries *newUpperSeries)
QXYSeries *upperSeries() const

Signale

void borderColorChanged(QColor newBorderColor)
void borderWidthChanged()
void colorChanged(QColor newColor)
void gradientChanged(QQuickShapeGradient *newGradient)
void lowerSeriesChanged()
void selectedBorderColorChanged(QColor newSelectedBorderColor)
void selectedChanged()
void selectedColorChanged(QColor newSelectedColor)
void selectedGradientChanged(QQuickShapeGradient *newGradient)
void upperSeriesChanged()

Detaillierte Beschreibung

Ein Flächendiagramm wird verwendet, um eine Fläche zu zeichnen, die aus Punkten besteht. Die Punkte werden durch zwei Reihen definiert: upperSeries und lowerSeries. Die Fläche zwischen den Reihen wird als Diagramm gezeichnet. Wenn nur upperSeries definiert ist, liegt die Fläche zwischen dem unteren Teil des Diagramms und der oberen Reihe.

Eigenschaft Dokumentation

borderColor : QColor

Diese Eigenschaft enthält die Farbe des Rahmens des Bereichs. Der Standardwert ist Qt::transparent, was bedeutet, dass die Farbe des Rahmens durch das Thema definiert ist.

Zugriffsfunktionen:

QColor borderColor() const
void setBorderColor(QColor newBorderColor)

Benachrichtigungssignal:

void borderColorChanged(QColor newBorderColor)

borderWidth : qreal

Diese Eigenschaft gibt die Breite der Linie an, die den Bereich umschließt. Der Standardwert ist -1, was bedeutet, dass die Breite des Rahmens durch das Thema definiert wird.

Zugriffsfunktionen:

qreal borderWidth() const
void setBorderWidth(qreal newBorderWidth)

Benachrichtigungssignal:

void borderWidthChanged()

color : QColor

Diese Eigenschaft enthält die Füllfarbe des Bereichs. Der Standardwert ist Qt::transparent, was bedeutet, dass die Farbe durch das Thema definiert ist.

Hinweis: Wenn gradient auf einen anderen Wert als null gesetzt ist, hat dieser Vorrang vor color. Der Wert color wird in diesem Fall ignoriert.

Zugriffsfunktionen:

QColor color() const
void setColor(QColor newColor)

Benachrichtigungssignal:

void colorChanged(QColor newColor)

[since 6.11] gradient : QQuickShapeGradient*

Diese Eigenschaft definiert den Füllgradienten. Standardmäßig ist kein Farbverlauf aktiviert und der Wert lautet null. In diesem Fall basiert die Füllung auf der Eigenschaft color.

Hinweis: Der Typ Farbverlauf kann hier nicht verwendet werden. Verwenden Sie stattdessen lieber einen der erweiterten Untertypen, wie LinearGradient.

Hinweis: Wird ein anderer Wert als null gewählt, hat gradient Vorrang vor color.

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

Zugriffsfunktionen:

QQuickShapeGradient *gradient() const
void setGradient(QQuickShapeGradient *newGradient)

Benachrichtigungssignal:

void gradientChanged(QQuickShapeGradient *newGradient)

lowerSeries : QXYSeries*

Legt die untere Begrenzung des Bereichs fest. Ist dieser Wert Null, gilt der Boden des Diagramms als untere Grenze.

Zugriffsfunktionen:

QXYSeries *lowerSeries() const
void setLowerSeries(QXYSeries *newLowerSeries)

Benachrichtigungssignal:

void lowerSeriesChanged()

selected : bool

Legt diesen Bereich als ausgewählt fest. Der Standardwert ist false.

Zugriffsfunktionen:

bool isSelected() const
void setSelected(bool newSelected)

Melder-Signal:

void selectedChanged()

selectedBorderColor : QColor

Diese Eigenschaft enthält die Farbe des Rahmens des Bereichs, wenn dieser ausgewählt ist. Der Standardwert ist Qt::transparent, d.h. die Farbe des ausgewählten Rahmens wird durch das Thema definiert.

Zugriffsfunktionen:

QColor selectedBorderColor() const
void setSelectedBorderColor(QColor newSelectedBorderColor)

Benachrichtigungssignal:

void selectedBorderColorChanged(QColor newSelectedBorderColor)

selectedColor : QColor

Diese Eigenschaft enthält die Füllfarbe des Bereichs, wenn dieser ausgewählt ist. Der Standardwert ist Qt::transparent, d. h. die ausgewählte Farbe wird durch das Thema definiert.

Hinweis: Wenn selectedGradient auf einen anderen Wert als null gesetzt ist, hat dieser Vorrang vor selectedColor. Der Wert selectedColor wird in diesem Fall ignoriert.

Zugriffsfunktionen:

QColor selectedColor() const
void setSelectedColor(QColor newColor)

Benachrichtigungssignal:

void selectedColorChanged(QColor newSelectedColor)

[since 6.11] selectedGradient : QQuickShapeGradient*

Diese Eigenschaft legt den Füllgradienten des Bereichs fest, wenn dieser ausgewählt ist. Standardmäßig ist kein Farbverlauf aktiviert und der Wert lautet null. In diesem Fall basiert die Füllung auf der Eigenschaft selectedColor.

Hinweis: Der Typ Farbverlauf kann hier nicht verwendet werden. Verwenden Sie stattdessen lieber einen der erweiterten Untertypen, wie LinearGradient.

Hinweis: Wird ein anderer Wert als null gewählt, hat selectedGradient Vorrang vor selectedColor.

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

Zugriffsfunktionen:

QQuickShapeGradient *selectedGradient() const
void setSelectedGradient(QQuickShapeGradient *newSelectedGradient)

Benachrichtigungssignal:

void selectedGradientChanged(QQuickShapeGradient *newGradient)

upperSeries : QXYSeries*

Legt die obere Begrenzung des Bereichs fest. Wenn dieser Wert Null ist, wird kein Bereich gezeichnet.

Zugriffsfunktionen:

QXYSeries *upperSeries() const
void setUpperSeries(QXYSeries *newUpperSeries)

Melder-Signal:

void upperSeriesChanged()

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