XYSeries QML Type (Uncreatable)
Ein übergeordneter Typ für alle Typen der x- und y-Serien. Mehr...
| Import Statement: | import QtGraphs |
| In C++: | QXYSeries |
| Inherits: | |
| Inherited By: |
Hinweis: Dies ist ein nicht erstellbarer Typ. Er kann in QML nicht instanziiert werden.
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- „XYSeries“ ist Teil der QML-Typen für 2D unterQt Graphs .
Eigenschaften
- color : color
- count : int
- draggable : bool
- pointDelegate : Component
- selectedColor : color
- selectedPoints : list<int>
- values : list<variant>
(since 6.12)
Signale
- clicked(point point)
- colorChanged(color color)
- doubleClicked(point point)
- draggableChanged()
- pointMarkerChanged()
- pointReplaced(int index)
- pointsAdded(int start, int end)
(since 6.9) - pointsReplaced()
- pressed(point point)
- released(point point)
- selectedColorChanged(color color)
- selectedPointsChanged()
Methoden
- void append(list<point> points)
- void append(point point)
- void append(real x, real y)
- point at(int index)
- void clear()
- void deselectAllPoints()
- void deselectPoint(int index)
- void deselectPoints(list<int> indexes)
- int find(point point)
- void insert(int index, point point)
- bool isPointSelected(int index)
- void remove(int index)
- void remove(point point)
- void remove(real x, real y)
- void removeMultiple(int index, int count)
- void replace(list<point> points)
- void replace(int index, point newPoint)
- void replace(point oldPoint, point newPoint)
- void replace(int index, real newX, real newY)
- void replace(real oldX, real oldY, real newX, real newY)
- void selectAllPoints()
- void selectPoint(int index)
- void selectPoints(list<int> indexes)
- void setPointSelected(int index, bool selected)
- bool take(point point)
- void toggleSelection(list<int> indexes)
Ausführliche Beschreibung
In der XYSeries werden Datenpunkte als Liste von Punkttypen definiert, die die X- und Y-Positionen festlegen.
Dokumentation der Eigenschaften
color : color
Die Hauptfarbe der Serie. Für LineSeries bedeutet dies die Linienfarbe und für ScatterSeries die Farbe des Punktes.
count : int [read-only]
Gibt die Anzahl der Datenpunkte in einer Reihe zurück.
draggable : bool
Legt fest, ob die Serie mit der Maus oder per Touch-Geste verschoben werden kann. Standardmäßig ist „ draggable “ auf „ false “ eingestellt.
pointDelegate : Component
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. |
| Farbe | pointColor | Die Farbe der Serie. Dieser Wert stammt entweder aus der „ GraphsTheme “ oder aus „ XYSeries::color “, falls die „ XYSeries “ die Farbe überschreibt. |
| Farbe | pointBorderColor | Die Rahmenfarbe der Reihe. Dieser Wert stammt aus dem „ GraphsTheme “. |
| Farbe | pointSelectedColor | Die Farbe des ausgewählten Punktes der Reihe. Dieser Wert stammt entweder aus dem „ GraphsTheme “ oder aus „ XYSeries::selectedColor “, falls der „ XYSeries “ die Farbe überschreibt. |
| real | pointBorderWidth | Die Rahmenbreite der Reihe. Dieser Wert stammt aus dem „ GraphsTheme “. |
| real | pointValueX | Der Wert des „ XYPoint::x “ an dieser Position. |
| real | pointValueY | Der Wert der „ XYPoint::y “ an dieser Position. |
| int | pointIndex | Der Index des Punktes, von 0 bis zur Anzahl der Punkte minus 1. [seit 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" “.
selectedColor : color
Die Farbe der ausgewählten Punkte.
selectedPoints : list<int> [read-only]
Die Indizes der derzeit ausgewählten Punkte.
values : list<variant> [since 6.12]
Mit dieser Eigenschaft können Punkte für einen „ XYSeries “ deklarativ festgelegt werden. Die Variantenliste kann entweder aus Punkten oder aus Zahlen bestehen. Werden Zahlen angegeben, kann mithilfe von „valueMapping“ festgelegt werden, ob die Zahl als X- oder Y-Komponente eines Punktes interpretiert wird.
Diese Eigenschaft wurde in Qt 6.12 eingeführt.
Signal-Dokumentation
clicked(point point)
Dieses Signal wird ausgelöst, wenn der Benutzer im Diagramm auf den „ point “ klickt oder darauf tippt.
Hinweis: Der entsprechende Handler lautet „ onClicked “.
colorChanged(color color)
Dieses Signal wird ausgelöst, wenn sich die Linienfarbe zu „ color “ ändert.
Hinweis: Der entsprechende Handler lautet „ onColorChanged “.
doubleClicked(point point)
Dieses Signal wird ausgelöst, wenn der Benutzer im Diagramm auf die Daten point doppelt klickt oder doppelt tippt. Die „ point “ ist der Punkt, an dem der erste Klick ausgelöst wurde. Dieses Signal tritt immer nach „ clicked “ auf.
Hinweis: Der entsprechende Handler lautet „ onDoubleClicked “.
draggableChanged()
Dieses Signal wird ausgelöst, wenn eine Serie per Maus oder Touch verschiebbar wird oder fixiert wird.
Hinweis: Der entsprechende Handler lautet „ onDraggableChanged “.
pointMarkerChanged()
Dieses Signal wird ausgelöst, wenn ein Punkt geändert wird.
Hinweis: Der entsprechende Handler lautet „ onPointMarkerChanged “.
pointReplaced(int index)
Dieses Signal wird ausgelöst, wenn ein Punkt an der durch index angegebenen Position ersetzt wird.
Hinweis: Der entsprechende Handler lautet „ onPointReplaced “.
[since 6.9] pointsAdded(int start, int 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.
Hinweis: Der entsprechende Handler lautet onPointsAdded.
Dieses Signal wurde in Qt 6.9 eingeführt.
pointsReplaced()
Dieses Signal wird ausgegeben, wenn alle Punkte ersetzt wurden.
Hinweis: Der zugehörige Handler lautet „ onPointsReplaced “.
pressed(point point)
Dieses Signal wird ausgelöst, wenn der Benutzer auf den Daten point en im Diagramm klickt und die Maustaste oder Geste gedrückt hält.
Hinweis: Der entsprechende Handler lautet „ onPressed “.
released(point point)
Dieses Signal wird ausgelöst, wenn der Benutzer die zuvor gedrückte Maustaste loslässt oder eine Geste auf der Daten point ausführt.
Hinweis: Der entsprechende Handler lautet „ onReleased “.
selectedColorChanged(color color)
Dieses Signal wird ausgelöst, wenn sich die Farbe der ausgewählten Reihe zu „ color “ ändert.
Hinweis: Der entsprechende Handler lautet „ onSelectedColorChanged “.
selectedPointsChanged()
Dieses Signal wird ausgelöst, wenn sich die Menge der ausgewählten Punkte ändert.
Hinweis: Der entsprechende Handler ist „ onSelectedPointsChanged “.
Methodendokumentation
void append(list<point> 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.
void append(point point)
Fügt der Reihe einen Punkt mit den Koordinaten point hinzu.
void append(real x, real y)
Fügt der Reihe einen Punkt mit den Koordinaten x und y hinzu.
point at(int index)
Gibt den Punkt an der durch ` index` angegebenen Position zurück. Gibt (0, 0) zurück, wenn der Index ungültig ist.
void clear()
Entfernt alle Punkte aus der Reihe.
void deselectAllPoints()
Hebt die Auswahl aller Punkte in der Reihe auf.
Hinweis: Gibt QXYSeries::selectedPointsChanged
Siehe auch ` setPointSelected()`.
void deselectPoint(int index)
Hebt die Auswahl des Punktes an der angegebenen Koordinaten index auf.
Hinweis: Löst QXYSeries::selectedPointsChanged
Siehe auch ` setPointSelected()`.
void deselectPoints(list<int> indexes)
Markiert mehrere bereits durchlaufene Punkte in einer „ indexes “-Liste als abgewählt.
Hinweis: Gibt QXYSeries::selectedPointsChanged
Siehe auch ` setPointSelected()`.
int find(point point)
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.
void insert(int index, point 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 am Anfang der Liste der Punkte eingefügt. Ist der Index gleich oder größer als die Anzahl der Punkte in der Reihe, wird der Punkt am Ende der Liste der Punkte angehängt.
bool isPointSelected(int index)
Gibt „true“ zurück, wenn der Punkt unter der angegebenen Koordinaten index ie zu den ausgewählten Punkten gehört, andernfalls „false“.
Hinweis: Ausgewählte Punkte werden mit der ausgewählten Farbe gezeichnet, sofern diese angegeben wurde.
Siehe auch „ selectedPoints“ , „ setPointSelected()“ und „ selectedColor “.
void remove(int index)
Entfernt den Punkt an der durch „ index “ angegebenen Position aus der Reihe.
void remove(point point)
Entfernt den Punkt mit den Koordinaten point aus der Reihe. Führt keine Aktion aus, wenn der Punkt nicht existiert.
void remove(real x, real y)
Entfernt den Punkt mit den Koordinaten x und y aus der Reihe. Führt keine Aktion aus, wenn der Punkt nicht existiert.
void removeMultiple(int index, int count)
Entfernt die durch ` count ` angegebene Anzahl von Punkten aus der Reihe, beginnend an der durch ` index` angegebenen Position.
void replace(list<point> points)
Ersetzt die aktuellen Punkte durch die in points
Hinweis: Dies ist wesentlich schneller, als die Datenpunkte einzeln zu ersetzen oder zunächst alle Daten zu löschen und anschließend die neuen Daten anzuhängen. Sendet „ pointsReplaced “, sobald die Punkte ersetzt wurden.
void replace(int index, point newPoint)
Ersetzt den Punkt an der durch index angegebenen Position durch den Punkt mit den Koordinaten newPoint.
void replace(point oldPoint, point 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.
void replace(int index, real newX, real newY)
Ersetzt den Punkt an der durch index angegebenen Position durch den Punkt mit den Koordinaten newX und newY.
void replace(real oldX, real oldY, real newX, real newY)
Ersetzt den Punkt mit den Koordinaten oldX und oldY durch den Punkt mit den Koordinaten newX und newY. Führt keine Aktion aus, wenn der alte Punkt nicht existiert.
void selectAllPoints()
Markiert alle Punkte der Reihe als ausgewählt,
Hinweis: Gibt QXYSeries::selectedPointsChanged
Siehe auch setPointSelected().
void selectPoint(int index)
Markiert index als ausgewählt.
Hinweis: Gibt QXYSeries::selectedPointsChanged
Siehe auch setPointSelected().
void selectPoints(list<int> indexes)
Markiert mehrere Punkte, die in einer „ indexes “-Liste durchlaufen wurden, als ausgewählt.
Hinweis: Gibt QXYSeries::selectedPointsChanged
Siehe auch ` setPointSelected()` ().
void setPointSelected(int 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. Gibt QXYSeries::selectedPointsChanged
Siehe auch isPointSelected(), selectAllPoints() und selectedColor.
bool take(point point)
Entfernt einen Punkt, der durch ` point` angegeben wird, aus der Reihe, sofern er gefunden wird. Gibt ` true ` zurück, wenn der Vorgang erfolgreich war.
void toggleSelection(list<int> indexes)
Ändert den Auswahlstatus der Punkte unter der angegebenen Koordinaten indexes ation in den entgegengesetzten.
Hinweis: Löst QXYSeries::selectedPointsChanged
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.
