QAbstractSeries Class
Die Klasse „QAbstractSeries“ ist eine Basisklasse für alle „ Qt Graphs “ für 2D-Reihen. Mehr...
| Header: | #include <QAbstractSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | AbstractSeries |
| Erbt von: | QObject und QQmlParserStatus |
| Vererbt an: | QAreaSeries, QBarSeries, QCustomSeries, QPieSeries und QXYSeries |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QAbstractSeries ist Teil von „Qt Graphs “ – C++-Klassen für 2D.
Öffentliche Typen
| enum class | SeriesType { Line, Bar, Scatter, Pie, Spline, …, Custom } |
Eigenschaften
|
Öffentliche Funktionen
| virtual | ~QAbstractSeries() override |
| QAbstractAxis * | axisX() const |
| QAbstractAxis * | axisY() const |
| void | hide() |
| bool | isHoverable() const |
| bool | isHovered() const |
| bool | isSelectable() const |
| bool | isVisible() const |
| const QList<QLegendData> | legendData() const |
| QString | name() const |
| qreal | opacity() const |
| QQmlListProperty<QObject> | seriesChildren() |
| void | setAxisX(QAbstractAxis *newAxisX) |
| void | setAxisY(QAbstractAxis *newAxisY) |
| void | setHoverable(bool newHoverable) |
| void | setName(const QString &name) |
| void | setOpacity(qreal opacity) |
| void | setSelectable(bool selectable) |
| void | setValuesMultiplier(qreal valuesMultiplier) |
| void | setVisible(bool visible = true) |
| void | setZValue(int newDrawOrder) |
| void | show() |
| virtual QAbstractSeries::SeriesType | type() const = 0 |
| qreal | valuesMultiplier() const |
| int | zValue() const |
Signale
| void | axisXChanged(QAbstractAxis *newAxis) |
| void | axisYChanged(QAbstractAxis *newAxis) |
| void | hover(const QString &seriesName, QPointF position, QPointF value) |
| void | hoverEnter(const QString &seriesName, QPointF position, QPointF value) |
| void | hoverExit(const QString &seriesName, QPointF position) |
| void | hoverableChanged() |
| void | hoveredChanged(bool hovered) |
| void | legendDataChanged() |
| void | nameChanged() |
| void | opacityChanged() |
| void | selectableChanged() |
| void | valuesMultiplierChanged() |
| void | visibleChanged() |
| void | zValueChanged(int z) |
Ausführliche Beschreibung
In der Regel werden anstelle der Basisklasse die für den jeweiligen Serientyp spezifischen abgeleiteten Klassen verwendet.
Siehe auch QLineSeries, QSplineSeries, QScatterSeries, QBarSeries und QXYSeries.
Dokumentation zu Mitgliedstypen
enum class QAbstractSeries::SeriesType
Diese Enumeration beschreibt den Typ der Reihe.
| Konstante | Wert | Beschreibung |
|---|---|---|
QAbstractSeries::SeriesType::Line | 0 | Ein Liniendiagramm. |
QAbstractSeries::SeriesType::Bar | 2 | Ein Säulendiagramm. |
QAbstractSeries::SeriesType::Scatter | 4 | Ein Streudiagramm. |
QAbstractSeries::SeriesType::Pie | 3 | Ein Kreisdiagramm. |
QAbstractSeries::SeriesType::Spline | 5 | Ein Spline-Diagramm. |
QAbstractSeries::SeriesType::Area | 1 | Ein Flächendiagramm. |
QAbstractSeries::SeriesType::Custom | 6 | Ein benutzerdefiniertes Diagramm. |
Dokumentation zu den Eigenschaften
[since 6.10] axisX : QAbstractAxis*
X-Achse dieser Reihe.
Die für diese Reihe verwendete x-Achse. Erstellt eine von der in „ GraphsView “ definierten Achse getrennte Achse, um dem Benutzer mehrere Achsen pro Diagramm anzuzeigen.
Diese Aufzählung wurde in Qt 6.10 eingeführt.
Zugriffsfunktionen:
| QAbstractAxis * | axisX() const |
| void | setAxisX(QAbstractAxis *newAxisX) |
Notifier-Signal:
| void | axisXChanged(QAbstractAxis *newAxis) |
[since 6.10] axisY : QAbstractAxis*
Y-Achse dieser Reihe.
Die für diese Reihe verwendete y-Achse. Erstellt eine von der in „ GraphsView “ definierten Achse getrennte Achse, sodass dem Benutzer mehrere Achsen pro Diagramm angezeigt werden.
Diese Aufzählung wurde in Qt 6.10 eingeführt.
Zugriffsfunktionen:
| QAbstractAxis * | axisY() const |
| void | setAxisY(QAbstractAxis *newAxisY) |
Notifier-Signal:
| void | axisYChanged(QAbstractAxis *newAxis) |
hoverable : bool
Legt fest, ob die Serie beim Darüberfahren mit der Maus/per Touch interaktiv ist.
Legt fest, ob der Mauszeiger über die Reihe bewegt werden kann. Standardmäßig ist „ hoverable “ auf „ false “ gesetzt.
Zugriffsfunktionen:
| bool | isHoverable() const |
| void | setHoverable(bool newHoverable) |
Benachrichtigungssignal:
| void | hoverableChanged() |
[read-only] hovered : bool
Prüft, ob der Mauszeiger über einer Serie schwebt.
Kann verwendet werden, um zu prüfen, ob sich der Mauszeiger bzw. der Finger derzeit über einer Reihe befindet.
Zugriffsfunktionen:
| bool | isHovered() const |
Notifier-Signal:
| void | hoveredChanged(bool hovered) |
Siehe auch QAbstractSeries ::hovered.
[read-only] legendData : QList<QLegendData>
Enthält Informationen, die zum Erstellen einer Legendenmarkierung für einen Datensatz in einem Diagramm benötigt werden.
Zugriffsfunktionen:
| const QList<QLegendData> | legendData() const |
Benachrichtigungssignal:
| void | legendDataChanged() |
Siehe auch „ QLegendData “.
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 legt die Deckkraft der Serie fest.
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() |
selectable : bool
Legt fest, ob die Serie auswählbar ist.
Legt fest, ob die Serie mit der Maus oder per Touch ausgewählt werden kann. Standardmäßig ist „ selectable “ auf „ false “ eingestellt.
Zugriffsfunktionen:
| bool | isSelectable() const |
| void | setSelectable(bool selectable) |
Benachrichtigungssignal:
| void | selectableChanged() |
[read-only] seriesChildren : const QQmlListProperty<QObject>
Die Liste der untergeordneten Objekte einer Serie. Hierbei handelt es sich um eine Standard-Eigenschaft, mit der untergeordnete Objekte innerhalb eines Serienelements in QML angegeben werden können, ohne den Eigenschaftsnamen „children“ explizit verwenden zu müssen.
Zugriffsfunktionen:
| QQmlListProperty<QObject> | seriesChildren() |
[read-only] type : const SeriesType
Diese Eigenschaft gibt den Typ der Reihe an.
Zugriffsfunktionen:
| virtual QAbstractSeries::SeriesType | type() const = 0 |
valuesMultiplier : qreal
Steuert den tatsächlich sichtbaren Wert der Zeitreihe.
Diese Variable kann verwendet werden, um die Reihenwerte so zu animieren, dass sie von 0 bis zur tatsächlichen Wertgröße skaliert werden. Standardmäßig beträgt der Wert von „valuesMultiplier“ 1,0. Der gültige Wertebereich reicht von 0,0 (Höhe 0) bis 1,0 (voller Wert).
Zugriffsfunktionen:
| qreal | valuesMultiplier() const |
| void | setValuesMultiplier(qreal valuesMultiplier) |
Benachrichtigungssignal:
| void | valuesMultiplierChanged() |
visible : bool
Sichtbarkeit der Serie.
Die für diese Reihe verwendete Sichtbarkeit. Standardmäßig ist „ visible “ auf „ true “ eingestellt.
Zugriffsfunktionen:
| bool | isVisible() const |
| void | setVisible(bool visible = true) |
Benachrichtigungssignal:
| void | visibleChanged() |
[since 6.10] zValue : int
Steuert die Reihenfolge, in der die Serie gezeichnet wird
Die Serienliste von ` GraphsView ` wird nach der Eigenschaft `zValue` sortiert. Da jeder Serientyp auf einmal gerendert wird, entspricht die Reihenfolge meist der internen Reihenfolge innerhalb jedes Serientyps. Der höchste `zValue` jedes Serientyps bestimmt die Reihenfolge der Darstellung zwischen den Serientypen. Der Standardwert ist 0.
Diese Aufzählung wurde in Qt 6.10 eingeführt.
Zugriffsfunktionen:
| int | zValue() const |
| void | setZValue(int newDrawOrder) |
Notifier-Signal:
| void | zValueChanged(int z) |
Dokumentation der Mitgliedsfunktionen
[override virtual noexcept] QAbstractSeries::~QAbstractSeries()
Virtueller Destruktor für die Graph-Reihe.
void QAbstractSeries::hide()
Legt die Sichtbarkeit der Reihe auf „ false “ fest.
Siehe auch „ setVisible()“ und „ isVisible()“.
[signal] void QAbstractSeries::hover(const QString &seriesName, QPointF position, QPointF value)
Dieses Signal wird ausgelöst, wenn sich die aktive Reihe ändert. Der Name der Reihe befindet sich in „ seriesName “, die Maus-/Touch-Position in „ position “ und der Wert der Reihe in „ value “.
Hinweis: Dieses Signal wird nur ausgelöst, wenn hoverable auf „true“ gesetzt ist.
Hinweis: Bei Kreisdiagrammen steht der Wert für (Positionswinkel, Startwinkel des überflogenen Segments).
[signal] void QAbstractSeries::hoverEnter(const QString &seriesName, QPointF position, QPointF value)
Dieses Signal wird ausgelöst, wenn das Hover-Ereignis für die Serie beginnt. Der Name der Serie ist in „ seriesName “ enthalten, die Maus-/Touch-Position in „ position “ und der Serienwert in „ value “.
Hinweis: Dieses Signal wird nur ausgelöst, wenn hoverable auf „true“ gesetzt ist.
Hinweis: Bei Kreisdiagrammen steht der Wert für (Positionswinkel, Startwinkel des überflogenen Segments).
[signal] void QAbstractSeries::hoverExit(const QString &seriesName, QPointF position)
Dieses Signal wird ausgelöst, wenn das Hover-Ereignis der Serie endet. Der Name der Serie ist in „ seriesName “ enthalten, die Maus-/Touch-Position in „ position “.
Hinweis: Dieses Signal wird nur ausgelöst, wenn hoverable auf „true“ gesetzt ist.
void QAbstractSeries::show()
Legt die Sichtbarkeit der Reihe auf „ true “ fest.
Siehe auch „ setVisible()“ und „ isVisible()“.
© 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.
