QXYSeries 类

成员函数文档

[虚拟 noexcept] QXYSeries::~QXYSeries()

删除系列。添加到 QChart 实例中的系列属于它们，当 QChart 实例被删除时，这些系列也会被删除。

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

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

void QXYSeries::append(const QPointF &point)

这是一个重载函数。

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

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

这是一个重载函数。

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

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

返回在点系列内部由 index 指定的位置的数据点。

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

当用于最佳拟合线的颜色变为 color 时发出此信号。

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

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

这些因素是基于传递给系列的点使用最小二乘法计算的。

参数 ok 用于通过将其值设置为 false 来报告失败，并将其值设置为 true 来报告成功。

此函数是在 Qt 6.2 中引入的。

另请参阅 QXYSeries::bestFitLineVisible()。

[信号] void QXYSeries::bestFitLineVisibilityChanged(bool visible)

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

QBrush QXYSeries::brush() const

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

另请参阅 setBrush()。

void QXYSeries::clear()

从系列中删除所有点。

另请参阅 pointsRemoved()。

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

移除位于索引 index 的点配置，并将外观恢复为从系列设置中派生的默认外观。

此函数是在 Qt 6.2 中引入的。

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

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

从索引 index 的点中移除由 key 标识的配置属性，并将外观恢复为从系列设置中派生的默认外观。

从索引 index 的点中移除由 key 指定的配置类型（如颜色或大小）的配置自定义，允许该配置属性以系列属性中指定的默认值呈现。

此函数是在 Qt 6.2 中引入的。

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

[自6.2起] void QXYSeries::clearPointsConfiguration()

移除系列中所有点的配置，并将外观恢复为从系列设置中派生的默认外观。

此函数是在 Qt 6.2 中引入的。

另请参阅：setPointConfiguration()。

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

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

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

此函数是在 Qt 6.2 中引入的。

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

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

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

另请参阅：pressed()，released() 和 doubleClicked()。

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

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

如果系列附加了 QColorAxis，则将使用轴的渐变。

此函数是在 Qt 6.2 中引入的。

另请参阅：setPointConfiguration()，pointConfiguration() 和 QColorAxis()。

[信号] void QXYSeries::colorChanged(QColor color)

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

int QXYSeries::count() const

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

[自6.2以来] void QXYSeries::deselectAllPoints()

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

此函数是在 Qt 6.2 中引入的。

另请参阅：setPointSelected()。

[自6.2以来] void QXYSeries::deselectPoint(int index)

取消选择给定索引的点。

此函数是在 Qt 6.2 中引入的。

另请参阅：setPointSelected()。

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

将出现在indexes列表中的多个点标记为未选择。

此函数是在 Qt 6.2 中引入的。

另请参阅：setPointSelected()。

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

当用户在图表中双击数据点point时，将发出此信号。该point是首次按下触发的地方。

另请参阅：pressed()，released()，以及clicked()。

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

当鼠标悬停在图表中的点point上方时，将发出此信号。当鼠标移动到点上时，state变为true，当鼠标再次移开时，它变为false。

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

在由index指定的位置插入数据点point到系列中。

另请参阅：pointAdded()。

[自6.2以来] bool QXYSeries::isPointSelected(int index)

如果给定索引的点属于所选点，则返回true，否则返回false。

此函数是在 Qt 6.2 中引入的。

另请参阅：selectedPoints()，setPointSelected()，以及setSelectedColor()。

[自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时，会发出此信号。

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

当数据点标签的颜色更改为 color 时发出此信号。

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

当数据点标签的字体更改为 font 时发出此信号。

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

当数据点标签的格式更改为 format 时发出此信号。

[信号] void QXYSeries::pointLabelsVisibilityChanged(bool visible)

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

[信号] void QXYSeries::pointRemoved(int index)

当从指定位置 index 删除点时发出此信号。

另请参阅：remove()。

[信号] void QXYSeries::pointReplaced(int index)

当在指定位置 index 替换点时发出此信号。

另请参阅：replace()。

QList<QPointF> QXYSeries::points() const

返回系列中的点。

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

返回一个映射，其中点的索引作为键，点的配置作为值。

此函数是在 Qt 6.2 中引入的。

另请参阅：setPointsConfiguration()，setPointConfiguration() 以及 pointConfiguration()。

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

从指定位置 index 开始删除指定数量 count 的点时发出此信号。

另请参阅：removePoints() 以及 clear()。

[信号] void QXYSeries::pointsReplaced()

当所有点都替换为其他点时，将发出此信号。

另请参阅：replace()。

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

当用户在图表中按下数据点 point 并按住鼠标按钮时，将发出此信号。

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

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

当用户释放指定的 point 数据点的鼠标按下时，将发出此信号。

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

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

从系列中删除具有坐标 x 和 y 的点。

另请参阅pointRemoved()。

void QXYSeries::remove(const QPointF &point)

从系列中删除数据点 point。

另请参阅pointRemoved()。

void QXYSeries::remove(int index)

从系列中删除位置由 index 指定的点。

另请参阅pointRemoved()。

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

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

另请参阅 pointsRemoved()。

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

用具有坐标 oldX 和 oldY 的点替换该点。如果旧点不存在，则不执行任何操作。

另请参阅pointReplaced()。

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

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

另请参阅pointReplaced()。

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

将位置由 index 指定的点替换为具有坐标 newX 和 newY 的点。

另请参阅pointReplaced()。

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

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

另请参阅pointReplaced()。

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

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

另请参阅：pointsReplaced()。

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

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

默认大小为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的点的外观。

使用点配置，您可以更改每个点外观的各种方面。

点的配置表示为具有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配置值而具有标签。以下是以这种方式创建的图表的示例

此函数是在 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。

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

将指定 索引 处的点标记为所选或未选中，具体取决于 selected。

此函数是在 Qt 6.2 中引入的。

另请参阅isPointSelected、setPointSelected 和 setSelectedColor。

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

启用根据 pointsConfiguration 指定的方式自定义多个点的配置。

此函数是在 Qt 6.2 中引入的。

另请参阅pointsConfiguration。

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

设置用于绘制选定系列点标记的图像为 selectedLightMarker。

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

如果你偏好轻标记而不是正常点，但仍想区分所选点，则这是一个与 selectedColor 相等的选项。

此函数是在 Qt 6.2 中引入的。

另请参阅selectedLightMarker、lightMarker、selectedColor 和 setPointSelected。

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

根据传递的值列表设置点的尺寸。从 sourceData 获取的值排序并映射到在 minSize 和 maxSize 之间的点大小。

此函数是在 Qt 6.2 中引入的。

另请参阅setPointConfiguration 和 pointConfiguration。

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

将指定 indexes 处的点选择状态切换到相反的状态。

此函数是在 Qt 6.2 中引入的。

另请参阅：setPointSelected()。

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

将数据点point添加到系列中的流操作符。

另请参阅append()。

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

将指定由points指定的数据点列表添加到系列中的流操作符。

另请参阅append()。