QAbstractSeries Class
Die Klasse `QAbstractSeries` ist eine Basisklasse für alle Qt Charts-Reihen. Mehr...
| Header: | #include <QAbstractSeries> |
| In QML: | AbstractSeries |
| Inherits: | QObject |
| Inherited By: | QAbstractBarSeries, QAreaSeries, QBoxPlotSeries, QCandlestickSeries, QPieSeries, and QXYSeries |
| Status: | Deprecated |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Öffentliche Typen
| enum | SeriesType { SeriesTypeLine, SeriesTypeArea, SeriesTypeBar, SeriesTypeStackedBar, SeriesTypePercentBar, …, SeriesTypeCandlestick } |
Eigenschaften
Öffentliche Funktionen
| virtual | ~QAbstractSeries() |
| bool | attachAxis(QAbstractAxis *axis) |
| QList<QAbstractAxis *> | attachedAxes() |
| QChart * | chart() const |
| bool | detachAxis(QAbstractAxis *axis) |
| void | hide() |
| bool | isVisible() const |
| QString | name() const |
| qreal | opacity() const |
| void | setName(const QString &name) |
| void | setOpacity(qreal opacity) |
| void | setUseOpenGL(bool enable = true) |
| void | setVisible(bool visible = true) |
| void | show() |
| virtual QAbstractSeries::SeriesType | type() const = 0 |
| bool | useOpenGL() const |
Signale
| void | nameChanged() |
| void | opacityChanged() |
| void | useOpenGLChanged() |
| void | visibleChanged() |
Ausführliche Beschreibung
In der Regel werden anstelle der Basisklasse die für den jeweiligen Serientyp spezifischen abgeleiteten Klassen verwendet.
Siehe auch QXYSeries, QLineSeries, QSplineSeries, QScatterSeries, QAreaSeries, QAbstractBarSeries, QBarSeries, QStackedBarSeries, QPercentBarSeries, QHorizontalBarSeries, QHorizontalStackedBarSeries, QHorizontalPercentBarSeries und QPieSeries.
Dokumentation zu den Mitgliedstypen
enum QAbstractSeries::SeriesType
Diese Enumeration beschreibt den Typ der Reihe.
| Konstante | Wert | Beschreibung |
|---|---|---|
QAbstractSeries::SeriesTypeLine | 0 | Ein Liniendiagramm. |
QAbstractSeries::SeriesTypeArea | 1 | Ein Flächendiagramm. |
QAbstractSeries::SeriesTypeBar | 2 | Ein vertikales Säulendiagramm. |
QAbstractSeries::SeriesTypeStackedBar | 3 | Ein vertikales gestapeltes Balkendiagramm. |
QAbstractSeries::SeriesTypePercentBar | 4 | Ein vertikales Prozentbalkendiagramm. |
QAbstractSeries::SeriesTypePie | 5 | Ein Kreisdiagramm. |
QAbstractSeries::SeriesTypeScatter | 6 | Ein Streudiagramm. |
QAbstractSeries::SeriesTypeSpline | 7 | Ein Spline-Diagramm. |
QAbstractSeries::SeriesTypeHorizontalBar | 8 | Ein horizontales Balkendiagramm. |
QAbstractSeries::SeriesTypeHorizontalStackedBar | 9 | Ein horizontales gestapeltes Balkendiagramm. |
QAbstractSeries::SeriesTypeHorizontalPercentBar | 10 | Ein horizontales Prozent-Balkendiagramm. |
QAbstractSeries::SeriesTypeBoxPlot | 11 | Ein Boxplot-Diagramm. |
QAbstractSeries::SeriesTypeCandlestick | 12 | Ein Kerzendiagramm. |
Dokumentation zu den Eigenschaften
name : QString
Diese Eigenschaft enthält den Namen der Reihe.
Der Name wird in der Legende der Reihe angezeigt und unterstützt HTML-Formatierung.
Zugriffsfunktionen:
| QString | name() const |
| void | setName(const QString &name) |
Benachrichtigungssignal:
| void | nameChanged() |
opacity : qreal
Diese Eigenschaft gibt die Deckkraft der Serie an.
Standardmäßig beträgt die Deckkraft 1,0. Die gültigen Werte reichen von 0,0 (transparent) bis 1,0 (undurchsichtig).
Zugriffsfunktionen:
| qreal | opacity() const |
| void | setOpacity(qreal opacity) |
Benachrichtigungssignal:
| void | opacityChanged() |
[read-only] type : SeriesType
Diese Eigenschaft gibt den Typ der Reihe an.
Zugriffsfunktionen:
| virtual QAbstractSeries::SeriesType | type() const = 0 |
useOpenGL : bool
Legt fest, ob das Zeichnen der Reihe mithilfe von OpenGL beschleunigt wird oder nicht.
Die Beschleunigung mittels OpenGL wird nur für QLineSeries und QScatterSeries unterstützt. Eine Linienreihe, die als Randreihe für `QAreaSeries` verwendet wird, kann keine OpenGL-Beschleunigung nutzen. Wenn ein Diagramm Reihen enthält, die mit OpenGL gezeichnet werden, wird ein transparentes `QOpenGLWidget` über dem Darstellungsbereich des Diagramms erstellt. Die beschleunigten Reihen werden nicht auf dem darunterliegenden ` QGraphicsView` gezeichnet, sondern auf dem erstellten `QOpenGLWidget`.
Die durch die Verwendung von OpenGL zur Beschleunigung der Serienzeichnung erzielte Leistungssteigerung hängt von der zugrunde liegenden Hardware ab, ist jedoch in den meisten Fällen erheblich. Auf einem Standard-Desktop-Computer ermöglicht die Aktivierung der OpenGL-Beschleunigung für eine Serie beispielsweise typischerweise das Rendern von mindestens hundertmal mehr Punkten, ohne dass die Bildrate beeinträchtigt wird. Auch die Diagrammgröße hat einen geringeren Einfluss auf die Bildrate.
Die OpenGL-Beschleunigung beim Zeichnen von Zeitreihen ist für Anwendungsfälle gedacht, bei denen eine schnelle Darstellung einer großen Anzahl von Punkten erforderlich ist. Sie ist auf Effizienz optimiert, weshalb Zeitreihen, die diese Beschleunigung nutzen, viele Funktionen nicht unterstützen, die bei nicht beschleunigten Zeitreihen verfügbar sind:
- Serienanimationen werden bei beschleunigten Serien nicht unterstützt.
- Punktbeschriftungen werden bei beschleunigten Reihen nicht unterstützt.
- Stiftstile, Markierungsformen und helle Markierungen werden bei beschleunigten Reihen ignoriert. Es werden nur durchgezogene Linien und einfache Streupunkte unterstützt. Die Streupunkte können je nach zugrunde liegender Grafikhardware und Treibern kreisförmig oder rechteckig sein.
- Polardiagramme unterstützen keine beschleunigten Reihen.
- Das Aktivieren von Diagramm-Schlagschatten oder die Verwendung einer transparenten Diagrammhintergrundfarbe wird bei der Verwendung beschleunigter Reihen nicht empfohlen, da dies die Bildrate erheblich verlangsamen kann.
Diese zusätzlichen Einschränkungen ergeben sich daraus, dass die beschleunigte Reihe in einem separaten Widget über dem Diagramm gezeichnet wird:
- Wenn Sie Grafikelemente über einem Diagramm zeichnen, das eine beschleunigte Reihe enthält, wird die beschleunigte Reihe über diese Elemente gezeichnet.
- Damit QOpenGLWidget teilweise transparent sein kann, muss es über allen anderen Widgets angeordnet werden. Das bedeutet, dass bei der Verwendung beschleunigter Reihen keine anderen Widgets das Diagramm teilweise überdecken dürfen.
- Beschleunigte Reihen werden nicht für Anwendungsfälle unterstützt, bei denen der Grafikszene mehr als eine Grafikansicht zugeordnet ist.
- Beschleunigte Reihen werden nicht unterstützt, wenn das Diagramm eine vom Standard abweichende Geometrie aufweist. Das Hinzufügen von Transformationen zur Grafikansicht führt beispielsweise dazu, dass die beschleunigte Reihe an einer im Verhältnis zum Diagramm falschen Position gezeichnet wird.
Der Standardwert ist „ false “.
Zugriffsfunktionen:
| bool | useOpenGL() const |
| void | setUseOpenGL(bool enable = true) |
Notifier-Signal:
| void | useOpenGLChanged() |
visible : bool
Diese Eigenschaft gibt an, ob die Reihe sichtbar ist oder nicht.
Standardmäßig gilt: „ true “.
Zugriffsfunktionen:
| bool | isVisible() const |
| void | setVisible(bool visible = true) |
Benachrichtigungssignal:
| void | visibleChanged() |
Dokumentation der Mitgliedsfunktionen
[virtual noexcept] QAbstractSeries::~QAbstractSeries()
Virtueller Destruktor für die Diagrammreihe.
bool QAbstractSeries::attachAxis(QAbstractAxis *axis)
Fügt die durch axis angegebene Achse zur Reihe hinzu.
Gibt „ true “ zurück, wenn die Achse erfolgreich hinzugefügt wurde, andernfalls „ false “.
Hinweis: Wenn mehrere Achsen derselben Ausrichtung an dieselbe Reihe angehängt werden, haben sie dieselben Minimal- und Maximalwerte.
Siehe auch „ QChart::addAxis()“ und „ QChart::createDefaultAxes()“.
QList<QAbstractAxis *> QAbstractSeries::attachedAxes()
Gibt die Liste der an die Reihe angehängten Achsen zurück. In der Regel sind an eine Reihe eine x-Achse und eine y-Achse angehängt, mit Ausnahme von `QPieSeries`, an die keine Achsen angehängt sind.
Siehe auch attachAxis() und detachAxis().
QChart *QAbstractSeries::chart() const
Gibt das Diagramm zurück, zu dem die Reihe gehört.
Wird automatisch gesetzt, wenn die Reihe zum Diagramm hinzugefügt wird, und aufgehoben, wenn die Reihe aus dem Diagramm entfernt wird.
bool QAbstractSeries::detachAxis(QAbstractAxis *axis)
Trennt die durch axis angegebene Achse von der Reihe ab.
Gibt „ true “ zurück, wenn die Achse erfolgreich getrennt wurde, andernfalls „ false “.
Siehe auch „ QChart::removeAxis()“.
void QAbstractSeries::hide()
Legt die Sichtbarkeit der Reihe auf „ false “ fest.
Siehe auch „ setVisible()“ und „ isVisible()“.
[signal] void QAbstractSeries::nameChanged()
Dieses Signal wird ausgegeben, wenn sich der Name der Serie ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft „ name “.
[signal] void QAbstractSeries::opacityChanged()
Dieses Signal wird ausgegeben, wenn sich die Deckkraft der Serie ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ opacity “.
void QAbstractSeries::show()
Legt die Sichtbarkeit der Reihe auf „ true “ fest.
Siehe auch „ setVisible()“ und „ isVisible()“.
[signal] void QAbstractSeries::useOpenGLChanged()
Dieses Signal wird ausgegeben, wenn die Beschleunigung der Zeichnung der Serie mithilfe von OpenGL aktiviert oder deaktiviert wird.
Hinweis: Notifier -Signal für die Eigenschaft „ useOpenGL “.
[signal] void QAbstractSeries::visibleChanged()
Dieses Signal wird ausgegeben, wenn sich die Sichtbarkeit der Serie ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft „ visible “.
© 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.
