QXYSeries Class

成员函数文档

[virtual noexcept] QXYSeries::~QXYSeries()

删除系列。添加到QChart 实例的系列为这些实例所有，并在删除QChart 实例时被删除。

void QXYSeries::append(qreal x, qreal y)

将坐标为x 和y 的数据点添加到序列中。

void QXYSeries::append(const QList<QPointF> &points)

这是一个重载函数。

将points 指定的数据点列表添加到序列中。

void QXYSeries::append(const QPointF &point)

这是一个重载函数。

将数据点point 添加到序列中。

const QPointF &QXYSeries::at(int index) const

返回内部点序列中index 指定位置上的数据点。

[signal] void QXYSeries::bestFitLineColorChanged(const QColor &color)

当最佳拟合线使用的颜色更改为color 时，将发出该信号。

[since 6.2] QPair<qreal, qreal> QXYSeries::bestFitLineEquation(bool &ok) const

返回一对数字，其中第一个数字是斜率因子，第二个数字是最佳拟合线的线性函数截距。

这些因子是根据传递给序列的点使用最小二乘法计算得出的。

参数ok 用于报告失败，将其值设为false ；报告成功，将其值设为true 。

此函数在 Qt 6.2 中引入。

另请参阅 QXYSeries::bestFitLineVisible()。

[signal] void QXYSeries::bestFitLineVisibilityChanged(bool visible)

当最佳拟合线的可见性变为visible 时，将发出该信号。

QBrush QXYSeries::brush() const

返回用于填充系列数据点的笔刷。

另请参阅 setBrush()。

void QXYSeries::clear()

删除系列中的所有点。

另请参见 pointsRemoved().

[since 6.2] void QXYSeries::clearPointConfiguration(const int index)

删除位于index 的点的配置，并恢复从系列设置中导出的默认外观。

此函数在 Qt 6.2 中引入。

另请参阅 clearPointsConfiguration() 和setPointConfiguration()。

[since 6.2] void QXYSeries::clearPointConfiguration(const int index, const QXYSeries::PointConfiguration key)

从index 点移除key 标识的配置属性，并恢复从系列设置中导出的默认外观。

从index 的点移除key 指定的配置类型（如颜色或大小），并进行配置自定义，使该配置属性呈现为系列属性中指定的默认值。

此功能在 Qt 6.2 中引入。

另请参阅 clearPointsConfiguration() 和setPointConfiguration()。

[since 6.2] void QXYSeries::clearPointsConfiguration()

删除系列中所有点的配置，并恢复从系列设置导出的默认外观。

此函数在 Qt 6.2 中引入。

另请参阅 setPointConfiguration()。

[since 6.2] void QXYSeries::clearPointsConfiguration(const QXYSeries::PointConfiguration key)

从所有点中移除由key 标识的配置属性，并恢复由系列设置导出的默认外观。

从所有具有自定义配置的点中移除由key 指定的配置类型（如颜色或大小），允许将该配置属性渲染为系列属性中指定的默认值。

此函数在 Qt 6.2 中引入。

另请参阅 clearPointsConfiguration() 和setPointConfiguration()。

[signal] void QXYSeries::clicked(const QPointF &point)

当用户通过点击图表中的点point 来触发鼠标事件时，就会发出该信号。

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

[since 6.2] void QXYSeries::colorBy(const QList<qreal> &sourceData, const QLinearGradient &gradient = QLinearGradient())

根据传递的数值列表设置点的颜色。sourceData 中的值会排序并映射到gradient 中。

如果序列附加了QColorAxis ，则将使用坐标轴的梯度。

此函数在 Qt 6.2 中引入。

另请参阅 setPointConfiguration(),pointConfiguration() 和QColorAxis 。

[signal] void QXYSeries::colorChanged(QColor color)

当线条（笔）颜色变为color 时，将发出该信号。

int QXYSeries::count() const

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

[since 6.2] void QXYSeries::deselectAllPoints()

取消选择系列中的所有点。

此函数在 Qt 6.2 中引入。

另请参阅 setPointSelected().

[since 6.2] void QXYSeries::deselectPoint(int index)

取消选择index 上的点。

此函数在 Qt 6.2 中引入。

另请参阅 setPointSelected() 。

[since 6.2] void QXYSeries::deselectPoints(const QList<int> &indexes)

将indexes 列表中传递的多个点标记为取消选择。

此函数在 Qt 6.2 中引入。

另请参阅 setPointSelected()。

[signal] void QXYSeries::doubleClicked(const QPointF &point)

