本页内容

QAbstractSeries Class

QAbstractSeries 类是所有二维序列的Qt Graphs 的基类。更多内容...

头文件: #include <QAbstractSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
在 QML 中: AbstractSeries
继承自:QObject 以及QQmlParserStatus
被继承类:

QAreaSeries、QBarSeries 、QCustomSeries 、QPieSeries ,以及QXYSeries

公共类型

enum class SeriesType { Line, Bar, Scatter, Pie, Spline, …, Custom }

属性

公共函数

virtual ~QAbstractSeries() override
QAbstractAxis *axisX() const
QAbstractAxis *axisY() const
void hide()
bool isHoverable() const
bool isHovered() const
bool isSelectable() const
bool isVisible() const
const QList<QLegendData> legendData() const
QString name() const
qreal opacity() const
QQmlListProperty<QObject> seriesChildren()
void setAxisX(QAbstractAxis *newAxisX)
void setAxisY(QAbstractAxis *newAxisY)
void setHoverable(bool newHoverable)
void setName(const QString &name)
void setOpacity(qreal opacity)
void setSelectable(bool selectable)
void setValuesMultiplier(qreal valuesMultiplier)
void setVisible(bool visible = true)
void setZValue(int newDrawOrder)
void show()
virtual QAbstractSeries::SeriesType type() const = 0
qreal valuesMultiplier() const
int zValue() const

信号

void axisXChanged(QAbstractAxis *newAxis)
void axisYChanged(QAbstractAxis *newAxis)
void hover(const QString &seriesName, QPointF position, QPointF value)
void hoverEnter(const QString &seriesName, QPointF position, QPointF value)
void hoverExit(const QString &seriesName, QPointF position)
void hoverableChanged()
void hoveredChanged(bool hovered)
void legendDataChanged()
void nameChanged()
void opacityChanged()
void selectableChanged()
void valuesMultiplierChanged()
void visibleChanged()
void zValueChanged(int z)

详细说明

通常,会使用特定于序列类型的派生类,而不是基类。

另请参阅 QLineSeries 、QSplineSeries 、QScatterSeries 、QBarSeries 以及QXYSeries 。

成员类型文档

enum class QAbstractSeries::SeriesType

此枚举描述了序列的类型。

常量值描述
QAbstractSeries::SeriesType::Line0折线图。
QAbstractSeries::SeriesType::Bar2条形图。
QAbstractSeries::SeriesType::Scatter4散点图。
QAbstractSeries::SeriesType::Pie3饼图。
QAbstractSeries::SeriesType::Spline5样条图。
QAbstractSeries::SeriesType::Area1面积图。
QAbstractSeries::SeriesType::Custom6自定义图表。

属性文档

[since 6.10] axisX : QAbstractAxis*

该数据系列的X轴。

该数据系列所使用的 x 轴。它会创建一个与通过 `GraphsView ` 定义的轴不同的独立轴,从而向用户展示每个图表中的多个轴。

该枚举类型在 Qt 6.10 中引入。

访问函数:

QAbstractAxis *axisX() const
void setAxisX(QAbstractAxis *newAxisX)

通知器信号:

void axisXChanged(QAbstractAxis *newAxis)

[since 6.10] axisY : QAbstractAxis*

该数据系列的Y轴。

该数据系列所使用的 y 轴。它会创建一个与 `GraphsView ` 中定义的轴不同的独立轴,从而向用户展示每个图表中的多个轴。

该枚举类型在 Qt 6.10 中引入。

访问函数:

QAbstractAxis *axisY() const
void setAxisY(QAbstractAxis *newAxisY)

通知器信号:

void axisYChanged(QAbstractAxis *newAxis)

hoverable : bool

控制该系列是否支持悬停。

控制数据系列是否支持鼠标/触摸悬停。默认情况下,hoverable 的值设置为false 。

访问函数:

bool isHoverable() const
void setHoverable(bool newHoverable)

通知信号:

void hoverableChanged()

[read-only] hovered : bool

检查鼠标是否悬停在某个系列上。

可用于检查鼠标或触摸指针当前是否悬停在某个系列上。

访问函数:

bool isHovered() const

通知信号:

