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 |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QAbstractSeries ist Teil von Qt Graphs C++ Classes for 2D.
Öffentliche Typen
| enum class | SeriesType { Line, Bar, Scatter, Pie, Spline, Area } |
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) |
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.
| Konstante | Wert | Beschreibung |
|---|---|---|
QAbstractSeries::SeriesType::Line | 0 | Ein Liniendiagramm. |
QAbstractSeries::SeriesType::Bar | 2 | Ein Balkendiagramm. |
QAbstractSeries::SeriesType::Scatter | 4 | Ein Punktediagramm. |
QAbstractSeries::SeriesType::Pie | 3 | Ein Kreisdiagramm. |
QAbstractSeries::SeriesType::Spline | 5 | Ein Spline-Diagramm. |
QAbstractSeries::SeriesType::Area | 1 | Ein Flächendiagramm. |
Dokumentation der Eigenschaften
[since 6.10] axisX : QAbstractAxis*
X-Achse dieser Reihe.
Die für diese Reihe verwendete X-Achse. Erzeugt eine separate Achse zu der in GraphsView definierten, die dem Benutzer mehrere Achsen pro Diagramm anzeigt.
Diese Eigenschaft 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. Erzeugt eine separate Achse zu der in GraphsView definierten, die dem Benutzer mehrere Achsen pro Diagramm anzeigt.
Diese Eigenschaft wurde in Qt 6.10 eingeführt.
Zugriffsfunktionen:
| QAbstractAxis * | axisY() const |
| void | setAxisY(QAbstractAxis *newAxisY) |
Notifier-Signal:
| void | axisYChanged(QAbstractAxis *newAxis) |
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] hovered : const bool
Prüfen, ob eine Serie in der Schwebe ist.
Kann verwendet werden, um zu prüfen, ob die Maus/Berührung gerade über einer Serie schwebt.
Zugriffsfunktionen:
| bool | isHovered() const |
Benachrichtigungssignal:
| void | hoveredChanged(bool hovered) |
Siehe auch QAbstractSeries::hovered.
[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) |
Melder-Signal:
| void | visibleChanged() |
[since 6.10] zValue : int
Steuert die Reihenfolge, in der die Reihe gezeichnet wird
Die Serienliste von GraphsView wird nach der Eigenschaft zValue sortiert. Da jeder Reihentyp auf einmal gerendert wird, funktioniert die Reihenfolge meist als interne Reihenfolge der einzelnen Reihentypen. Der höchste zValue jedes Serientyps bestimmt die Reihenfolge des Renderings zwischen den Serientypen. Der Standardwert ist 0.
Diese Eigenschaft wurde in Qt 6.10 eingeführt.
Zugriffsfunktionen:
| int | zValue() const |
| void | setZValue(int newDrawOrder) |
Notifier Signal:
| void | zValueChanged(int z) |
Member Function Dokumentation
[override virtual noexcept] QAbstractSeries::~QAbstractSeries()
Virtueller Destruktor für die Diagrammreihe.
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.
Hinweis: Bei einem Kreisdiagramm entspricht der Wert (Positionswinkel, Startwinkel des schwebenden Bereichs)
[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.
Hinweis: Bei einem Kreisdiagramm entspricht der Wert (Positionswinkel, Startwinkel des schwebenden Bereichs)
[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.
