Back to Qt.io
Contact Us Blog Download Qt

QXYSeries Class

Die Klasse QXYSeries ist eine übergeordnete Klasse für alle x- und y-Reihenklassen. Mehr...

Kopfzeile: #include <QXYSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
In QML: XYSeries
Vererbt: QAbstractSeries
Vererbt von:

QLineSeries, QScatterSeries, und QSplineSeries

Eigenschaften

Öffentliche Funktionen

void append(QPointF point)
void append(const QList<QPointF> &points)
void append(qreal x, qreal y)
QPointF at(qsizetype index) const
void clear()
QColor color() const
qsizetype count() const
void deselectAllPoints()
void deselectPoint(qsizetype index)
void deselectPoints(const QList<qsizetype> &indexes)
qsizetype find(QPointF point) const
void insert(qsizetype index, QPointF point)
bool isDraggable() const
bool isPointSelected(qsizetype index) const
QQmlComponent *pointDelegate() const
QList<QPointF> points() const
void remove(QPointF point)
void remove(qsizetype index)
void remove(qreal x, qreal y)
void removeMultiple(qsizetype index, qsizetype count)
void replace(const QList<QPointF> &points)
void replace(QPointF oldPoint, QPointF newPoint)
void replace(qsizetype index, QPointF newPoint)
void replace(qsizetype index, qreal newX, qreal newY)
void replace(qreal oldX, qreal oldY, qreal newX, qreal newY)
void selectAllPoints()
void selectPoint(qsizetype index)
void selectPoints(const QList<qsizetype> &indexes)
QColor selectedColor() const
QList<qsizetype> selectedPoints() const
void setColor(QColor newColor)
void setDraggable(bool newDraggable)
void setPointDelegate(QQmlComponent *newPointDelegate)
void setPointSelected(qsizetype index, bool selected)
void setSelectedColor(QColor color)
bool take(QPointF point)
void toggleSelection(const QList<qsizetype> &indexes)

Signale

void colorChanged(QColor color)
void countChanged()
void draggableChanged()
void pointDelegateChanged()
void pointReplaced(qsizetype index)
void pointsReplaced()
void selectedColorChanged(QColor color)
void selectedPointsChanged()

Detaillierte Beschreibung

In QXYSeries werden die Datenpunkte als eine Liste von QPointF definiert, die die X- und Y-Positionen festlegen.

Siehe auch QLineSeries und QScatterSeries.

Dokumentation der Eigenschaften

color : QColor

Diese Eigenschaft enthält die Hauptfarbe der Serie. Für QLineSeries ist dies die Linienfarbe und für QScatterSeries die Farbe des Punktes.

Zugriffsfunktionen:

QColor color() const
void setColor(QColor newColor)

Benachrichtigungssignal:

void colorChanged(QColor color)

[read-only] count : const qsizetype

Gibt die Anzahl der Datenpunkte in einer Reihe zurück.

Zugriffsfunktionen:

qsizetype count() const

Melder-Signal:

void countChanged()

draggable : bool

Legt fest, ob die Serie gezogen werden kann.

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

Zugriffsfunktionen:

bool isDraggable() const
void setDraggable(bool newDraggable)

Benachrichtigungssignal:

void draggableChanged()

pointDelegate : QQmlComponent*

Diese Eigenschaft enthält eine benutzerdefinierte QML-Komponente, die als Markierung für Datenpunkte verwendet wird.

Die für diese Komponente verfügbaren dynamischen Eigenschaften sind:

TypNameBeschreibung
boolpointSelectedDieser Wert ist wahr, wenn der Punkt ausgewählt ist, was bedeutet, dass der Punktindex in QXYSeries::selectedPoints steht.
QColorpointColorDie Farbe der Serie. Dieser Wert stammt entweder von QGraphsTheme oder von QXYSeries::color, wenn QXYSeries die Farbe überschreibt.
QColorpointBorderColorDie Farbe des Rahmens der Reihe. Dieser Wert stammt aus dem QGraphsTheme.
QColorpointSelectedColorDie ausgewählte Farbe der Serie. Dieser Wert stammt entweder aus QGraphsTheme oder aus QXYSeries::selectedColor, wenn QXYSeries die Farbe überschreibt.
qrealpointBorderWidthDie Breite des Rahmens der Serie. Dieser Wert stammt aus dem QGraphsTheme.
qrealpointValueXDer Wert des QXYPoint::x an dieser Position.
qrealpointValueYDer Wert des QXYPoint::y an dieser Position.

