QAbstractSeries Class
QAbstractSeries 类是所有Qt Graphs 2D 系列的基类。更多
| 头文件： | #include <QAbstractSeries> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake： | QT += graphs |
| 在 QML 中： | AbstractSeries |
| 继承： | QObject 和QQmlParserStatus |
| 继承于 |
- 所有成员的列表，包括继承成员
- QAbstractSeries 是Qt Graphs C++ Classes for 2D 的一部分。
公共类型
| enum class | SeriesType { Line, Bar, Scatter, Pie, Spline, Area } |
属性
|
|
公共功能
| virtual | ~QAbstractSeries() override |
| QGraphsView * | graph() const |
| void | hide() |
| bool | isHoverable() const |
| bool | isSelectable() const |
| bool | isVisible() const |
| const QList<QLegendData> | legendData() const |
| QString | name() const |
| qreal | opacity() const |
| QQmlListProperty<QObject> | seriesChildren() |
| 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 | show() |
| virtual QAbstractSeries::SeriesType | type() const = 0 |
| qreal | valuesMultiplier() const |
信号
| 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 | legendDataChanged() |
| void | nameChanged() |
| void | opacityChanged() |
| void | selectableChanged() |
| void | valuesMultiplierChanged() |
| void | visibleChanged() |
另请参见 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 | 面积图 |
属性文档
hoverable : bool
控制系列是否可悬停。
控制系列是否可以用鼠标/触摸悬停。默认情况下，hoverable 设置为false 。
访问功能：
| bool | isHoverable() const |
| void | setHoverable(bool newHoverable) |
通知信号：
| void | hoverableChanged() |
[read-only] legendData : const 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] 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) |
Notifier 信号：
| void | visibleChanged() |
成员函数 文档
[override virtual noexcept] QAbstractSeries::~QAbstractSeries()
图形系列的虚拟析构函数。
QGraphsView *QAbstractSeries::graph() const
返回序列所属的图表。
系列添加到图形时自动设置，系列从图形中删除时取消设置。
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()。
© 2025 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.
