Back to Qt.io
Contact Us Blog Download Qt
本页内容

XYSeries QML Type (Uncreatable)

所有 x 和 y 系列类型的父类型。更多...

Import Statement: import QtGraphs
In C++: QXYSeries
Inherits:

AbstractSeries

Inherited By:

LineSeries, ScatterSeries, and SplineSeries

注意：这是一个不可创建的类型。无法在 QML 中对其进行实例化。

属性

信号

方法

详细说明

在 XYSeries 中，数据点被定义为一组点类型，用于指定 X 和 Y 坐标。

属性文档

color : color

该系列的主色。对于LineSeries 而言，这指的是线条颜色；对于ScatterSeries 而言，则指点的位置颜色。

count : int [read-only]

返回序列中的数据点数量。

draggable : bool

控制是否允许使用鼠标/触摸操作拖动该系列。默认情况下，draggable 设置为false 。

pointDelegate : Component

一个用作数据点标记的自定义 QML 组件。

该组件可用的动态属性包括：

类型名称描述
boolpointSelected当点被选中时，此值为 true。
颜色pointColor系列的颜色。该值来自GraphsTheme ，或者（如果XYSeries 覆盖了颜色）来自XYSeries::color 。
颜色pointBorderColor系列的边框颜色。该值来自GraphsTheme 。
颜色pointSelectedColor系列的选中颜色。该值来自GraphsTheme ，或者如果XYSeries 覆盖了颜色，则来自XYSeries::selectedColor 。
realpointBorderWidth系列的边框宽度。该值来自GraphsTheme 。
realpointValueXXYPoint::x 在该位置处的数值。
realpointValueYXYPoint::y 在该位置的值。
intpointIndex该点的索引，范围从 0 到总点数减 1。[自 6.9 版起]

要使用这些属性，请在自定义组件中添加名称与之对应的属性。例如"property color pointColor" 和"property real pointValueX" 。

selectedColor : color

所选点的颜色。

selectedPoints : list<int> [read-only]

当前所选点的索引。

values : list<variant> [since 6.12]

该属性可用于为XYSeries 声明式地设置点。变体列表可以是点，也可以是数字。如果提供的是数字，则可通过valueMapping来指定该数字应被解释为点的X分量还是Y分量。

该属性在 Qt 6.12 中引入。

信号文档

clicked(point point)

当用户在图表中点击或轻触point 时，会触发此信号。

注意： 相应的处理程序 为onClicked 。

colorChanged(color color)

当线条颜色变为color 时，将发出此信号。

注意： 相应的处理程序 为onColorChanged 。

doubleClicked(point point)

当用户在图表中双击或双击（双点）数据point 时，会触发此信号。point 是首次点击触发的点。该信号总是在clicked 之后发生。

注意： 对应的处理程序 是onDoubleClicked 。

draggableChanged()

当一个系列可以通过鼠标/触摸进行拖动或被固定时，会触发此信号。

注意： 相应的处理程序 是onDraggableChanged 。

pointMarkerChanged()

当某个点发生变化时，会触发此信号。

注意： 相应的处理程序 为onPointMarkerChanged 。

pointReplaced(int index)

当位于index 指定位置的点被替换时，会触发此信号。

注意： 相应的处理程序 为onPointReplaced 。

[since 6.9] pointsAdded(int start, int end)

当向点列表中追加点时，会触发此信号。新添加点的索引范围在start 到end 之间。

注意： 对应的处理程序 为onPointsAdded 。

该信号在 Qt 6.9 中引入。

pointsReplaced()

当所有点都被替换后，将发出此信号。

注意： 相应的处理程序 为onPointsReplaced 。

pressed(point point)

当用户点击图表中的数据point 并按住鼠标按钮或手势时，会触发此信号。

注意： 对应的处理程序 为onPressed 。

released(point point)

当用户释放之前按下的鼠标按钮或取消数据point 上的手势时，会发出此信号。

注意： 相应的处理程序 为onReleased 。

selectedColorChanged(color color)

当所选序列的颜色变为color 时，会发出此信号。

注意： 对应的处理程序 是onSelectedColorChanged 。

