XYSeries QML Type
A parent type for all x & y series types. More...
Import Statement: | import QtGraphs |
In C++: | QXYSeries |
Inherits: | |
Inherited By: |
- List of all members, including inherited members
- XYSeries is part of Qt Graphs QML Types for 2D.
Properties
- color : color
- count : int
- pointDelegate : Component
- selectedColor : color
- selectedPoints : list<int>
Signals
- colorChanged(color color)
- draggableChanged()
- pointMarkerChanged()
- pointReplaced(int index)
- pointsReplaced()
- selectedColorChanged(color color)
- selectedPointsChanged()
Methods
- append(list<point> points)
- append(point point)
- append(real x, real y)
- point at(int index)
- clear()
- deselectAllPoints()
- deselectPoint(int index)
- deselectPoints(list<int> indexes)
- int find(point point)
- insert(int index, point point)
- bool isPointSelected(int index)
- remove(int index)
- remove(point point)
- remove(real x, real y)
- removeMultiple(int index, int count)
- replace(list<point> points)
- replace(int index, point newPoint)
- replace(point oldPoint, point newPoint)
- replace(int index, real newX, real newY)
- replace(real oldX, real oldY, real newX, real newY)
- selectAllPoints()
- selectPoint(int index)
- selectPoints(list<int> indexes)
- setPointSelected(int index, bool selected)
- bool take(point point)
- toggleSelection(list<int> indexes)
Detailed Description
In XYSeries, data points are defined as a list of point types, defining X and Y positions.
Property Documentation
color : color |
The main color of the series. For LineSeries this means the line color and for ScatterSeries the color of the point
count : int |
Returns the number of data points in a series.
pointDelegate : Component |
A custom QML Component used as a marker for data points.
The dynamic properties available for this component are:
Type | Name | Description |
---|---|---|
bool | pointSelected | This value is true when the point is selected. |
Color | pointColor | The color of the series. This value comes either from the GraphsTheme or from XYSeries::color if the XYSeries overrides the color. |
Color | pointBorderColor | The border color of the series. This value comes from the GraphsTheme. |
Color | pointSelectedColor | The selected color of the series. This value comes either from the GraphsTheme or from XYSeries::selectedColor if the XYSeries overrides the color. |
real | pointBorderWidth | The border width of the series. This value comes from the GraphsTheme. |
real | pointValueX | The value of the XYPoint::x at this position. |
real | pointValueY | The value of the XYPoint::y at this position. |
To use any of these, add property with the defined name into your custom component. For example "property color pointColor"
and "property real pointValueX"
.
selectedColor : color |
The main color of the selected series. For LineSeries this means the line color and for ScatterSeries the color of the point
Signal Documentation
colorChanged(color color) |
This signal is emitted when the line color changes to color.
Note: The corresponding handler is onColorChanged
.
draggableChanged() |
This signal is emitted when a series becomes draggable by a mouse/touch or becomes fixed.
Note: The corresponding handler is onDraggableChanged
.
pointMarkerChanged() |
This signal is emitted when a point is changed.
Note: The corresponding handler is onPointMarkerChanged
.
pointReplaced(int index) |
This signal is emitted when a point is replaced at the position specified by index.
Note: The corresponding handler is onPointReplaced
.
pointsReplaced() |
This signal is emitted when all points are replaced.
Note: The corresponding handler is onPointsReplaced
.
selectedColorChanged(color color) |
This signal is emitted when the color of selected series changes to color.
Note: The corresponding handler is onSelectedColorChanged
.
selectedPointsChanged() |
This signal is emitted when the set of selected points changes.
Note: The corresponding handler is onSelectedPointsChanged
.
Method Documentation
append(point point) |
Appends a point with the coordinates point to the series.
Returns the point at the position specified by index. Returns (0, 0) if the index is not valid.
clear() |
Removes all points from the series.
deselectAllPoints() |
Deselects all points in the series.
Note: Emits QXYSeries::selectedPointsChanged
See also setPointSelected().
deselectPoint(int index) |
Deselects point at given index.
Note: Emits QXYSeries::selectedPointsChanged
See also setPointSelected().
Marks multiple points passed in a indexes list as deselected.
Note: Emits QXYSeries::selectedPointsChanged
See also setPointSelected().
Finds and returns the index of the first matching point found as defined by point. Returns -1 if the point is not found.
Inserts a point with the coordinates point to the position specified by index in the series. If the index is 0 or less than 0, the point is prepended to the list of points. If the index is equal to or greater than than the number of points in the series, the point is appended to the list of points.
Returns true if point at given index is among selected points and false otherwise.
Note: Selected points are drawn using the selected color if it was specified.
See also selectedPoints, setPointSelected(), and selectedColor.
remove(int index) |
Removes the point at the position specified by index from the series.
remove(point point) |
Removes the point with the coordinates point from the series. Does nothing if the point does not exist.
Removes the point with the coordinates x and y from the series. Does nothing if the point does not exist.
Removes the number of points specified by count from the series starting at the position specified by index.
Replaces the current points with the points specified by points
Note: This is much faster than replacing data points one by one, or first clearing all data, and then appending the new data. Emits pointsReplaced when the points have been replaced.
Replaces the point at the position specified by index with the point that has the coordinates newPoint.
Replaces the point with the coordinates oldPoint with the point with the coordinates newPoint. Does nothing if the old point does not exist.
Replaces the point at the position specified by index with the point that has the coordinates newX and newY.
Replaces the point with the coordinates oldX and oldY with the point with the coordinates newX and newY. Does nothing if the old point does not exist.
selectAllPoints() |
Marks all points in the series as selected,
Note: Emits QXYSeries::selectedPointsChanged
See also setPointSelected().
selectPoint(int index) |
Marks point at index as selected.
Note: Emits QXYSeries::selectedPointsChanged
See also setPointSelected().
Marks multiple points passed in a indexes list as selected.
Note: Emits QXYSeries::selectedPointsChanged
See also setPointSelected().
Marks point at given index as either selected or deselected as specified by selected.
Note: Selected points are drawn using the selected color if it was specified. Emits QXYSeries::selectedPointsChanged
See also isPointSelected(), selectAllPoints(), and selectedColor.
Takes a point, specified by point, out of the series if found. Returns true
if the operation is successful.
Changes selection state of points at given indexes to the opposite one.
Note: Emits QXYSeries::selectedPointsChanged
See also setPointSelected().
© 2024 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.