当用户双击图表中的数据点point 时，就会发出该信号。point 是第一次按下的触发点。

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

[signal] void QXYSeries::hovered(const QPointF &point, bool state)

当鼠标悬停在图表中的点point 上时，就会发出该信号。当鼠标移动到该点时，state 变成true ，当鼠标再次移开时，变成false 。

void QXYSeries::insert(int index, const QPointF &point)

在index 指定的位置插入数据点point 。

另请参阅 pointAdded() 。

[since 6.2] bool QXYSeries::isPointSelected(int index)

如果index 处的点属于选中点，则返回 true，否则返回 false。

此函数在 Qt 6.2 中引入。

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

[since 6.2] const QImage &QXYSeries::lightMarker() const

获取用于在序列的每个点上绘制标记的图像。

默认值为 QImage()，这意味着不会绘制光标记。

灯光标记使该序列的数据点可视化，因此是setPointsVisible （true）的替代功能。这两种功能可以单独启用。

与QScatterSeries 的元素不同，灯光标记不是由QGraphicsItem 表示，而是直接绘制（不创建对象）。但是，QXYSeries 的鼠标事件信号的行为方式是相同的，也就是说，如果点击/按下/悬停灯光标记，就会得到该点的精确域值。如果点击线条，您仍然可以获得介于两者之间的域值。就绘制和事件而言，灯光标记高于线条。

此函数在 Qt 6.2 中引入。

另请参阅 QXYSeries::setLightMarker()。

[signal, since 6.2] void QXYSeries::lightMarkerChanged(const QImage &lightMarker)

当灯光标记图像变为lightMarker 时，将发出该信号。

此函数在 Qt 6.2 中引入。

另请参阅 QXYSeries::setLightMarker() 。

[since 6.2] qreal QXYSeries::markerSize() const

获取用于渲染系列中点的标记大小。

默认大小取决于特定的QXYSeries 类型。QScatterSeries 的默认大小为 15.0QLineSeries 的默认大小为系列笔大小 * 1.5

此函数在 Qt 6.2 中引入。

另请参阅 setMarkerSize() 和QScatterSeries::markerSize 。

[signal] void QXYSeries::markerSizeChanged(qreal size)

当标记大小变为size 时，将发出该信号。

QPen QXYSeries::pen() const

返回用于绘制序列数据点轮廓的笔。

另请参阅 setPen()。

[signal] void QXYSeries::penChanged(const QPen &pen)

当笔变为pen 时，就会发出该信号。

[signal] void QXYSeries::pointAdded(int index)

在index 指定的位置添加一个点时，会发出该信号。

另请参阅 append() 和insert() 。

[since 6.2] QHash<QXYSeries::PointConfiguration, QVariant> QXYSeries::pointConfiguration(const int index) const

返回表示index 上一个点的配置的地图。

通过点配置，您可以改变每个点外观的各个方面。

此函数在 Qt 6.2 中引入。

另请参阅 setPointConfiguration().

[signal] void QXYSeries::pointLabelsClippingChanged(bool clipping)

当数据点标签的剪切更改为clipping 时，将发出该信号。

[signal] void QXYSeries::pointLabelsColorChanged(const QColor &color)

当数据点标签使用的颜色更改为color 时，将发出该信号。

[signal] void QXYSeries::pointLabelsFontChanged(const QFont &font)

当数据点标签使用的字体更改为font 时，将发出该信号。

[signal] void QXYSeries::pointLabelsFormatChanged(const QString &format)

当数据点标签格式更改为format 时，将发出该信号。

[signal] void QXYSeries::pointLabelsVisibilityChanged(bool visible)

当数据点标签的可见性更改为visible 时，将发出该信号。

[signal] void QXYSeries::pointRemoved(int index)

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

另请参见 remove().

[signal] void QXYSeries::pointReplaced(int index)

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

另请参见 replace().

QList<QPointF> QXYSeries::points() const

返回系列中的点数。

[since 6.2] QXYSeries::PointsConfigurationHash QXYSeries::pointsConfiguration() const

返回以点索引为键、点配置为值的映射。

此函数在 Qt 6.2 中引入。

另请参阅 setPointsConfiguration()、setPointConfiguration() 和pointConfiguration()。

[signal] void QXYSeries::pointsRemoved(int index, int count)

当从index 指定的位置开始移除count 指定的点数时，将发出该信号。

另请参见 removePoints() 和clear()。

[signal] void QXYSeries::pointsReplaced()

当所有点都被其他点替换时，就会发出该信号。

另请参见 replace().

[signal] void QXYSeries::pressed(const QPointF &point)

