QtCharts之QAbstractSeries

Author： nullobject
发布时间：March 25, 2019
7328 views
7 comments
4913 字数
Categories： Qt Charts Qt

这篇文章主要讲解QAbstractSeries的API及其使用。

0x00 写在前面：Qt Charts的组成结构

理解本文章内容之前，需要读者对Qt Charts的基本组成有个整体认识，具体可以参考这篇文章:Qt Charts 基本组成。Qt Charts主要由QChartView、QChart、QLegend图例、坐标轴(由QAbstractAxis子类实现)、数据源(由QAbstractSeries子类实现)等组成：

Qt Charts组成结构

0x01 QAbstractSeries类

由上图可知，Qt Charts图表中，数据的最终呈现主要由QAbstractSeries及其派生类负责(上图为QLineSeries)，通常在实际开发中都是直接使用QAbstractSeries的派生类来实现功能。QAbstractSeries作为Qt Charts模块中所有数据序列类(Q***Series)的基类，与其子类的继承关系大致如下：

QAbstractSeries类继承关系图

Tips：由于QAbstractSeries的子类及其子类的子类数目众多，这里只大致列出了从QAbstractSeries<--QXYSeries<--QLineSeries的继承关系，详情可以参考上文提到的文章链接以及Qt官方文档。

可以看到，以QLineSeries为例，QLineSeries继承自QXYSeries，而QXYSeries正是继承自QAbstractSeries类，同时通过学习QLineSeries相关文档和源码了解到，QLineSeries的功能实现几乎都继承于其父类QXYSeries和QAbstractSeries类，因此。要想熟练使用QLineSeries，实现美丽的折线图，学习理解QXYSeries和QAbstractSeries类的API是必须的，本文主要介绍QAbstractSeries。

0x02 QAbstractSeries属性

QString name;

获取和设置series名称，即QAbstractSeries所表示的图形图例名称，支持HTML格式的文本。
- QString name() const;
  
  获取series图例名称。
- void setName(const QString &name);
  
  设置series图例名称。当图例名称发生改变时，会触发QAbstractSeries的nameChanged()信号。

QAbstractSeries图例名称

bool useOpenGL;

获取和设置series是否开启OpenGL加速。
- bool useOpenGL() const;
  
  获取是否开启OpenGL加速。
- void setUseOpenGL(bool enable=true);
  
  设置开启/关闭OpenGL加速渲染，默认关闭。该选项发生改变时会触发QAbstractSeries的useOpenGLChanged()信号。
Tips : 在不开启OpenGL加速就能满足性能要求且对该选项带来的副作用不熟悉的情况下，建议不要开启OpenGL加速！

当需要绘制大数据量的图表序列时，开启OpenGL加速之后series的绘制性能显著提升。但是Qt Charts实现的OpenGL加速(依托QOpenGLWidget组件实现)迄今为止仍存在一些问题，比如MDI程序环境下，开启了OpenGL加速的图表序列会被置顶于所有MDI子窗口之上，造成图表重叠错乱的问题：

而且，目前只有QLineSeries和QScatterSeries两种类型的图表支持开启OpenGL绘制，且当QLineSeries作为面积图QAreaSeries的边缘线时也不能开启OpenGL。因此，慎重开启此选项！
qreal opacity;

获取和设置图表序列显示的透明度。
- qreal opacity() const;
  
  获取series当前设置的透明度。
- void setOpacity(qreal opacity);
  
  设置series显示的透明度，设置范围：全透明0.0~1.0不透明，该属性值发生改变时会触发opacityChanged()信号。
bool visible;

获取和设置是否显示当前图表。
- bool isVisible() const;
  
  获取是否显示当前图表；
- void setVisible(bool visible = true);
  
  设置是否显示当前图表，该属性值发生改变时会触发visibleChanged()信号。
const SeriesType type;

该属性代表当前图表序列series的类型，QAbstractSeries中声明了一个纯虚函数用于操作该属性：

virtual QAbstractSeries::SeriesType type() const = 0;

QAbstractSeries的子类需要手动实现该函数并返回对应的图表类型。SeriesType是一个枚举类，描述了Qt Charts当前支持的图表类型：

0x03 QAbstractSeries公有方法

QAbstractSeries主要的公有方法有：

bool QAbstractSeries::attachAxis(QAbstractAxis axis);

附加坐标轴到图表序列series，附加成功时返回true，否则返回false:

// 创建横、纵坐标轴
QValueAxis *axisX = new QValueAxis;
QValueAxis *axisY = new QValueAxis;
// 设置坐标轴颜色
axisX->setLinePen(QPen(Qt::blue));
axisY->setLinePen(QPen(Qt::blue));
// 设置坐标轴刻度线颜色和宽度
QPen pen(Qt::black);
pen.setWidth(1);
axisX->setGridLinePen(pen);
axisY->setGridLinePen(pen);
// 添加坐标轴到QChart组件
chart->addAxis(axisX,Qt::AlignBottom);
chart->addAxis(axisY,Qt::AlignLeft);
// 设置显示刻度范围
axisX->setRange(0,25);
axisY->setRange(0,15);
// 附加坐标系到图表序列series    
series->attachAxis(axisX);
series->attachAxis(axisY);

