XYSeries QML Type

线型、样条型和散点型系列的基类型。更多...

此类型已弃用。我们强烈建议不要在新代码中使用它。

• 所有成员的列表（包括继承的成员）

属性

• axisAngular : AbstractAxis
• axisRadial : AbstractAxis
• axisX : AbstractAxis
• axisXTop : AbstractAxis
• axisY : AbstractAxis
• axisYRight : AbstractAxis
• bestFitLineColor : color
• bestFitLineVisible : bool
• color : color
• pointLabelsClipping : bool
• pointLabelsColor : font
• pointLabelsFont : font
• pointLabelsFormat : string
• pointLabelsVisible : bool
• pointsVisible : bool
• selectedColor : color

信号

• clicked(point point)
• doubleClicked(point point)
• hovered(point point, bool state)
• pointAdded(int index)
• pointRemoved(int index)
• pointReplaced(int index)
• pointsRemoved(int index, int count)
• pointsReplaced()
• pressed(point point)
• released(point point)

方法

• void append(real x, real y)
• point at(int index)
• void insert(int index, real x, real y)
• void remove(int index)
• void remove(real x, real y)
• void removePoints(int index, int count)
• void replace(real oldX, real oldY, real newX, real newY)

详细说明

XYSeries 支持在图表上显示最佳拟合线。最佳拟合线是贯穿图表的一条直线，用于表达各数据点之间的关系。

属性文档

axisAngular : AbstractAxis

该系列所使用的角度轴，绘制在极坐标图视图周围。

另请参阅 axisX 。

axisRadial : AbstractAxis

该系列所使用的径向轴，绘制在极坐标图视图内部。

另请参阅 axisY 。

axisX : AbstractAxis

该系列使用的x轴。如果同时未定义axisX和axisXTop ，则会为该系列创建一个数值轴。

另请参阅 axisXTop 和ValueAxis 。

axisXTop : AbstractAxis

绘制在图表视图顶部的、用于该数据系列的x轴。

另请参阅 axisX 。

axisY : AbstractAxis

该系列使用的 y 轴。如果同时未定义 axisY 和axisYRight ，则会为该系列创建一个数值轴。

另请参阅 axisYRight 和ValueAxis 。

axisYRight : AbstractAxis

该数据系列所用的y轴，在图表视图中向右绘制。

另请参阅 axisY 。

bestFitLineColor : color

最佳拟合直线的颜色。

另请参阅 bestFitLineVisible 。

bestFitLineVisible : bool

最佳拟合线的可见性。该属性的默认值为false 。

color : color

系列的颜色。对于 LineSeries 或 SplineSeries，这是线条（笔）颜色；对于 ScatterSeries 或 AreaSeries，则是填充（笔触）颜色。

pointLabelsClipping : bool

数据点标签的裁剪设置。该属性默认值为true 。启用裁剪后，绘图区域边缘处的标签将被裁剪。

另请参阅 pointLabelsVisible 。

pointLabelsColor : font

数据点标签所用的颜色。默认情况下，该颜色即主题中为标签定义的画笔颜色。

另请参阅 pointLabelsFormat 。

pointLabelsFont : font

用于数据点标签的字体。

另请参阅 pointLabelsFormat 。

pointLabelsFormat : string

用于显示带数据点的标签的格式。

另请参阅 pointLabelsVisible 、pointLabelsFont 以及pointLabelsColor 。

pointLabelsVisible : bool

数据点标签的可见性。该属性默认false 。

另请参阅 pointLabelsFormat 和pointLabelsClipping 。

pointsVisible : bool

数据点是否可见以及是否应被绘制。

selectedColor : color

选中点的颜色。这是标记为选中的点的填充（画笔）颜色。如果未指定，则默认使用QXYSeries::color 的值。

另请参阅 color 。

Signal 文档

clicked(point point)

当用户通过单击图表中的点point 触发鼠标事件时，会发出此信号。例如：

LineSeries {
    XYPoint { x: 0; y: 0 }
    XYPoint { x: 1.1; y: 2.1 }
    onClicked: console.log("onClicked: " + point.x + ", " + point.y);
}

相应的信号处理函数为onClicked() 。

另请参阅 pressed()、released() 和doubleClicked()。

doubleClicked(point point)

当用户双击图表中的数据点point 时，会触发此信号。point 表示首次点击触发的坐标点。例如：

LineSeries {
    XYPoint { x: 0; y: 0 }
    XYPoint { x: 1.1; y: 2.1 }
    onDoubleClicked: console.log("onDoubleClicked: " + point.x + ", " + point.y);
}

相应的信号处理程序是onDoubleClicked() 。

另请参阅 pressed()、released() 和clicked()。

hovered(point point, bool state)

当鼠标悬停在图表中的point 点上时，会触发此信号。当鼠标移到该点上时，state 会变为true ；当鼠标再次移开时，它会变为false 。

相应的信号处理程序是onHovered() 。

pointAdded(int index)

当在index 指定的位置添加一个点时，会触发此信号。

相应的信号处理程序为onPointAdded() 。

pointRemoved(int index)

当从index 指定的位置移除一个点时，会触发此信号。

相应的信号处理程序为onPointRemoved() 。

pointReplaced(int index)

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

相应的信号处理程序为onPointReplaced() 。

pointsRemoved(int index, int count)

当从index 指定的位置开始，移除了count 指定的点数时，会触发此信号。

相应的信号处理程序为onPointRemoved() 。

pointsReplaced()

当所有点都被其他点替换时，会触发此信号。

相应的信号处理程序为onPointsReplaced() 。

pressed(point point)

当用户在图表中点击数据点point 并按住鼠标按钮时，会触发此信号。例如：

LineSeries {
    XYPoint { x: 0; y: 0 }
    XYPoint { x: 1.1; y: 2.1 }
    onPressed: console.log("onPressed: " + point.x + ", " + point.y);
}

相应的信号处理程序为onPressed() 。

另请参阅 clicked()、released() 和doubleClicked()。

released(point point)

当用户松开鼠标按钮，且该按钮位于由 `point` 指定的数据点上时，会触发此信号。例如：

LineSeries {
    XYPoint { x: 0; y: 0 }
    XYPoint { x: 1.1; y: 2.1 }
    onReleased: console.log("onReleased: " + point.x + ", " + point.y);
}

相应的信号处理程序为onReleased() 。

另请参阅 pressed()、clicked() 和doubleClicked()。

方法文档

void append(real x, real y)

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

point at(int index)

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

void insert(int index, real x, real y)

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

void remove(int index)

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

void remove(real x, real y)

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

void removePoints(int index, int count)

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

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

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