当用户按下图表中的数据点point 并按住鼠标键时，就会发出该信号。

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

[signal] void QXYSeries::released(const QPointF &point)

当用户在point 指定的数据点上松开鼠标时，就会发出该信号。

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

void QXYSeries::remove(const QPointF &point)

从序列中删除数据点point 。

另请参见 pointRemoved().

void QXYSeries::remove(int index)

从序列中删除index 指定位置上的点。

另请参见 pointRemoved().

void QXYSeries::remove(qreal x, qreal y)

从序列中删除坐标为x 和y 的点。

另请参见 pointRemoved().

void QXYSeries::removePoints(int index, int count)

从index 指定的位置开始，从数列中删除count 指定的点数。

另请参见 pointsRemoved().

void QXYSeries::replace(const QList<QPointF> &points)

用points 指定的点替换当前点。

另请参阅 pointsReplaced() 。

void QXYSeries::replace(const QPointF &oldPoint, const QPointF &newPoint)

用newPoint 指定的点替换oldPoint 指定的点。

另请参见 pointReplaced().

void QXYSeries::replace(int index, const QPointF &newPoint)

用newPoint 指定的点替换index 指定位置上的点。

另请参见 pointReplaced().

void QXYSeries::replace(int index, qreal newX, qreal newY)

用坐标为newX 和newY 的点替换index 指定位置上的点。

另请参见 pointReplaced().

void QXYSeries::replace(qreal oldX, qreal oldY, qreal newX, qreal newY)

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

另请参见 pointReplaced().

[since 6.2] void QXYSeries::selectAllPoints()

将系列中的所有点标记为选中点、

此函数在 Qt 6.2 中引入。

另请参阅 setPointSelected()。

[since 6.2] void QXYSeries::selectPoint(int index)

将index 上的点标记为选定点。

此函数在 Qt 6.2 中引入。

另请参阅 setPointSelected().

[since 6.2] void QXYSeries::selectPoints(const QList<int> &indexes)

将indexes 列表中传递的多个点标记为选中点。

此函数在 Qt 6.2 中引入。

另请参阅 setPointSelected()。

[since 6.2] const QImage &QXYSeries::selectedLightMarker() const

返回用于在所选序列点上绘制标记的图像。

默认值是 QImage()，这意味着将绘制通常的lightMarker()。

如果您更喜欢浅色标记而非正常点，但仍希望区分选中的点，则此函数等同于selectedColor 。

此函数在 Qt 6.2 中引入。

另请参阅 setSelectedLightMarker(),lightMarker(),selectedColor, 和setPointSelected() 。

[since 6.2] QList<int> QXYSeries::selectedPoints() const

返回标记为选中的点索引列表。无论点的可见性如何，被选中的点都是可见的。

此函数在 Qt 6.2 中引入。

另请参阅 setPointSelected() 和pointsVisible()。

[signal] void QXYSeries::selectedPointsChanged()

当点的选择发生变化时会发出该信号。

[virtual] void QXYSeries::setBrush(const QBrush &brush)

将用于在图表上绘制点的画笔设置为brush 。如果未定义画笔，则使用图表主题设置中的画笔。

另请参阅 brush() 和QChart::setTheme()。

[since 6.2] void QXYSeries::setLightMarker(const QImage &lightMarker)

设置用于在序列的每个点上绘制标记的图像，即lightMarker 的值。

默认值是默认 QImage() (QImage::isNull() == true)，这意味着不会绘制光标记。您可以使用空值QImage (QImage()) 调用此函数，重置回默认值（禁用）。

灯光标记可视化该系列的数据点，因此是setPointsVisible(true) 的替代方法。如果使用该方法设置了灯光标记，则不会显示setPointsVisible(true) 设置的可见点。

与QScatterSeries 的元素不同，光标不是由QGraphicsItem 表示的，而只是绘制的（没有创建对象）。但是，QXYSeries 的鼠标事件信号的行为方式是相同的，也就是说，如果您点击/按下/悬停灯光标记，您将获得该点的精确域值。如果点击线条，您仍然可以获得介于两者之间的域值。就绘制和事件而言，灯光标记高于线条。

此函数在 Qt 6.2 中引入。

另请参阅 QXYSeries::lightMarker()。

[since 6.2] void QXYSeries::setMarkerSize(qreal size)

设置用于渲染系列中点的标记的size 。

默认大小为 15.0。

此函数在 Qt 6.2 中引入。

另请参阅 QScatterSeries::markerSize 。

[virtual] void QXYSeries::setPen(const QPen &pen)