效果：

附加坐标轴到图表

当同一方向上有多个坐标轴同时依附到同一个图表序列上时，这些坐标轴将会被设置为相同的刻度范围，且经过实践证明，自动调整后的刻度范围是最后被依附到图标序列的坐标轴刻度范围：

//增加第二条个横纵坐标系
QValueAxis *axisX1 = new QValueAxis;
QValueAxis *axisY1 = new QValueAxis;
axisX1->setRange(-5,15);
axisY1->setRange(0,5);
chart->addAxis(axisX1,Qt::AlignBottom);
chart->addAxis(axisY1,Qt::AlignLeft);
//将两个坐标系依附到图标序列series
series->attachAxis(axisX1);
series->attachAxis(axisY1);

效果：

同方向依附多个坐标轴到图表

QList<QAbstractAxis > QAbstractSeries::attachedAxes();

获取图表序列当前依附的所有坐标轴集合：

// 打印上一步中依附到series的所有坐标轴集合
qDebug() << "attached axes:" <<  series->attachedAxes();

结果：

series依附的所有坐标轴

QChart QAbstractSeries::chart() const;

获取当前图表序列series所属的QChart组件。通过QChart::addSeries()方法将series添加到QChart组件后可以通过此方法获取series被添加到的QChart对象指针。
bool QAbstractSeries::detachAxis(QAbstractAxis axis);

从当前图表序列分离坐标轴。

0x04 The End.

本文作者： nullobject

本文链接： https://nullobject.cn/archives/qabstractseries.html

版权声明： 本博客所有原创文章均采用 CC BY-NC-SA 4.0 许可协议。您可以自由的转载和修改，但请务必注明文章来源并且不可用于商业目的！

Last modification：September 12th, 2019 at 05:25 pm

If you think my article is useful to you, please feel free to appreciate

7 comments

ojfkrwbiuu
November 13th, 2024 at 10:25 am

《安娜贝尔3：回家国语》恐怖片高清在线免费观看：https://www.jgz518.com/xingkong/133767.html

Reply
kovtxphwdo
November 12th, 2024 at 12:23 am

热血传奇变态版手游私服评测：https://501h.com/heji/14019.html

Reply
rgsanpdpyz
October 19th, 2024 at 05:45 pm

兄弟写的非常好 https://www.cscnn.com/

Reply
fzeuwlznwx
October 1st, 2024 at 09:44 pm

不错不错，我喜欢看 https://www.237fa.com/

Reply
ypwyqrrqqs
September 23rd, 2024 at 10:48 am

叼茂SEO.bfbikes.com

Reply
eglktkwjtz
September 23rd, 2024 at 10:03 am

不错不错，我喜欢看

Reply
QtCharts之QXYSeries | 算法網
August 13th, 2019 at 10:33 pm

[...]QXYSeries作為QAbstractSeries的派生類之一，主要負責實現以二維點集為數據源，坐標類型為二維坐標系的圖表類型，包括折線圖、曲線圖和散點圖等。QXYSeries封裝了大量對數據源進行增刪改操作的函數和信號，同時內部實現了控制數據點在坐標繫上的显示形態(點標籤的格式、顏色、是否显示等)的功能。[...]

Reply

QtCharts之QAbstractSeries

nullobject • 2024 年 Nov 月 Thu 日

这篇文章主要讲解QAbstractSeries的API及其使用。

0x00 写在前面：Qt Charts的组成结构

Qt Charts组成结构

0x01 QAbstractSeries类

QAbstractSeries类继承关系图

Tips：由于QAbstractSeries的子类及其子类的子类数目众多，这里只大致列出了从QAbstractSeries<--QXYSeries<--QLineSeries的继承关系，详情可以参考上文提到的文章链接以及Qt官方文档。

0x02 QAbstractSeries属性

QString name;

获取和设置series名称，即QAbstractSeries所表示的图形图例名称，支持HTML格式的文本。
- QString name() const;
  
  获取series图例名称。
- void setName(const QString &name);
  
  设置series图例名称。当图例名称发生改变时，会触发QAbstractSeries的nameChanged()信号。

QAbstractSeries图例名称

bool useOpenGL;

获取和设置series是否开启OpenGL加速。
- bool useOpenGL() const;
  
  获取是否开启OpenGL加速。
- void setUseOpenGL(bool enable=true);
  
  设置开启/关闭OpenGL加速渲染，默认关闭。该选项发生改变时会触发QAbstractSeries的useOpenGLChanged()信号。
Tips : 在不开启OpenGL加速就能满足性能要求且对该选项带来的副作用不熟悉的情况下，建议不要开启OpenGL加速！