Um eine dieser Eigenschaften zu verwenden, fügen Sie die Eigenschaft mit dem definierten Namen in Ihre benutzerdefinierte Komponente ein. Zum Beispiel "property color pointColor" und "property real pointValueX".

Zugriffsfunktionen:

QQmlComponent *pointDelegate() const
void setPointDelegate(QQmlComponent *newPointDelegate)

Benachrichtigungssignal:

void pointDelegateChanged()

selectedColor : QColor

Diese Eigenschaft enthält die Farbe der ausgewählten Punkte.

Zugriffsfunktionen:

QColor selectedColor() const
void setSelectedColor(QColor color)

Melder-Signal:

void selectedColorChanged(QColor color)

[read-only] selectedPoints : const QList<qsizetype>

Diese Eigenschaft enthält die Indizes der Punkte, die gerade ausgewählt sind.

Zugriffsfunktionen:

QList<qsizetype> selectedPoints() const

Benachrichtigungssignal:

void selectedPointsChanged()

Member Function Dokumentation

[invokable] void QXYSeries::append(QPointF point)

Hängt einen Punkt mit den Koordinaten point an die Serie an.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QXYSeries::append(const QList<QPointF> &points)

Hängt Punkte mit den Koordinaten points an die Serie an.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QXYSeries::append(qreal x, qreal y)

Hängt einen Punkt mit den Koordinaten x und y an die Serie an.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] QPointF QXYSeries::at(qsizetype index) const

Gibt den Punkt an der durch index angegebenen Position zurück. Gibt (0, 0) zurück, wenn der Index nicht gültig ist.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QXYSeries::clear()

Entfernt alle Punkte aus der Serie.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QXYSeries::deselectAllPoints()

Deselektiert alle Punkte in der Serie.

Hinweis: Sendet QXYSeries::selectedPointsChanged

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

Siehe auch setPointSelected().

[invokable] void QXYSeries::deselectPoint(qsizetype index)

Deselektiert den Punkt auf der angegebenen index.

Hinweis: Sendet QXYSeries::selectedPointsChanged

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

Siehe auch setPointSelected().

[invokable] void QXYSeries::deselectPoints(const QList<qsizetype> &indexes)

Markiert mehrere in einer Liste indexes übergebene Punkte als abgewählt.

Hinweis: Sendet QXYSeries::selectedPointsChanged

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

Siehe auch setPointSelected().

[invokable] qsizetype QXYSeries::find(QPointF point) const

Sucht und gibt den Index des ersten gefundenen übereinstimmenden Punktes gemäß der Definition von point zurück. Gibt -1 zurück, wenn der Punkt nicht gefunden wird.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QXYSeries::insert(qsizetype index, QPointF point)

Fügt einen Punkt mit den Koordinaten point an der durch index angegebenen Position in die Reihe ein. Wenn der Index 0 oder kleiner als 0 ist, wird der Punkt der Liste der Punkte vorangestellt. Ist der Index gleich oder größer als die Anzahl der Punkte in der Reihe, wird der Punkt an die Liste der Punkte angehängt.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] bool QXYSeries::isPointSelected(qsizetype index) const

Gibt true zurück, wenn der Punkt auf der angegebenen Seite index zu den ausgewählten Punkten gehört, andernfalls false.

Hinweis: Ausgewählte Punkte werden mit der ausgewählten Farbe gezeichnet, falls diese angegeben wurde.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

Siehe auch selectedPoints, setPointSelected(), und setSelectedColor().

[signal] void QXYSeries::pointReplaced(qsizetype index)

Dieses Signal wird ausgegeben, wenn ein Punkt an der durch index angegebenen Position ersetzt wird.

Siehe auch replace().

QList<QPointF> QXYSeries::points() const

Gibt die Punkte der Serie zurück.

[signal] void QXYSeries::pointsReplaced()