selectedPointsChanged()

当选定点集发生变化时，会触发此信号。

注意： 相应的处理程序 为onSelectedPointsChanged 。

方法文档

void append(list<point> points)

将坐标为points 的数据点追加到序列中。

注意：这 比逐个追加数据点要快得多。数据点添加完成后，将发出pointsAdded 。

void append(point point)

将坐标为point 的点追加到序列中。

void append(real x, real y)

将坐标分别为x 和y 的一个点追加到序列中。

point at(int index)

返回位于index 指定位置的点。如果索引无效，则返回(0, 0)。

void clear()

从序列中删除所有点。

void deselectAllPoints()

取消选中序列中的所有点。

注意：会触发 QXYSeries::selectedPointsChanged

另请参阅 setPointSelected()。

void deselectPoint(int index)

取消选中位于指定坐标index 处的点。

注意：会触发 QXYSeries::selectedPointsChanged

另请参阅 setPointSelected()。

void deselectPoints(list<int> indexes)

将indexes 列表中已通过的多个点标记为“未选中”。

注意：会发出 QXYSeries::selectedPointsChanged

另请参阅 setPointSelected()。

int find(point point)

查找并返回根据point 定义的第一个匹配点的索引。若未找到该点，则返回-1。

void insert(int index, point point)

在序列中，将坐标为point 的点插入到由index 指定的位置。如果索引为0或小于0，则该点被插入到点列表的开头；如果索引等于或大于序列中的点数，则该点被插入到点列表的末尾。

bool isPointSelected(int index)

如果位于给定坐标index 的点在所选点之中，则返回true；否则返回false。

注意： 如果指定了选定 颜色，则选定点 将使用该颜色绘制。

另请参阅 selectedPoints 、setPointSelected() 和selectedColor 。

void remove(int index)

从序列中删除位于index 指定位置的数据点。

void remove(point point)

从序列中移除坐标为point 的点。如果该点不存在，则不执行任何操作。

void remove(real x, real y)

从序列中移除坐标分别为x 和y 的点。如果该点不存在，则不执行任何操作。

void removeMultiple(int index, int count)

从起始位置为index 的序列中，移除由count 指定的点数。

void replace(list<point> points)

用以下内容替换当前的数据点：points

注意：这 比逐个替换数据点，或者先清空所有数据再追加新数据要快得多。当数据点被替换后，会触发pointsReplaced 事件。

void replace(int index, point newPoint)

将位于坐标index 处的点替换为坐标为newPoint 的点。

void replace(point oldPoint, point newPoint)

将坐标为oldPoint 的点替换为坐标为newPoint 的点。如果原点不存在，则不执行任何操作。

void replace(int index, real newX, real newY)

将位于index 所指定位置的点替换为坐标分别为newX 和newY 的点。

void replace(real oldX, real oldY, real newX, real newY)

将坐标为oldX 和oldY 的点替换为坐标为newX 和newY 的点。如果原点不存在，则不执行任何操作。

void selectAllPoints()

将序列中的所有点标记为已选中，

注意：会发出 QXYSeries::selectedPointsChanged

另请参阅 setPointSelected()。

void selectPoint(int index)

将index 标记为已选中。

注意：会发出 QXYSeries::selectedPointsChanged

另请参阅 setPointSelected()。

void selectPoints(list<int> indexes)

将indexes 列表中经过的多个点标记为已选中。

注意：会触发 QXYSeries::selectedPointsChanged

另请参阅 setPointSelected()。

void setPointSelected(int index, bool selected)

根据selected 的设置，将给定坐标index 处的点标记为已选中或未选中。

注意： 如果指定了选中 颜色，则选中 点将使用该颜色绘制。发出QXYSeries::selectedPointsChanged

另请参阅 isPointSelected()、selectAllPoints() 以及selectedColor 。

bool take(point point)

如果找到由point 指定的点，则将其从序列中移除。如果操作成功，则返回true 。

void toggleSelection(list<int> indexes)

将给定indexes 中点的选择状态切换为相反状态。

注意：会触发 QXYSeries::selectedPointsChanged

另请参阅 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.