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)

将数据点point 插入到序列中，位置由index 指定。

另请参阅 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.0，QLineSeries的默认值为序列笔大小乘以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)

将oldPoint 指定的点替换为newPoint 指定的点。

另请参阅 pointReplaced()。

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

将位于index 指定位置的点替换为newPoint 指定的点。

另请参阅 pointReplaced()。

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

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

另请参阅 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()。

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

当选中点的颜色变为color 时，会发出此信号。

[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);

在此示例中，您可以看到一个包含 10 个点的默认 QLineSeries，其中两个点的配置已被修改。这两个被修改的点在视觉上明显比其他点更大，其外观源自系列配置。默认情况下，点没有标签，但索引为 4 的点由于QXYSeries::PointConfiguration::LabelVisibility 和QXYSeries::PointConfiguration::LabelFormat 配置值而拥有标签。 索引为 6 的数据点通过QXYSeries::PointConfiguration::LabelFormat 配置值，显示了自定义标签“This Point”。以下是按此方式创建的图表示例：

该函数在 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()。