QAbstractSeries类
QAbstractSeries类是所有Qt图表系列的基类。更多信息...
| 头文件 | #include <QAbstractSeries> |
| 实例化 | AbstractSeries |
| 继承自 | QObject |
| 继承于 | QAbstractBarSeries、QAreaSeries、QBoxPlotSeries、QCandlestickSeries、QPieSeries和QXYSeries |
公共类型
| 枚举 | SeriesType { SeriesTypeLine, SeriesTypeArea, SeriesTypeBar, SeriesTypeStackedBar, SeriesTypePercentBar, …, SeriesTypeCandlestick } |
属性
公共函数
| 虚拟 | ~QAbstractSeries() |
| bool | attachAxis(QAbstractAxis *axis) |
| QList<QAbstractAxis *> | attachedAxes() |
| QChart * | chart() const |
| bool | detachAxis(QAbstractAxis *axis) |
| void | hide() |
| bool | isVisible() const |
| QString | name() const |
| qreal | opacity() const |
| void | setName(const QString &name) |
| void | setOpacity(qreal opacity) |
| void | setUseOpenGL(bool enable = true) |
| void | setVisible(bool visible = true) |
| void | show() |
| virtual QAbstractSeries::SeriesType | type() const = 0 |
| bool | useOpenGL() const |
信号
| void | nameChanged() |
| void | opacityChanged() |
| void | useOpenGLChanged() |
| void | visibleChanged() |
另见 QXYSeries、QLineSeries、QSplineSeries、QScatterSeries、QAreaSeries、QAbstractBarSeries、QBarSeries、QStackedBarSeries、QPercentBarSeries、QHorizontalBarSeries、QHorizontalStackedBarSeries、QHorizontalPercentBarSeries和QPieSeries。
成员类型文档
枚举 QAbstractSeries::SeriesType
此枚举描述了系列类型。
| 常量 | 值 | 描述 |
|---|---|---|
QAbstractSeries::SeriesTypeLine | 0 | 折线图。 |
QAbstractSeries::SeriesTypeArea | 1 | 面积图。 |
QAbstractSeries::SeriesTypeBar | 2 | 垂直条形图。 |
QAbstractSeries::SeriesTypeStackedBar | 3 | 垂直堆叠条形图。 |
QAbstractSeries::SeriesTypePercentBar | 4 | 垂直百分比条形图。 |
QAbstractSeries::SeriesTypePie | 5 | 饼图。 |
QAbstractSeries::SeriesTypeScatter | 6 | 散点图。 |
QAbstractSeries::SeriesTypeSpline | 7 | 样条图。 |
QAbstractSeries::SeriesTypeHorizontalBar | 8 | 水平条形图。 |
QAbstractSeries::SeriesTypeHorizontalStackedBar | 9 | 水平堆叠条形图。 |
QAbstractSeries::SeriesTypeHorizontalPercentBar | 10 | 水平百分比条形图。 |
QAbstractSeries::SeriesTypeBoxPlot | 11 | 箱线图。 |
QAbstractSeries::SeriesTypeCandlestick | 12 | 蜡烛图。 |
属性文档
名称 : QString
此属性保存系列名称。
名称将在系列的图例中显示，并支持HTML格式化。
访问函数
| QString | 名称() const |
| void | setName(const QString &名称) |
通知信号
| void | nameChanged() |
不透明度 : qreal
此属性保存系列的不透明度。
默认情况下，不透明度为1.0。有效值范围从0.0（透明）到1.0（不透明）。
访问函数
| qreal | 不透明度() const |
| void | setOpacity(qreal 不透明度) |
通知信号
| void | opacityChanged() |
[只读] 类型 : const SeriesType
此属性保存系列类型。
访问函数
| virtual QAbstractSeries::SeriesType | 类型() const = 0 |
useOpenGL : bool
指定是否使用OpenGL加速绘制系列。
OpenGL加速仅支持QLineSeries和QScatterSeries。用作QAreaSeries边缘系列的线系列不能使用OpenGL加速。当一个图表包含使用OpenGL绘制的任何系列时，将在图表绘图区域上方创建一个透明的QOpenGLWidget。加速的系列不在底层的QGraphicsView上绘制，而是在创建的QOpenGLWidget上绘制。
使用OpenGL加速系列绘制所获得的效果取决于底层硬件，但在大多数情况下都相当显著。例如，在标准台式计算机上，启用OpenGL加速通常可以在不降低帧率的情况下渲染至少多百个点。图表大小对帧率的影响也较小。
系列绘制中的OpenGL加速旨在用于需要快速绘制大量点的用例。它进行了优化以提高效率，因此使用它的系列缺乏对未加速系列可用的许多功能的支持。
- 不支持为加速系列提供系列动画。
- 不支持为加速系列提供点标签。
- 对于加速系列，忽略画笔样式、标记形状和光标标记。仅支持实线和纯散点。散点可以是圆形或矩形，具体取决于底层图形硬件和驱动程序。
- 极坐标图不支持加速系列。
- 当使用加速系列时，不建议启用图表阴影或使用透明图表背景颜色，因为这可能会显著降低帧率。
这些附加限制源于加速系列是在图表上的另一个小部件上绘制的。
- 如果在包含加速系列的图表上绘制任何图形项目，加速系列将在这些项目之上绘制。
- 要使QOpenGLWidget部分透明，它需要堆叠在所有其他小部件之上。这意味着在使用加速系列时，不能有其他小部件部分覆盖图表。
- 不支持在图形场景中有多个图形视图附加到的用例中使用的加速系列。
- 不支持在具有非默认几何形状的图表中使用的加速系列。例如，向图形视图添加转换会使加速系列在相对于图表的不正确位置绘制。
默认值为false。
访问函数
| bool | useOpenGL() const |
| void | setUseOpenGL(bool enable = true) |
通知信号
| void | useOpenGLChanged() |
可见 : bool
此属性保留系列是否可见。
默认情况下，true。
访问函数
| bool | isVisible() const |
| void | setVisible(bool visible = true) |
通知信号
| void | visibleChanged() |
成员函数文档
[虚拟 noexcept] QAbstractSeries::~QAbstractSeries()
图表系列的虚拟析构函数。
bool QAbstractSeries::attachAxis(QAbstractAxis *axis)
将指定的axis轴附加到系列。
如果轴成功附加，则返回true，否则返回false。
注意：如果多个同一方向的轴附加到同一系列，它们将具有相同的最大和最小值。
另请参阅：QChart::addAxis()和QChart::createDefaultAxes。
QList<QAbstractAxis *> QAbstractSeries::attachedAxes()
返回附加到系列的轴列表。通常，X轴和Y轴被附加到系列，但对于QPieSeries（它没有附加任何轴）除外。
另请参阅：attachAxis()和detachAxis。
QChart *QAbstractSeries::chart() const
返回系列所属的图表。
当系列被添加到图表时自动设置，从图表中移除系列时取消设置。
bool QAbstractSeries::detachAxis(QAbstractAxis *axis)
从系列中卸载指定的 axis 轴。
如果轴成功卸载，返回 true，否则返回 false。
另请参阅QChart::removeAxis。
void QAbstractSeries::hide()
将系列的可见性设置为 false。
另请参阅setVisible() 和 isVisible。
[信号] void QAbstractSeries::nameChanged()
在系列名称更改时发出此信号。
注意：属性 name 的通知信号。
[信号] void QAbstractSeries::opacityChanged()
当系列的透明度更改时发出此信号。
注意：属性 opacity 的通知信号。
void QAbstractSeries::show()
将系列的可见性设置为 true。
另请参阅setVisible() 和 isVisible。
[信号] void QAbstractSeries::useOpenGLChanged()
当启用或禁用OpenGL加速系列绘图时发出此信号。
注意：属性 useOpenGL 的通知信号。
[信号] void QAbstractSeries::visibleChanged()
当系列可见性更改时发出此信号。
注意：属性 visible 的通知信号。
© 2024 Qt 公司有限公司。此处包含的文档贡献的版权属于各自的所有者。此处提供的文档是根据自由软件基金会发布的 GNU 自由文档许可证版本 1.3 许可的。Qt 和相应的标志是芬兰和/或世界其他国家的 Qt 公司的商标。所有其他商标均为各自所有者的财产。
