QCharts类管理一个可以显示图表系列的图片,坐标轴,和曲线
文章目录
- 详细描述
- 枚举变量
- 参数文档
- animationDuration:int
- animationEasingCurve:QEasingCurve
- animationOptions:QChart::AnimationOptions
- backgroundRoundness:qreal
- backgroundVisble:bool
- charType:const QChart::chartType
- dropShadowEnabled:bool
- locale:QLocale
- localizeNumbers:bool
- margins:QMargins
- plotArea:QRectF
- plotAreaBackgroundVisable:bool
- theme:Qchart::chartTheme
- title:QString
- 成员函数描述
详细描述
QCharts是一个QGraphicsWidget,你可以展示图片它管理了一个有不同线和其他的比如标题栏或者坐标轴的对象,为了在一个列表中展示一个图表,一个名为QChartView的类可以用代替QChart,除此之外,线,虚线,空间,极坐标等可以使用QPolarChart类来使用
枚举变量
枚举变量描述了chart的主题,设定这些主题以后将会改变所有的系列
参数文档
animationDuration:int
这个参数来控制图形的动画时间
访问方法:
int animationDuration() const
void setAnimationDuration(int msecs)
animationEasingCurve:QEasingCurve
此属性保存图表动画的缓动曲线
访问方法:
QEasingCurve animationEasingCurve() const
void setAnimationEasingCurve(const QEasingVurve &curve)
animationOptions:QChart::AnimationOptions
这个参数决定图表的动画选项
动画是否使能取决于这个设置
访问方法:
QChart::AnimationOptions animationOptions() const
void setAnimationOptions(QChart::AnimationOptions options)
backgroundRoundness:qreal
此属性保存图表背景角处的圆的直径。
访问方法:
qreal backgroundness() const
void setBackgroundRoundness(qreal diameter)
backgroundVisble:bool
这个属性决定是否图表的背景是有效的
访问方式:
bool isBackgroundVisble() const
void setBackgroundVisible(bool visible = true)
charType:const QChart::chartType
这个参数决定是否是迪卡尔坐标系还是一个直角坐标系
这个参数是在内部实现的,在外面是仅仅可读的
访问方式:
QChart::ChartType charType() const
dropShadowEnabled:bool
这个参数决定背景消除阴影是否是有效的,如果是有效的,背景消除阴影就会使能,反之会结束,
**注意:**背景消除阴影取决于主题,如果主题变了,这个效果也会变化
访问方式:
bool isDropShadowEnabled() const
void setDropShadowEnabled(bool enabled = true)
locale:QLocale
此属性保存用于格式化各种图表标签的区域设置。
只有当locailzeNumbers为真的时候,除了QDateTimeAxis标签之外,通常使用QLocale来设置这个属性,默认的应用将会在这个图表创建的时候构建
访问方式:
QLocale locale() const
void setLocale(const QLocale & locale)
localizeNumbers:bool
这个参数决定了是否这个数据是局部的
当为真的时候,所有,意思就是是否允许标签固定
**注意:**这个参数不会影响QDataTimeAxis标签,这个标签经常使用QLocale设置locale属性
访问方式:
bool localizeNumbers() const
void setLocalizeNumbers(bool localize)
margins:QMargins
这个参数保证了在绘图区域和图表区域的最小的边缘
这个参数用来绘制标题,坐标轴和网格
访问方式:
QMargins margins() const
void setMargins(const QMargins &margins)
plotArea:QRectF
这个参数决定了图表在绘制的矩形的区域
绘制区域不包括边框的区域,默认情况下他们将会在QChartView中重新绘制大小,如果一个明确的绘制尺寸设定了,就会遵守,调用函数setPlotArea(QRectF())使之恢复到默认表现
访问方式:
QRectF plotArea() const
void setPlotArea(const QRectF &rect)
通知信号:
void plotAreaChaged(const QRectF &plotArea)
plotAreaBackgroundVisable:bool
这个参数决定了图表的绘制区域的背景是否是有效的
访问方法:
bool isPlotAreaBackgroundVisible() const
void setPlotAreaBackgroundVisable(bool visible = true)
theme:Qchart::chartTheme
这个参数决定了是否主题可以用在图表中
访问方法:
QChart::ChartTheme theme() const
void setTheme(QChart::ChartTheme theme)
title:QString
这个参数决定了图表的标题
这个标题将会在图表的上方出现,标题支持HTML格式
访问方法:
QString title() const
void setTitle(const QString &title)
成员函数描述
QChart::QChart(QGraphicsitem *parant = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags())
构造一个图表对象,是其父类的子对象,这个参数通过wFlags来指定,还会调用 QGraphicsWidget 的构造函数
QChart::~QChart() [virtual]
删除这个图表对象以及它的子对象,比如里面的一系列的系列对象
void QChart::addAxis(QAbstractAxis *axis, Qt::Alignemnt alignment)
向图表中插入指定的系列的曲线,这个图表拥有这些对象
与此相关的还有removeAxis(), reateDefaultAxes(), 和 QAbstractSeries::attchAxis()
void QChart::addSeries(QAbstractSeries *series)
向图表中添加新的系列
新添加的数据系列在默认情况下不会依附于任何的坐标轴,所以我们可能需要在系列添加早图表之前使用函数createDefaultAxes()来设置默认的额坐标轴,如果没有将新添加的系列依附在一个坐标轴上,如果图表中已经有坐标轴的话,这个系列将会附着在现有的坐标轴上,这样可能导致图表的混乱,所以尽量在添加数据系列之前调用函数createDefaultAxes()函数
QList<QAbstractAxis *> QChart::axes(Qt::Qrientations orientation = Qt::Horizontal|Qt::Vertical, QAbstractSeries *series = nullptr) const
根据方向返回坐标轴上的系列
QBrush QChart::backgroundBrush() const
得到图表区域的绘制背景的刷子
QPen QChart::backgroundPen() const
得到绘制图表区域的背景
void QChart::createDefaultAxes()
创在图表的基本的格式,任何之前加载图表中的系列都将被删除
**注意:**这个函数需要在数据系列添加到图表之前调用
bool QChart::isZoomed()
如果有任何的缩放域,就返回true
QLegend *QChart::legend() const
返回图表中的图例,以QLegend的形式来返回
QPointF QChart::mapToPosition(const QPointF &value, QAbstractSeries *series = nullptr)
返回返回指定值在图表中的位置
QPointF QChart::mapToValue(const QPointF &position, QAbstractSeries *series = nullptr)
返回指定值在图表中的指定位置的值
QBrush QChart::plotAreaBackgroundBrush() const
返回填充背景的刷子QBrush
QPen QChart::plotAreaBackgroundPen() sonst
返回绘制图表背景的QPen
void QChart::removeAllSeries()
移除所有的添加到图表中的系列
void QChart::removeAxis(QAbstractAxis *axis)
从图表中移除坐标轴,图表释放指定的坐标轴对象的所有权
void QChart::removeSeries(QAbstractSeries *series)
从图表中移除一系列的系列,图表释放对这些系列的所有权
void QChart::scroll(qreal dx, qreal dy)
滚动图表的有效位置,按照dx,dy的长度来滚动
QList<QAbstractSeries *> QChart::series() const
返回所有添加到图表中的数据系列
void QChart::setBackgroundBrush(const QBrush &brush)
设置一个用来绘制该图表的刷子
void QChart::setPlotAreaBackgroundPen(const QPen &pen)
设置一个用来绘制图表区域背景的一个QPen
void QChart::setTitleBrush(const QBrush &brush)
设置一个绘制图表标题的刷子QBrush
void QChart::setTiitleFont(const QFont &font)
设置图表标题的字体
void QChart::titleBrush() const
返回用来绘制图表标题的刷子
void QChart::titleBrush() const
返回用来绘制图表标题的刷子
void QChart::titleFont() const
得到用来绘制图表标题的字体
void QChart::zoom(qreal factor)
通过定制的factor来缩放图标是视图
void QChart::zoomIn()
将图表视图放大两倍
void QChart::zoomIn(const QRect &rect)
方法这个图表视图
void QChart::zoomOut()
缩小视图
void QChart::zoomReset()
复位视图