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 |
- 所有成员列表(包括继承的成员)
- QAbstractSeries 是Qt Graphs 2D C++ 类库的一部分。
公共类型
| 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::Line | 0 | 折线图。 |
QAbstractSeries::SeriesType::Bar | 2 | 条形图。 |
QAbstractSeries::SeriesType::Scatter | 4 | 散点图。 |
QAbstractSeries::SeriesType::Pie | 3 | 饼图。 |
QAbstractSeries::SeriesType::Spline | 5 | 样条图。 |
QAbstractSeries::SeriesType::Area | 1 | 面积图。 |
QAbstractSeries::SeriesType::Custom | 6 | 自定义图表。 |
属性文档
[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.