Dieses Signal wird ausgegeben, wenn alle Punkte ersetzt sind.

[invokable] void QXYSeries::remove(QPointF point)

Entfernt den Punkt mit den Koordinaten point aus der Serie. Tut nichts, wenn der Punkt nicht existiert.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QXYSeries::remove(qsizetype index)

Entfernt den Punkt an der durch index angegebenen Position aus der Serie.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QXYSeries::remove(qreal x, qreal y)

Entfernt den Punkt mit den Koordinaten x und y aus der Serie. Tut nichts, wenn der Punkt nicht existiert.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QXYSeries::removeMultiple(qsizetype index, qsizetype count)

Entfernt die durch count angegebene Anzahl von Punkten aus der Reihe, beginnend an der durch index angegebenen Position.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QXYSeries::replace(const QList<QPointF> &points)

Ersetzt die aktuellen Punkte durch die Punkte, die durch points

Hinweis: Dies ist viel schneller als das Ersetzen der Datenpunkte einzeln oder das Löschen aller Daten und das anschließende Anhängen der neuen Daten. Gibt pointsReplaced aus, wenn die Punkte ersetzt worden sind.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QXYSeries::replace(QPointF oldPoint, QPointF newPoint)

Ersetzt den Punkt mit den Koordinaten oldPoint durch den Punkt mit den Koordinaten newPoint. Tut nichts, wenn der alte Punkt nicht existiert.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QXYSeries::replace(qsizetype index, QPointF newPoint)

Ersetzt den Punkt an der durch index angegebenen Position durch den Punkt mit den Koordinaten newPoint.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QXYSeries::replace(qsizetype index, qreal newX, qreal newY)

Ersetzt den Punkt an der durch index angegebenen Position durch den Punkt mit den Koordinaten newX und newY.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QXYSeries::replace(qreal oldX, qreal oldY, qreal newX, qreal newY)

Ersetzt den Punkt mit den Koordinaten oldX und oldY durch den Punkt mit den Koordinaten newX und newY. Tut nichts, wenn der alte Punkt nicht existiert.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QXYSeries::selectAllPoints()

Markiert alle Punkte in der Serie als ausgewählt,

Hinweis: Sendet QXYSeries::selectedPointsChanged

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

Siehe auch setPointSelected().

[invokable] void QXYSeries::selectPoint(qsizetype index)

Markiert den Punkt auf index als ausgewählt.

Hinweis: Sendet QXYSeries::selectedPointsChanged

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

Siehe auch setPointSelected().

[invokable] void QXYSeries::selectPoints(const QList<qsizetype> &indexes)

Markiert mehrere in einer Liste indexes übergebene Punkte als ausgewählt.

Hinweis: Sendet QXYSeries::selectedPointsChanged

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

Siehe auch setPointSelected().

QList<qsizetype> QXYSeries::selectedPoints() const

Gibt eine Liste von Punktindizes zurück, die als ausgewählt markiert sind. Ausgewählte Punkte sind unabhängig von der Sichtbarkeit der Punkte sichtbar.

Hinweis: Getter-Funktion für die Eigenschaft selectedPoints.

Siehe auch setPointSelected().

[invokable] void QXYSeries::setPointSelected(qsizetype index, bool selected)

Markiert den Punkt auf der angegebenen Seite index als ausgewählt oder abgewählt, wie durch selected angegeben.

Hinweis: Ausgewählte Punkte werden mit der ausgewählten Farbe gezeichnet, falls diese angegeben wurde. Sendet QXYSeries::selectedPointsChanged

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

Siehe auch isPointSelected(), selectAllPoints(), und setSelectedColor().

[invokable] bool QXYSeries::take(QPointF point)

Entnimmt einen Punkt, der durch point angegeben wird, aus der Reihe, falls gefunden. Gibt true zurück, wenn die Operation erfolgreich ist.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QXYSeries::toggleSelection(const QList<qsizetype> &indexes)

Ändert den Auswahlzustand der Punkte auf indexes in den entgegengesetzten Zustand.

Hinweis: Sendet QXYSeries::selectedPointsChanged

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

Siehe auch setPointSelected().

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