QXYSeries Class
Die Klasse „QXYSeries“ ist eine Oberklasse für alle Klassen der x- und y-Serien. Mehr...
| Header: | #include <QXYSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | XYSeries |
| Erbt von: | QAbstractSeries |
| Vererbt an: | QLineSeries, „ QScatterSeries “ und QSplineSeries |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QXYSeries ist Teil der C++-Klassen vonQt Graphs für 2D.
Öffentliche Typen
(since 6.12) enum class | ValueMapping { X, Y } |
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) |
| void | setStepSize(qreal stepSize) |
| void | setValueMapping(QXYSeries::ValueMapping newHint) |
| void | setValueMin(qreal newMin) |
| void | setValues(QVariantList values) |
| qreal | stepSize() const |
| bool | take(QPointF point) |
| void | toggleSelection(const QList<qsizetype> &indexes) |
| QXYSeries::ValueMapping | valueMapping() const |
| qreal | valueMin() const |
| QVariantList | values() const |
Signale
| void | colorChanged(QColor color) |
| void | countChanged() |
| void | draggableChanged() |
| void | pointDelegateChanged() |
| void | pointReplaced(qsizetype index) |
(since 6.9) void | pointsAdded(qsizetype start, qsizetype end) |
| void | pointsReplaced() |
| void | selectedColorChanged(QColor color) |
| void | selectedPointsChanged() |
| void | stepSizeChanged(qreal newStepSize) |
| void | valueMappingChanged(QXYSeries::ValueMapping newHint) |
| void | valueMinChanged(qreal newMin) |
| void | valuesChanged(const QVariantList &values) |
Detaillierte Beschreibung
In QXYSeries werden Datenpunkte als Liste von ` QPointF` definiert, die die X- und Y-Positionen festlegen.
Siehe auch „ QLineSeries “ und „ QScatterSeries “.
Dokumentation zu Mitgliedstypen
[since 6.12] enum class QXYSeries::ValueMapping
Diese Enumeration beschreibt, wie einfache Zahlen in „ values “ interpretiert werden.
| Konstante | Wert | Beschreibung |
|---|---|---|
QXYSeries::ValueMapping::X | 0 | Jede Zahl ist der X-Wert; Y wird aus dem Index und stepSize generiert. |
QXYSeries::ValueMapping::Y | 1 | Jede Zahl ist der Y-Wert; X wird aus „ valueMin “ und „ stepSize “ generiert. |
Diese Enumeration wurde in Qt 6.12 eingeführt.
Dokumentation zur Eigenschaft
color : QColor
Diese Eigenschaft legt die Hauptfarbe der Reihe fest. Bei QLineSeries ist damit die Linienfarbe gemeint, bei QScatterSeries die Farbe des Punktes.
Zugriffsfunktionen:
| QColor | color() const |
| void | setColor(QColor newColor) |
Notifier-Signal:
| void | colorChanged(QColor color) |
[read-only] count : qsizetype
Gibt die Anzahl der Datenpunkte in einer Reihe zurück.
Zugriffsfunktionen:
| qsizetype | count() const |
Benachrichtigungssignal:
| void | countChanged() |
draggable : bool
Legt fest, ob die Serie per Maus oder Touch gezogen werden kann.
Legt fest, ob die Reihe mit der Maus oder per Touch-Eingabe verschoben werden kann. Standardmäßig ist „ draggable “ auf „ false “ gesetzt.
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 dient.
Die für diese Komponente verfügbaren dynamischen Eigenschaften sind:
| Typ | Name | Beschreibung |
|---|---|---|
| bool | pointSelected | Dieser Wert ist „true“, wenn der Punkt ausgewählt ist, d. h., der Punktindex befindet sich im Bereich QXYSeries::selectedPoints. |
| QColor | pointColor | Die Farbe der Reihe. Dieser Wert stammt entweder aus „ QGraphsTheme “ oder aus „ QXYSeries::color “, falls „ QXYSeries “ die Farbe überschreibt. |
| QColor | pointBorderColor | Die Rahmenfarbe der Reihe. Dieser Wert stammt aus dem „ QGraphsTheme “. |
| QColor | pointSelectedColor | Die Farbe des ausgewählten Punktes der Reihe. Dieser Wert stammt entweder aus dem „ QGraphsTheme “ oder aus „ QXYSeries::selectedColor “, falls das „ QXYSeries “ die Farbe überschreibt. |
| qreal | pointBorderWidth | Die Rahmenbreite der Reihe. Dieser Wert stammt aus dem „ QGraphsTheme “. |
| qreal | pointValueX | Der Wert des „ QXYPoint::x “ an dieser Position. |
| qreal | pointValueY | Der Wert des „ QXYPoint::y “ an dieser Position. |
| int | pointIndex | Der Index des Punktes, von 0 bis zur Gesamtanzahl der Punkte minus 1. [ab 6.9] |
Um eine dieser Eigenschaften zu verwenden, fügen Sie Ihrer benutzerdefinierten Komponente eine Eigenschaft mit dem entsprechenden Namen hinzu. Zum Beispiel „ "property color pointColor" “ und „ "property real pointValueX" “.
Zugriffsfunktionen:
| QQmlComponent * | pointDelegate() const |
| void | setPointDelegate(QQmlComponent *newPointDelegate) |
Notifier-Signal:
| void | pointDelegateChanged() |
selectedColor : QColor
Diese Eigenschaft enthält die Farbe der ausgewählten Punkte.
Zugriffsfunktionen:
| QColor | selectedColor() const |
| void | setSelectedColor(QColor color) |
Benachrichtigungssignal:
| void | selectedColorChanged(QColor color) |
[read-only] selectedPoints : QList<qsizetype>
Diese Eigenschaft enthält die Indizes der derzeit ausgewählten Punkte.
Zugriffsfunktionen:
| QList<qsizetype> | selectedPoints() const |
Benachrichtigungssignal:
| void | selectedPointsChanged() |
[since 6.12] stepSize : qreal
Diese Eigenschaft legt die Schrittweite zwischen automatisch generierten X- (oder Y-)Werten fest, wenn die Reihe über „ values “ aus einfachen Zahlen gefüllt wird.
Der Standardwert ist 1.
Diese Aufzählung wurde in Qt 6.12 eingeführt.
Zugriffsfunktionen:
| qreal | stepSize() const |
| void | setStepSize(qreal stepSize) |
Notifier-Signal:
| void | stepSizeChanged(qreal newStepSize) |
Siehe auch „ values “, „ valueMapping “ und „ valueMin “.
[since 6.12] valueMapping : ValueMapping
Legt fest, wie Zahlen in „ values “ interpretiert werden.
Wenn „ values “ einfache Zahlen anstelle von „ QPointF “-Werten enthält, legt diese Eigenschaft fest, ob jede Zahl die X- oder die Y-Komponente eines Punktes ist.
Diese Aufzählung wurde in Qt 6.12 eingeführt.
Zugriffsfunktionen:
| QXYSeries::ValueMapping | valueMapping() const |
| void | setValueMapping(QXYSeries::ValueMapping newHint) |
Notifier-Signal:
| void | valueMappingChanged(QXYSeries::ValueMapping newHint) |
Siehe auch „ values “, „ valueMin “ und „ stepSize “.
[since 6.12] valueMin : qreal
Diese Eigenschaft enthält den minimalen X- (oder Y-)Wert, der bei der Erzeugung von Punkten aus reinen Zahlen in „ values “ verwendet wird.
Wird zusammen mit „ stepSize “ verwendet, wenn „ valueMapping “ auf „ ValueMapping::Y “ gesetzt ist, um die X-Werte für jeden Punkt zu generieren.
Der Standardwert ist 0.
Diese Enumeration wurde in Qt 6.12 eingeführt.
Zugriffsfunktionen:
| qreal | valueMin() const |
| void | setValueMin(qreal newMin) |
Notifier-Signal:
| void | valueMinChanged(qreal newMin) |
Siehe auch „ values “, „ valueMapping “ und „ stepSize “.
[since 6.12] values : QVariantList
Diese Eigenschaft enthält die Punkte der Reihe, die deklarativ festgelegt wurden.
Die Variantenliste kann entweder „ QPointF “-Werte oder Zahlen enthalten. Werden Zahlen angegeben, bestimmt „ valueMapping “, ob jede Zahl als X- oder Y-Komponente interpretiert wird.
Diese Aufzählung wurde in Qt 6.12 eingeführt.
Zugriffsfunktionen:
| QVariantList | values() const |
| void | setValues(QVariantList values) |
Notifier-Signal:
| void | valuesChanged(const QVariantList &values) |
Siehe auch „ valueMapping “, „ valueMin “ und „ stepSize “.
Dokumentation zu den Member-Funktionen
[invokable] void QXYSeries::append(QPointF point)
Fügt der Reihe einen Punkt mit den Koordinaten point hinzu.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QXYSeries::append(const QList<QPointF> &points)
Fügt der Reihe Punkte mit den Koordinaten points hinzu.
Hinweis: Dies ist wesentlich schneller als das Hinzufügen einzelner Datenpunkte. Sendet „ pointsAdded “, sobald die Punkte hinzugefügt wurden.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QXYSeries::append(qreal x, qreal y)
Fügt der Reihe einen Punkt mit den Koordinaten x und y hinzu.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML 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 ungültig ist.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QXYSeries::clear()
Entfernt alle Punkte aus der Reihe.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QXYSeries::deselectAllPoints()
Hebt die Auswahl aller Punkte in der Reihe auf.
Hinweis: Löst QXYSeries::selectedPointsChanged
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch setPointSelected().
[invokable] void QXYSeries::deselectPoint(qsizetype index)
Hebt die Auswahl des Punktes an der angegebenen Koordinaten index auf.
Hinweis: Löst QXYSeries::selectedPointsChanged
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch setPointSelected().
[invokable] void QXYSeries::deselectPoints(const QList<qsizetype> &indexes)
Markiert mehrere bereits durchlaufene Punkte in einer „ indexes “-Liste als nicht mehr ausgewählt.
Hinweis: Gibt QXYSeries::selectedPointsChanged
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch setPointSelected().
[invokable] qsizetype QXYSeries::find(QPointF point) const
Sucht und gibt den Index des ersten übereinstimmenden Punktes zurück, der gemäß der Definition unter point gefunden wurde. Gibt -1 zurück, wenn der Punkt nicht gefunden wird.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML 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. Ist der Index 0 oder kleiner als 0, wird der Punkt an den Anfang der Punktliste eingefügt. Ist der Index gleich oder größer als die Anzahl der Punkte in der Reihe, wird der Punkt an das Ende der Punktliste angehängt.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] bool QXYSeries::isPointSelected(qsizetype index) const
Gibt „true“ zurück, wenn der Punkt unter der angegebenen Koordinaten index e zu den ausgewählten Punkten gehört, andernfalls „false“.
Hinweis: Ausgewählte Punkte werden mit der ausgewählten Farbe gezeichnet, sofern diese angegeben wurde.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch selectedPoints, setPointSelected() und setSelectedColor().
[signal] void QXYSeries::pointReplaced(qsizetype index)
Dieses Signal wird ausgelöst, wenn ein Punkt an der durch index angegebenen Position ersetzt wird.
Siehe auch replace().
QList<QPointF> QXYSeries::points() const
Gibt die Punkte der Reihe zurück.
[signal, since 6.9] void QXYSeries::pointsAdded(qsizetype start, qsizetype end)
Dieses Signal wird ausgelöst, wenn eine Liste von Punkten angehängt wird. Die Indizes der neu hinzugefügten Punkte liegen zwischen start und end.
Diese Funktion wurde in Qt 6.9 eingeführt.
[signal] void QXYSeries::pointsReplaced()
Dieses Signal wird ausgegeben, wenn alle Punkte ersetzt wurden.
[invokable] void QXYSeries::remove(QPointF point)
Entfernt den Punkt mit den Koordinaten point aus der Reihe. Führt keine Aktion aus, wenn der Punkt nicht existiert.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QXYSeries::remove(qsizetype index)
Entfernt den Punkt an der durch index angegebenen Position aus der Reihe.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QXYSeries::remove(qreal x, qreal y)
Entfernt den Punkt mit den Koordinaten x und y aus der Reihe. Führt keine Aktion aus, wenn der Punkt nicht existiert.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML 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 Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QXYSeries::replace(const QList<QPointF> &points)
Ersetzt die aktuellen Punkte durch die in points
Hinweis: Dies ist wesentlich schneller, als Datenpunkte einzeln zu ersetzen oder zunächst alle Daten zu löschen und anschließend die neuen Daten anzuhängen. Löst „ pointsReplaced “ aus, wenn die Punkte ersetzt wurden.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML 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. Führt keine Aktion aus, wenn der alte Punkt nicht existiert.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML 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 Metaobjektsystem und aus QML 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 Metaobjektsystem und aus QML 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. Es geschieht nichts, wenn der alte Punkt nicht existiert.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QXYSeries::selectAllPoints()
Markiert alle Punkte der Reihe als ausgewählt,
Hinweis: Gibt QXYSeries::selectedPointsChanged
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch setPointSelected().
[invokable] void QXYSeries::selectPoint(qsizetype index)
Markiert „ index “ als Auswahl.
Hinweis: Löst QXYSeries::selectedPointsChanged
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch setPointSelected().
[invokable] void QXYSeries::selectPoints(const QList<qsizetype> &indexes)
Markiert mehrere Punkte, die in einer „ indexes “-Liste durchlaufen wurden, als ausgewählt.
Hinweis: Löst QXYSeries::selectedPointsChanged
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch ` setPointSelected()`.
QList<qsizetype> QXYSeries::selectedPoints() const
Gibt eine Liste der Indizes der als ausgewählt markierten Punkte zurück. 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 Punkte an der angegebenen Adresse index entweder als ausgewählt oder als nicht ausgewählt, wie unter selected angegeben.
Hinweis: Ausgewählte Punkte werden mit der ausgewählten Farbe gezeichnet, sofern diese angegeben wurde. Sendet QXYSeries::selectedPointsChanged
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch isPointSelected(), selectAllPoints() und setSelectedColor().
[invokable] bool QXYSeries::take(QPointF point)
Entfernt einen durch ` point` angegebenen Punkt aus der Reihe, sofern dieser gefunden wird. Gibt ` true ` zurück, wenn der Vorgang erfolgreich war.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QXYSeries::toggleSelection(const QList<qsizetype> &indexes)
Ändert den Auswahlstatus der Punkte an der angegebenen Koordinaten indexes e in den entgegengesetzten.
Hinweis: Sendet QXYSeries::selectedPointsChanged
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe ` Q_INVOKABLE`.
Siehe auch ` setPointSelected()`.
© 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.