void hoveredChanged(bool hovered)

另请参阅 QAbstractSeries ::hovered。

[read-only] legendData : QList<QLegendData>

包含为图表中的数据集创建图例标记所需的信息。

访问函数:

const QList<QLegendData> legendData() const

通知信号:

void legendDataChanged()

另请参阅 QLegendData 。

name : QString

该属性存储了数据系列名称。

该名称将显示在该系列的图例中,并支持 HTML 格式化。

访问函数:

QString name() const
void setName(const QString &name)

通知信号:

void nameChanged()

opacity : qreal

该属性用于设置系列的不透明度。

默认情况下,不透明度为 1.0。有效值范围为 0.0(透明)到 1.0(不透明)。

访问函数:

qreal opacity() const
void setOpacity(qreal opacity)

通知信号:

void opacityChanged()

selectable : bool

控制该系列是否可选。

控制该系列是否可通过鼠标/触摸进行选择。默认情况下,selectable 设置为false 。

访问函数:

bool isSelectable() const
void setSelectable(bool selectable)

通知信号:

void selectableChanged()

[read-only] seriesChildren : const QQmlListProperty<QObject>

系列子对象的列表。这是一个默认属性,允许在 QML 的系列元素中指定子对象,而无需显式使用 children 属性名。

访问函数:

QQmlListProperty<QObject> seriesChildren()

[read-only] type : const SeriesType

该属性存储序列的类型。

访问函数:

virtual QAbstractSeries::SeriesType type() const = 0

valuesMultiplier : qreal

控制系列值的实际显示值。

该变量可用于对系列值进行动画处理,使其按比例从 0 缩放至实际值大小。默认情况下,valuesMultiplier 的值为 1.0。有效值范围为 0.0(高度为 0)到 1.0(全值)。

访问函数:

qreal valuesMultiplier() const
void setValuesMultiplier(qreal valuesMultiplier)

通知信号:

void valuesMultiplierChanged()

visible : bool

该系列的可见性。

此系列所使用的可见性设置。默认情况下,visible 被设置为true 。

访问函数:

bool isVisible() const
void setVisible(bool visible = true)

通知信号:

void visibleChanged()

[since 6.10] zValue : int

控制系列绘制的顺序

GraphsView 的系列列表按 zValue 属性进行排序。由于每种系列类型都会一次性渲染,因此该顺序主要作为每种系列类型的内部顺序起作用。每种系列类型中 zValue 值最大的那个决定该系列类型在所有系列类型中的渲染顺序。默认值为 0。

该枚举在 Qt 6.10 中引入。

访问函数:

int zValue() const
void setZValue(int newDrawOrder)

通知器信号:

void zValueChanged(int z)

成员函数文档

[override virtual noexcept] QAbstractSeries::~QAbstractSeries()

图序列的虚拟析构函数。

void QAbstractSeries::hide()

将该系列的可见性设置为false 。

另请参阅 setVisible() 和isVisible()。

[signal] void QAbstractSeries::hover(const QString &seriesName, QPointF position, QPointF value)

当系列悬停状态发生变化时,会触发此信号。系列名称位于seriesName 中,鼠标/触摸位置位于position 中,系列值位于value 中。

注意: 仅当hoverable 设置为 true 时,才会发出此 信号。

注意:对于 饼图,该值表示(位置角度,悬停扇区的起始角度)

[signal] void QAbstractSeries::hoverEnter(const QString &seriesName, QPointF position, QPointF value)

当系列悬停开始时,会发出此信号。系列的名称存储在seriesName 中,鼠标/触摸位置存储在position 中,系列值存储在value 中。

注意: 仅当hoverable 设置为 true 时,才会发出此 信号。

注意:对于 饼图,该值表示(位置角度,悬停扇区的起始角度)

[signal] void QAbstractSeries::hoverExit(const QString &seriesName, QPointF position)

当系列悬停结束时,会触发此信号。系列名称存储在seriesName 中,鼠标/触摸位置存储在position 中。

注意: 仅当hoverable 设置为 true 时,才会发出此 信号。

void QAbstractSeries::show()

将该系列的状态设置为“true ”。

另请参阅 setVisible() 和isVisible()。

© 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.