当需要绘制大数据量的图表序列时，开启OpenGL加速之后series的绘制性能显著提升。但是Qt Charts实现的OpenGL加速(依托QOpenGLWidget组件实现)迄今为止仍存在一些问题，比如MDI程序环境下，开启了OpenGL加速的图表序列会被置顶于所有MDI子窗口之上，造成图表重叠错乱的问题：

而且，目前只有QLineSeries和QScatterSeries两种类型的图表支持开启OpenGL绘制，且当QLineSeries作为面积图QAreaSeries的边缘线时也不能开启OpenGL。因此，慎重开启此选项！
qreal opacity;

获取和设置图表序列显示的透明度。
- qreal opacity() const;
  
  获取series当前设置的透明度。
- void setOpacity(qreal opacity);
  
  设置series显示的透明度，设置范围：全透明0.0~1.0不透明，该属性值发生改变时会触发opacityChanged()信号。
bool visible;

获取和设置是否显示当前图表。
- bool isVisible() const;
  
  获取是否显示当前图表；
- void setVisible(bool visible = true);
  
  设置是否显示当前图表，该属性值发生改变时会触发visibleChanged()信号。
const SeriesType type;

该属性代表当前图表序列series的类型，QAbstractSeries中声明了一个纯虚函数用于操作该属性：

virtual QAbstractSeries::SeriesType type() const = 0;

QAbstractSeries的子类需要手动实现该函数并返回对应的图表类型。SeriesType是一个枚举类，描述了Qt Charts当前支持的图表类型：

0x03 QAbstractSeries公有方法

QAbstractSeries主要的公有方法有：

bool QAbstractSeries::attachAxis(QAbstractAxis axis);

附加坐标轴到图表序列series，附加成功时返回true，否则返回false:

// 创建横、纵坐标轴
QValueAxis *axisX = new QValueAxis;
QValueAxis *axisY = new QValueAxis;
// 设置坐标轴颜色
axisX->setLinePen(QPen(Qt::blue));
axisY->setLinePen(QPen(Qt::blue));
// 设置坐标轴刻度线颜色和宽度
QPen pen(Qt::black);
pen.setWidth(1);
axisX->setGridLinePen(pen);
axisY->setGridLinePen(pen);
// 添加坐标轴到QChart组件
chart->addAxis(axisX,Qt::AlignBottom);
chart->addAxis(axisY,Qt::AlignLeft);
// 设置显示刻度范围
axisX->setRange(0,25);
axisY->setRange(0,15);
// 附加坐标系到图表序列series    
series->attachAxis(axisX);
series->attachAxis(axisY);

效果：

附加坐标轴到图表

当同一方向上有多个坐标轴同时依附到同一个图表序列上时，这些坐标轴将会被设置为相同的刻度范围，且经过实践证明，自动调整后的刻度范围是最后被依附到图标序列的坐标轴刻度范围：

//增加第二条个横纵坐标系
QValueAxis *axisX1 = new QValueAxis;
QValueAxis *axisY1 = new QValueAxis;
axisX1->setRange(-5,15);
axisY1->setRange(0,5);
chart->addAxis(axisX1,Qt::AlignBottom);
chart->addAxis(axisY1,Qt::AlignLeft);
//将两个坐标系依附到图标序列series
series->attachAxis(axisX1);
series->attachAxis(axisY1);

效果：

同方向依附多个坐标轴到图表

QList<QAbstractAxis > QAbstractSeries::attachedAxes();

获取图表序列当前依附的所有坐标轴集合：

// 打印上一步中依附到series的所有坐标轴集合
qDebug() << "attached axes:" <<  series->attachedAxes();

结果：

series依附的所有坐标轴

QChart QAbstractSeries::chart() const;

获取当前图表序列series所属的QChart组件。通过QChart::addSeries()方法将series添加到QChart组件后可以通过此方法获取series被添加到的QChart对象指针。
bool QAbstractSeries::detachAxis(QAbstractAxis axis);

从当前图表序列分离坐标轴。

QtCharts之QAbstractSeries

0x00 写在前面：Qt Charts的组成结构

0x01 QAbstractSeries类

0x02 QAbstractSeries属性

0x03 QAbstractSeries公有方法

0x04 The End.

7 comments

Leave a Comment Cancel reply

QtCharts之QAbstractAxis类

RGBX与RGBA的区别

【协议篇】PTPIP协议文档

2019.02.07 idea 激活码

QtCharts之QAbstractSeries

QtCharts之QAbstractSeries

QtCharts之QValueAxis类

Visual Studio 2019密钥

OkHttp源码分析(二)OkHttpClient、Request、Call、Dispatcher详解

QtCharts模块概览

QtCharts之QAbstractSeries

0x00 写在前面：Qt Charts的组成结构

0x01 QAbstractSeries类

0x02 QAbstractSeries属性

0x03 QAbstractSeries公有方法

0x04 The End.