Back to Qt.io
Contact Us Blog Download Qt

QAreaSeries Class

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

Header: #include <QAreaSeries>
In QML: AreaSeries
Inherits: QAbstractSeries

Eigenschaften

Öffentliche Funktionen

QAreaSeries(QObject *parent = nullptr)
QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = nullptr)
virtual ~QAreaSeries()
QColor borderColor() const
QBrush brush() const
QColor color() const
QLineSeries *lowerSeries() const
QPen pen() const
bool pointLabelsClipping() const
QColor pointLabelsColor() const
QFont pointLabelsFont() const
QString pointLabelsFormat() const
bool pointLabelsVisible() const
bool pointsVisible() const
void setBorderColor(const QColor &color)
void setBrush(const QBrush &brush)
void setColor(const QColor &color)
void setLowerSeries(QLineSeries *series)
void setPen(const QPen &pen)
void setPointLabelsClipping(bool enabled = true)
void setPointLabelsColor(const QColor &color)
void setPointLabelsFont(const QFont &font)
void setPointLabelsFormat(const QString &format)
void setPointLabelsVisible(bool visible = true)
void setPointsVisible(bool visible = true)
void setUpperSeries(QLineSeries *series)
QLineSeries *upperSeries() const

Reimplementierte öffentliche Funktionen

virtual QAbstractSeries::SeriesType type() const override

Signale

void borderColorChanged(QColor color)
void clicked(const QPointF &point)
void colorChanged(QColor color)
void doubleClicked(const QPointF &point)
void hovered(const QPointF &point, bool state)
void pointLabelsClippingChanged(bool clipping)
void pointLabelsColorChanged(const QColor &color)
void pointLabelsFontChanged(const QFont &font)
void pointLabelsFormatChanged(const QString &format)
void pointLabelsVisibilityChanged(bool visible)
void pressed(const QPointF &point)
void released(const QPointF &point)

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. Da die Bereichsreihe auf der Linienreihe basiert, benötigt der QAreaSeries-Konstruktor eine QLineSeries -Instanz, die die obere Begrenzung des Bereichs definiert. 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 QAreaSeries mit zwei QLineSeries Instanzen initialisiert werden.

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. Die Hauptsache ist, dass der Bereich zwischen diesen beiden Begrenzungslinien gefüllt wird.

In der Galerie Diagramme mit Widgets erfahren Sie, wie Sie ein einfaches Flächendiagramm erstellen können.

Dokumentation der Eigenschaft

borderColor : QColor

Diese Eigenschaft enthält die Farbe der Linie (des Stifts) in der Serie. Dies ist eine praktische Eigenschaft, um die Farbe des Stifts zu ändern.

Zugriffsfunktionen:

QColor borderColor() const
void setBorderColor(const QColor &color)

Benachrichtigungssignal:

void borderColorChanged(QColor color)

Siehe auch QAreaSeries::pen().

color : QColor

Diese Eigenschaft enthält die Füllfarbe (Pinsel) der Serie. Dies ist eine praktische Eigenschaft, um die Farbe des Pinsels zu ändern.

Zugriffsfunktionen:

QColor color() const
void setColor(const QColor &color)

Benachrichtigungssignal:

void colorChanged(QColor color)

Siehe auch QAreaSeries::brush().

[read-only] lowerSeries : QLineSeries* const

Diese Eigenschaft enthält die untere der beiden Linienreihen, die zur Festlegung der Grenzen der Gebietsreihen verwendet werden.

Hinweis: Wenn QAreaSeries ohne lowerSeries konstruiert wurde, ist diese Eigenschaft null.

Zugriffsfunktionen:

QLineSeries *lowerSeries() const

pointLabelsClipping : bool

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

Zugriffsfunktionen:

bool pointLabelsClipping() const
void setPointLabelsClipping(bool enabled = true)

Benachrichtigungssignal:

void pointLabelsClippingChanged(bool clipping)

Siehe auch pointLabelsVisible.

pointLabelsColor : QColor

