QAbstractSeries Class

Die Klasse QAbstractSeries ist eine Basisklasse für alle Qt Graphs für 2D-Serien. Mehr...

Kopfzeile: #include <QAbstractSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
In QML: AbstractSeries
Vererbt: QObject und QQmlParserStatus
Geerbt von:

QAreaSeries, QBarSeries, QPieSeries, und QXYSeries

Öffentliche Typen

enum class SeriesType { Line, Bar, Scatter, Pie, Spline, Area }

Eigenschaften

Öffentliche Funktionen

virtual ~QAbstractSeries() override
QGraphsView *graph() const
void hide()
bool isHoverable() const
bool isSelectable() const
bool isVisible() const
const QList<QLegendData> legendData() const
QString name() const
qreal opacity() const
QQmlListProperty<QObject> seriesChildren()
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 show()
virtual QAbstractSeries::SeriesType type() const = 0
qreal valuesMultiplier() const

Signale

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 legendDataChanged()
void nameChanged()
void opacityChanged()
void selectableChanged()
void valuesMultiplierChanged()
void visibleChanged()

Detaillierte Beschreibung

Normalerweise werden die serientypspezifischen geerbten Klassen anstelle der Basisklasse verwendet.

Siehe auch QLineSeries, QSplineSeries, QScatterSeries, QBarSeries, und QXYSeries.

Dokumentation der Mitgliedstypen

enum class QAbstractSeries::SeriesType

Diese Aufzählung beschreibt den Typ der Reihe.

KonstanteWertBeschreibung
QAbstractSeries::SeriesType::Line0Ein Liniendiagramm.
QAbstractSeries::SeriesType::Bar2Ein Balkendiagramm.
QAbstractSeries::SeriesType::Scatter4Ein Punktediagramm.
QAbstractSeries::SeriesType::Pie3Ein Kreisdiagramm.
QAbstractSeries::SeriesType::Spline5Ein Spline-Diagramm.
QAbstractSeries::SeriesType::Area1Ein Flächendiagramm.

Dokumentation der Eigenschaften

hoverable : bool

Steuert, ob die Serie mit dem Mauszeiger bewegt werden kann.

Legt fest, ob die Serie mit der Maus/Berührung verschoben werden kann. Standardmäßig ist hoverable auf false eingestellt.

Zugriffsfunktionen:

bool isHoverable() const
void setHoverable(bool newHoverable)

Benachrichtigungssignal:

void hoverableChanged()

[read-only] legendData : const QList<QLegendData>

Enthält Informationen, die zum Erstellen einer Legendenmarkierung für einen Datensatz in einem Diagramm erforderlich sind.

Zugriffsfunktionen:

const QList<QLegendData> legendData() const

Melder-Signal:

void legendDataChanged()

Siehe auch QLegendData.

name : QString

Diese Eigenschaft enthält den Namen der Serie.

Der Name wird in der Legende für die Serie angezeigt und unterstützt HTML-Formatierung.

Zugriffsfunktionen:

QString name() const
void setName(const QString &name)

Benachrichtigungssignal:

void nameChanged()

opacity : qreal

Diese Eigenschaft enthält die Deckkraft der Serie.

Standardmäßig ist 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)

Melder-Signal:

void opacityChanged()

selectable : bool

Steuert, ob die Serie auswählbar ist.

Legt fest, ob die Serie mit der Maus/Berührung ausgewählt werden kann. Standardmäßig ist selectable auf false eingestellt.

Zugriffsfunktionen:

bool isSelectable() const
void setSelectable(bool selectable)

Benachrichtigungssignal:

void selectableChanged()

[read-only] type : const SeriesType

Diese Eigenschaft enthält den Typ der Reihe.

Zugriffsfunktionen:

virtual QAbstractSeries::SeriesType type() const = 0

valuesMultiplier : qreal

Steuert den effektiven sichtbaren Wert der Serienwerte.

Diese Variable kann verwendet werden, um die Serienwerte zu animieren, so dass sie von 0 bis zur tatsächlichen Wertgröße skalieren. Standardmäßig ist der WerteMultiplikator 1,0. Die gültigen Werte reichen von 0.0 (Höhe 0) bis 1.0 (voller Wert).

Zugriffsfunktionen:

qreal valuesMultiplier() const
void setValuesMultiplier(qreal valuesMultiplier)

Melder-Signal:

void valuesMultiplierChanged()

visible : bool

Sichtbarkeit der Reihe.

Die für diese Serie verwendete Sichtbarkeit. Standardmäßig ist visible auf true eingestellt.

Zugriffsfunktionen:

bool isVisible() const
void setVisible(bool visible = true)

Benachrichtigungssignal:

void visibleChanged()

Mitgliederfunktion Dokumentation

[override virtual noexcept] QAbstractSeries::~QAbstractSeries()

Virtueller Destruktor für die Diagrammreihe.

QGraphsView *QAbstractSeries::graph() const

Gibt das Diagramm zurück, zu dem die Reihe gehört.

Wird automatisch gesetzt, wenn die Reihe dem Diagramm hinzugefügt wird, und wird nicht gesetzt, wenn die Reihe aus dem Diagramm entfernt wird.

void QAbstractSeries::hide()

Setzt die Sichtbarkeit der Serie auf false.

Siehe auch setVisible() und isVisible().

[signal] void QAbstractSeries::hover(const QString &seriesName, QPointF position, QPointF value)

Dieses Signal wird ausgegeben, wenn sich der Schwebezustand der Serie ändert. Der Name der Serie steht in seriesName, die Maus-/Berührungsposition in position und der Serienwert in value.

Hinweis: Dieses Signal wird nur ausgegeben, wenn hoverable auf true gesetzt ist.

[signal] void QAbstractSeries::hoverEnter(const QString &seriesName, QPointF position, QPointF value)

Dieses Signal wird ausgegeben, wenn das Schweben der Serie beginnt. Der Name der Serie steht in seriesName, die Maus-/Berührungsposition in position und der Serienwert in value.

Hinweis: Dieses Signal wird nur ausgegeben, wenn hoverable auf true gesetzt ist.

[signal] void QAbstractSeries::hoverExit(const QString &seriesName, QPointF position)

Dieses Signal wird ausgegeben, wenn der Schwebezustand der Serie endet. Der Name der Serie steht in seriesName, und die Maus-/Berührungsposition in position.

Hinweis: Dieses Signal wird nur ausgegeben, wenn hoverable auf true gesetzt ist.

void QAbstractSeries::show()

Setzt die Sichtbarkeit der Serie auf true.

Siehe auch setVisible() und isVisible().

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