将用于在图表上绘制点的笔设置为pen 。如果未定义笔，则使用图表主题中的笔。

另请参阅 pen() 和QChart::setTheme()。

[since 6.2] void QXYSeries::setPointConfiguration(const int index, const QHash<QXYSeries::PointConfiguration, QVariant> &configuration)

可自定义位于index 的点的外观，所需的configuration 。

通过点配置，您可以更改每个点外观的各个方面。

点的配置以哈希图的形式表示，哈希图的键为QXYSeries::pointConfiguration ，值为QVariant 。例如

QLineSeries *series = new QLineSeries();
series->setName("Customized series");
series->setPointsVisible(true);

*series << QPointF(0, 6) << QPointF(2, 4) << QPointF(3, 6) << QPointF(7, 4) << QPointF(10, 5)
        << QPointF(11, 1) << QPointF(13, 3) << QPointF(17, 6) << QPointF(18, 3)
        << QPointF(20, 2);

QChart *chart = new QChart();
chart->addSeries(series);
chart->createDefaultAxes();

QHash<QXYSeries::PointConfiguration, QVariant> conf;
conf[QXYSeries::PointConfiguration::Color] = QColor(Qt::red);
conf[QXYSeries::PointConfiguration::Size] = 8;
conf[QXYSeries::PointConfiguration::LabelVisibility] = true;

series->setPointConfiguration(4, conf);

conf.remove(QXYSeries::PointConfiguration::Color);
conf[QXYSeries::PointConfiguration::LabelFormat] = "This Point";
series->setPointConfiguration(6, conf);

在此示例中，您可以看到QLineSeries 的默认配置为 10 个点，而更改配置后的配置为 2 个点。更改后的两个点都明显比其他点大，其外观来自系列配置。默认情况下，点没有标签，但由于QXYSeries::PointConfiguration::LabelVisibility 和QXYSeries::PointConfiguration::LabelFormat 的配置值，位于索引 4 的点有了标签。索引 6 处的点有一个自定义标签 "This Point"，这要归功于QXYSeries::PointConfiguration::LabelFormat 配置值。下面是以这种方式创建的图表示例：

该功能在 Qt 6.2 中引入。

另请参阅 pointConfiguration(),pointsConfiguration() 和clearPointsConfiguration()。

[since 6.2] void QXYSeries::setPointConfiguration(const int index, const QXYSeries::PointConfiguration key, const QVariant &value)

可自定义点配置的特定方面。

此函数在 Qt 6.2 中引入。

另请参阅 pointsConfiguration()。

[since 6.2] void QXYSeries::setPointSelected(int index, bool selected)

根据selected 的指定，将给定index 处的点标记为选中或取消选择。

此函数在 Qt 6.2 中引入。

另请参阅 isPointSelected(), setPointSelected() 和setSelectedColor() 。

[since 6.2] void QXYSeries::setPointsConfiguration(const QHash<int, QHash<QXYSeries::PointConfiguration, QVariant>> &pointsConfiguration)

可对pointsConfiguration 指定的多个点进行自定义配置。

此函数在 Qt 6.2 中引入。

另请参阅 pointsConfiguration()。

[since 6.2] void QXYSeries::setSelectedLightMarker(const QImage &selectedLightMarker)

将用于在所选系列点上绘制标记的图像设置为selectedLightMarker 。

默认值为 QImage()，这意味着将绘制通常的lightMarker()。

如果您偏好浅色标记而非普通点，但仍希望区分选中的点，则此函数等同于selectedColor 。

此函数在 Qt 6.2 中引入。

另请参阅 selectedLightMarker(),lightMarker(),selectedColor, 和setPointSelected().

[since 6.2] void QXYSeries::sizeBy(const QList<qreal> &sourceData, const qreal minSize, const qreal maxSize)

根据传递的数值列表设置点的大小。sourceData 中的值会进行排序，并映射到介于minSize 和maxSize 之间的点尺寸。

此函数在 Qt 6.2 中引入。

另请参阅 setPointConfiguration() 和pointConfiguration()。

[since 6.2] void QXYSeries::toggleSelection(const QList<int> &indexes)

将indexes 上给定点的选择状态更改为相反状态。使

此函数在 Qt 6.2 中引入。

另请参阅 setPointSelected()。

QXYSeries &QXYSeries::operator<<(const QList<QPointF> &points)

流运算符，用于将points 指定的数据点列表添加到序列中。

另请参见 append().

QXYSeries &QXYSeries::operator<<(const QPointF &point)

流运算符，用于将数据点point 添加到序列中。

另请参见 append()。