Diese Eigenschaft enthält die Farbe, die für Datenpunktbeschriftungen verwendet wird. Standardmäßig ist die Farbe die Farbe des Pinsels, der im Thema für Beschriftungen definiert ist.

Zugriffsfunktionen:

QColor pointLabelsColor() const
void setPointLabelsColor(const QColor &color)

Melder-Signal:

void pointLabelsColorChanged(const QColor &color)

Siehe auch QAreaSeries::pointLabelsFormat.

pointLabelsFont : QFont

Diese Eigenschaft enthält die Schriftart, die für Datenpunktbeschriftungen verwendet wird.

Zugriffsfunktionen:

QFont pointLabelsFont() const
void setPointLabelsFont(const QFont &font)

Melder-Signal:

void pointLabelsFontChanged(const QFont &font)

Siehe auch QAreaSeries::pointLabelsFormat.

pointLabelsFormat : QString

Diese Eigenschaft enthält das Format, das für die Anzeige von Beschriftungen mit Serienpunkten verwendet wird.

QAreaSeries unterstützt die folgenden Format-Tags:

@xPointDer x-Wert des Datenpunkts
@yPointDer y-Wert des Datenpunkts

Die folgende Verwendung der Format-Tags würde beispielsweise Beschriftungen erzeugen, bei denen der Datenpunkt (x, y) in Klammern und durch ein Komma getrennt angezeigt wird:

series->setPointLabelsFormat("(@xPoint, @yPoint)");

Standardmäßig ist das Beschriftungsformat auf @xPoint, @yPoint eingestellt. Die Beschriftungen werden auf der Plotfläche angezeigt, während Beschriftungen am Rand der Plotfläche abgeschnitten werden. Wenn die Punkte nahe beieinander liegen, können sich die Beschriftungen überlappen.

Zugriffsfunktionen:

QString pointLabelsFormat() const
void setPointLabelsFormat(const QString &format)

Melder-Signal:

void pointLabelsFormatChanged(const QString &format)

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

pointLabelsVisible : bool

Diese Eigenschaft bestimmt die Sichtbarkeit von Datenpunktbeschriftungen. Standardmäßig ist sie falsch.

Zugriffsfunktionen:

bool pointLabelsVisible() const
void setPointLabelsVisible(bool visible = true)

Melder-Signal:

void pointLabelsVisibilityChanged(bool visible)

Siehe auch QAreaSeries::pointLabelsFormat und QAreaSeries::pointLabelsClipping.

[read-only] upperSeries : QLineSeries* const

Diese Eigenschaft enthält die obere der beiden Linienreihen, die zur Festlegung der Grenzen der Gebietsreihen verwendet werden.

Zugriffsfunktionen:

QLineSeries *upperSeries() const

Dokumentation der Mitgliedsfunktionen

[explicit] QAreaSeries::QAreaSeries(QObject *parent = nullptr)

Konstruiert ein Flächenreihenobjekt ohne obere oder untere Reihe mit dem Objekt parent.

[explicit] QAreaSeries::QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = nullptr)

Konstruiert ein Flächenreihenobjekt, das zwischen einer Linie upperSeries und einer Linie lowerSeries aufgespannt wird. Wenn dem Konstruktor kein lowerSeries übergeben wird, wird stattdessen die x-Achse als untere Grenze verwendet.

Die QAreaSeries besitzt weder die obere noch die untere Reihe, sondern das Eigentum bleibt beim Aufrufer. Wenn das Serienobjekt zu QChartView oder QChart hinzugefügt wird, wird der Besitz der Instanz übertragen.

[virtual noexcept] QAreaSeries::~QAreaSeries()

Zerstört das Objekt.

[signal] void QAreaSeries::borderColorChanged(QColor color)

Dieses Signal wird ausgegeben, wenn die Farbe der Linie (des Stifts) auf color wechselt.

Hinweis: Benachrichtigungssignal für die Eigenschaft borderColor.

QBrush QAreaSeries::brush() const

Gibt den Pinsel zurück, der zum Zeichnen der Linie für diese Serie verwendet wurde.

