QAreaSeries Class
Die Klasse „QAreaSeries“ stellt Daten in Flächendiagrammen dar. Mehr...
| Header: | #include <QAreaSeries> |
| In QML: | AreaSeries |
| Inherits: | QAbstractSeries |
| Status: | Deprecated |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
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 |
Neu implementierte ö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) |
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. Da die Flächenreihe auf der Linienreihe basiert, benötigt der Konstruktor von `QAreaSeries` eine Instanz von ` QLineSeries `, die die obere Begrenzung der Fläche definiert. 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 `QAreaSeries` mit zwei ` QLineSeries `-Instanzen initialisiert werden.
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.
In der Galerie „Diagramme mit Widgets“ erfahren Sie, wie Sie ein einfaches Flächendiagramm erstellen.
Dokumentation zu den Eigenschaften
borderColor : QColor
Diese Eigenschaft enthält die Linienfarbe (Stiftfarbe) der Reihe. Es handelt sich um eine Komfort-Eigenschaft zum Ändern der Stiftfarbe.
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 (Pinselfarbe) der Reihe. Es handelt sich um eine Hilfs-Eigenschaft zum Ändern der Pinselfarbe.
Zugriffsfunktionen:
| QColor | color() const |
| void | setColor(const QColor &color) |
Benachrichtigungssignal:
| void | colorChanged(QColor color) |
Siehe auch „ QAreaSeries::brush()“.
[read-only] lowerSeries : QLineSeries*
Diese Eigenschaft enthält die untere der beiden Linienreihen, die zur Definition der Grenzen von Flächenreihen verwendet werden.
Hinweis: Wenn „ QAreaSeries “ ohne „lowerSeries“ erstellt wurde, ist dieser Wert null.
Zugriffsfunktionen:
| QLineSeries * | lowerSeries() const |
pointLabelsClipping : bool
Diese Eigenschaft legt fest, ob die Beschriftungen der Datenpunkte beschnitten werden. Standardmäßig auf „True“ gesetzt. Die Beschriftungen am Rand des Darstellungsbereichs werden beschnitten, wenn das Beschneiden aktiviert ist.
Zugriffsfunktionen:
| bool | pointLabelsClipping() const |
| void | setPointLabelsClipping(bool enabled = true) |
Benachrichtigungssignal:
| void | pointLabelsClippingChanged(bool clipping) |
Siehe auch „ pointLabelsVisible “.
pointLabelsColor : QColor
Diese Eigenschaft legt die Farbe fest, die für die Beschriftungen der Datenpunkte verwendet wird. Standardmäßig entspricht die Farbe der Farbe des Pinsels, der im Design für Beschriftungen definiert ist.
Zugriffsfunktionen:
| QColor | pointLabelsColor() const |
| void | setPointLabelsColor(const QColor &color) |
Benachrichtigungssignal:
| void | pointLabelsColorChanged(const QColor &color) |
Siehe auch „ QAreaSeries::pointLabelsFormat “.
pointLabelsFont : QFont
Diese Eigenschaft gibt die Schriftart an, die für die Beschriftungen der Datenpunkte verwendet wird.
Zugriffsfunktionen:
| QFont | pointLabelsFont() const |
| void | setPointLabelsFont(const QFont &font) |
Benachrichtigungssignal:
| void | pointLabelsFontChanged(const QFont &font) |
Siehe auch „ QAreaSeries::pointLabelsFormat “.
pointLabelsFormat : QString
Diese Eigenschaft legt das Format fest, das für die Anzeige von Beschriftungen bei Serienpunkten verwendet wird.
QAreaSeries Unterstützt die folgenden Format-Tags:
| @xPoint | Der x-Wert des Datenpunkts |
| @yPoint | Der y-Wert des Datenpunkts |
Beispielsweise würde die folgende Verwendung der Format-Tags 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 im Diagrammbereich angezeigt, wobei Beschriftungen am Rand des Diagrammbereichs abgeschnitten werden. Liegen die Punkte dicht beieinander, können sich die Beschriftungen überlappen.
Zugriffsfunktionen:
| QString | pointLabelsFormat() const |
| void | setPointLabelsFormat(const QString &format) |
Benachrichtigungssignal:
| void | pointLabelsFormatChanged(const QString &format) |
Siehe auch „ QAreaSeries::pointLabelsVisible “, „ QAreaSeries::pointLabelsFont “ und „ QAreaSeries::pointLabelsColor “.
pointLabelsVisible : bool
Diese Eigenschaft legt die Sichtbarkeit von Datenpunktbeschriftungen fest. Standardmäßig auf „False“ gesetzt.
Zugriffsfunktionen:
| bool | pointLabelsVisible() const |
| void | setPointLabelsVisible(bool visible = true) |
Benachrichtigungssignal:
| void | pointLabelsVisibilityChanged(bool visible) |
Siehe auch QAreaSeries::pointLabelsFormat und QAreaSeries::pointLabelsClipping.
[read-only] upperSeries : QLineSeries*
Diese Eigenschaft enthält die obere der beiden Linienreihen, die zur Definition der Grenzen von Flächenreihen verwendet werden.
Zugriffsfunktionen:
| QLineSeries * | upperSeries() const |
Dokumentation zu den Member-Funktionen
[explicit] QAreaSeries::QAreaSeries(QObject *parent = nullptr)
Erstellt mit dem Objekt „ parent “ ein Flächenreihenobjekt ohne obere oder untere Reihe.
[explicit] QAreaSeries::QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = nullptr)
Erstellt ein Flächenreihenobjekt, das sich zwischen einer „ upperSeries “-Linie und einer „ lowerSeries “-Linie erstreckt. Wird dem Konstruktor kein „ lowerSeries “ übergeben, wird stattdessen die x-Achse als untere Grenze verwendet.
Die `QAreaSeries` besitzt weder die obere noch die untere Reihe, sondern die Eigentumsrechte verbleiben beim Aufrufer. Wenn das Reihenobjekt zu `QChartView` oder `QChart` hinzugefügt wird, werden die Eigentumsrechte an der Instanz übertragen.
[virtual noexcept] QAreaSeries::~QAreaSeries()
Löscht das Objekt.
[signal] void QAreaSeries::borderColorChanged(QColor color)
Dieses Signal wird ausgelöst, wenn sich die Linienfarbe (Stiftfarbe) auf „ color “ ändert.
Hinweis: Notifier -Signal 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 ausgelöst, wenn der Benutzer einen Klick auf „ point “ auslöst, indem er in einem Flächendiagramm darauf klickt.
Siehe auch pressed, released und doubleClicked.
[signal] void QAreaSeries::colorChanged(QColor color)
Dieses Signal wird ausgelöst, wenn sich die Füllfarbe (Pinsel) in „ color “ ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ color “.
[signal] void QAreaSeries::doubleClicked(const QPointF &point)
Dieses Signal wird ausgelöst, wenn der Benutzer durch Doppelklick auf „ point “ den ersten Klick in einem Flächendiagramm auslöst.
Siehe auch pressed, released und clicked.
[signal] void QAreaSeries::hovered(const QPointF &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.
QPen QAreaSeries::pen() const
Gibt den Stift zurück, mit dem die Linie für diese Reihe gezeichnet wurde.
Siehe auch setPen().
[signal] void QAreaSeries::pointLabelsClippingChanged(bool clipping)
Dieses Signal wird ausgelöst, 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 ausgelöst, wenn sich die für Datenpunktbeschriftungen verwendete Farbe auf „ color “ ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft „ pointLabelsColor “.
[signal] void QAreaSeries::pointLabelsFontChanged(const QFont &font)
Dieses Signal wird ausgelöst, wenn sich die für Datenpunktbeschriftungen verwendete Schriftart auf „ font “ ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ pointLabelsFont “.
[signal] void QAreaSeries::pointLabelsFormatChanged(const QString &format)
Dieses Signal wird ausgelöst, wenn sich die „ format “ der Datenpunktbeschriftungen ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ pointLabelsFormat “.
[signal] void QAreaSeries::pointLabelsVisibilityChanged(bool visible)
Dieses Signal wird ausgelöst, wenn sich die Sichtbarkeit der Datenpunktbeschriftungen auf „ visible “ ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ pointLabelsVisible “.
bool QAreaSeries::pointsVisible() const
Gibt zurück, ob für diese Reihe Punkte gezeichnet werden.
Siehe auch „ setPointsVisible()“.
[signal] void QAreaSeries::pressed(const QPointF &point)
Dieses Signal wird ausgelöst, wenn der Benutzer in einem Flächendiagramm auf den unter point angegebenen Punkt klickt.
Siehe auch „ clicked “, „ released “ und „ doubleClicked “.
[signal] void QAreaSeries::released(const QPointF &point)
Dieses Signal wird ausgelöst, wenn der Benutzer einen Klick loslässt, der auf „ point “ in einem Flächendiagramm 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 Flächendiagramms verwendet werden soll.
Siehe auch lowerSeries().
void QAreaSeries::setPen(const QPen &pen)
Legt den „ pen “ fest, der zum Zeichnen des Bereichsumrisses verwendet wird.
Siehe auch ` pen()`.
void QAreaSeries::setPointsVisible(bool visible = true)
Legt fest, ob Datenpunkte „ visible “ sind und auf der Linie dargestellt werden sollen.
Siehe auch „ pointsVisible()“.
void QAreaSeries::setUpperSeries(QLineSeries *series)
Legt die „ series “ fest, die als obere Reihe des Flächendiagramms verwendet werden soll. Ist die obere Reihe null, wird das Flächendiagramm nicht gezeichnet, selbst wenn es eine untere Reihe gibt.
Siehe auch ` upperSeries()`.
[override virtual] QAbstractSeries::SeriesType QAreaSeries::type() const
Implementiert eine Zugriffsfunktion für die Eigenschaft „ QAbstractSeries::type “ neu.
Gibt „ QAbstractSeries::SeriesTypeArea “ zurück.
© 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.