Siehe auch setBrush().

[signal] void QAreaSeries::clicked(const QPointF &point)

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

Siehe auch pressed, released, und doubleClicked.

[signal] void QAreaSeries::colorChanged(QColor color)

Dieses Signal wird ausgegeben, wenn die Füllfarbe (Pinsel) auf color wechselt.

Hinweis: Benachrichtigungssignal für die Eigenschaft color.

[signal] void QAreaSeries::doubleClicked(const QPointF &point)

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

Siehe auch pressed, released, und clicked.

[signal] void QAreaSeries::hovered(const QPointF &point, bool state)

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

QPen QAreaSeries::pen() const

Gibt den Stift zurück, der zum Zeichnen der Linie für diese Serie verwendet wurde.

Siehe auch setPen().

[signal] void QAreaSeries::pointLabelsClippingChanged(bool clipping)

Dieses Signal wird ausgegeben, wenn sich die Beschneidung der Datenpunktbeschriftungen auf clipping ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft pointLabelsClipping.

[signal] void QAreaSeries::pointLabelsColorChanged(const QColor &color)

Dieses Signal wird ausgegeben, wenn die Farbe der Datenpunktbeschriftung auf color wechselt.

Hinweis: Benachrichtigungssignal für die Eigenschaft pointLabelsColor.

[signal] void QAreaSeries::pointLabelsFontChanged(const QFont &font)

Dieses Signal wird ausgegeben, wenn die Schriftart für Datenpunktbeschriftungen auf font wechselt.

Hinweis: Benachrichtigungssignal für die Eigenschaft pointLabelsFont.

[signal] void QAreaSeries::pointLabelsFormatChanged(const QString &format)

Dieses Signal wird ausgegeben, wenn die format von Datenpunktbeschriftungen geändert wird.

Hinweis: Meldesignal für die Eigenschaft pointLabelsFormat.

[signal] void QAreaSeries::pointLabelsVisibilityChanged(bool visible)

Dieses Signal wird ausgegeben, wenn die Sichtbarkeit der Datenpunktbeschriftungen auf visible wechselt.

Hinweis: Benachrichtigungssignal für die Eigenschaft pointLabelsVisible.

bool QAreaSeries::pointsVisible() const

Gibt zurück, ob die Punkte für diese Serie gezeichnet werden.

Siehe auch setPointsVisible().

[signal] void QAreaSeries::pressed(const QPointF &point)

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

Siehe auch clicked, released, und doubleClicked.

[signal] void QAreaSeries::released(const QPointF &point)

Dieses Signal wird ausgegeben, wenn der Benutzer eine Taste loslässt, die auf point in einem Bereichsdiagramm ausgelöst wurde.

Siehe auch pressed, clicked, und doubleClicked.

void QAreaSeries::setBrush(const QBrush &brush)

Legt die brush fest, die zum Füllen des Bereichs verwendet wird.

Siehe auch brush().

void QAreaSeries::setLowerSeries(QLineSeries *series)

Legt die series fest, die als untere Reihe des Bereichsdiagramms verwendet werden soll.

Siehe auch lowerSeries().

void QAreaSeries::setPen(const QPen &pen)

Legt die pen fest, die zum Zeichnen des Bereichsumrisses verwendet wird.

Siehe auch pen().

void QAreaSeries::setPointsVisible(bool visible = true)

Bestimmt, ob Datenpunkte visible sind und auf der Linie gezeichnet werden sollen.

Siehe auch pointsVisible().

void QAreaSeries::setUpperSeries(QLineSeries *series)

Legt die series fest, die als obere Reihe des Flächendiagramms verwendet werden soll. Wenn die obere Reihe null ist, wird das Flächendiagramm nicht gezeichnet, auch wenn es eine untere Reihe hat.

Siehe auch upperSeries().

[override virtual] QAbstractSeries::SeriesType QAreaSeries::type() const

Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QAbstractSeries::type.

Rückgabe QAbstractSeries::SeriesTypeArea.

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