QChart Class

成员函数文档

[explicit] QChart::QChart(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags())

创建一个作为parent 子节点的图表对象。由wFlags 指定的属性将传递给QGraphicsWidget 构造函数。

[virtual noexcept] QChart::~QChart()

删除图表对象及其子对象，例如添加到该图表中的系列和坐标轴对象。

void QChart::addAxis(QAbstractAxis *axis, Qt::Alignment alignment)

将坐标轴axis 添加到图表中，并对齐方式按alignment 中指定的方式进行设置。图表将拥有该坐标轴的所有权。

另请参阅 removeAxis()、createDefaultAxes() 和QAbstractSeries::attachAxis()。

void QChart::addSeries(QAbstractSeries *series)

将数据系列series 添加到图表中，并将其设为当前所有者。

另请参阅 removeSeries()、removeAllSeries()、createDefaultAxes() 和QAbstractSeries::attachAxis()。

QList<QAbstractAxis *> QChart::axes(Qt::Orientations orientation = Qt::Horizontal|Qt::Vertical, QAbstractSeries *series = nullptr) const

返回与数据系列series 关联的坐标轴，其方向由orientation 指定。如果未指定数据系列，则返回所有以指定方向添加到图表中的坐标轴。

另请参阅 addAxis() 和createDefaultAxes()。

QBrush QChart::backgroundBrush() const

获取用于绘制图表区域背景的画笔。

另请参阅 setBackgroundBrush()。

QPen QChart::backgroundPen() const

获取用于绘制图表区域背景的画笔。

另请参阅 setBackgroundPen()。

void QChart::createDefaultAxes()

根据已添加到图表中的数据系列为图表创建坐标轴。此前添加到图表中的任何坐标轴都将被删除。

如果图表中添加了多个由 QXYSeries 派生的系列，且未添加其他类型的系列，则仅会创建一对坐标轴。如果图表中添加了多种类型的系列，则每个系列都会拥有自己的一对坐标轴。

可以通过将该系列作为axes()函数调用的参数，从图表中获取该系列专用的坐标轴。QPieSeries不会创建任何坐标轴。

另请参阅 axes() 和QAbstractSeries::attachAxis()。

bool QChart::isZoomed()

如果任何数列具有缩放定义域，则返回true 。

QLegend *QChart::legend() const

返回图表的图例对象。所有权仍归图表所有。

QPointF QChart::mapToPosition(const QPointF &value, QAbstractSeries *series = nullptr)

返回图表上与值value 相对应的位置，该值属于由series 指定的数据系列。

QPointF QChart::mapToValue(const QPointF &position, QAbstractSeries *series = nullptr)

返回图表中由series 指定的序列中，位于position 指定位置处的值。

QBrush QChart::plotAreaBackgroundBrush() const

返回用于填充图表绘图区域背景的画笔。

另请参阅 plotArea()、plotAreaBackgroundVisible 、plotAreaBackgroundPen() 以及setPlotAreaBackgroundBrush()。

QPen QChart::plotAreaBackgroundPen() const

返回用于绘制图表绘图区域背景的画笔。

另请参阅 plotArea()、plotAreaBackgroundVisible 、plotAreaBackgroundBrush() 以及setPlotAreaBackgroundPen()。

void QChart::removeAllSeries()

移除并删除已添加到图表中的所有系列对象。

另请参阅 addSeries() 和removeSeries()。

void QChart::removeAxis(QAbstractAxis *axis)

从图表中移除坐标轴axis 。图表将释放对指定axis 对象的所有权。

另请参阅 addAxis()、createDefaultAxes() 和QAbstractSeries::detachAxis()。

void QChart::removeSeries(QAbstractSeries *series)

从图表中移除系列series 。图表将释放对指定series 对象的所有权。

另请参阅 addSeries() 和removeAllSeries()。

void QChart::scroll(qreal dx, qreal dy)

根据dx 和dy 中指定的距离滚动图表的可见区域。

对于极坐标图表，dx 表示沿角度轴的夹角，而非距离。

QList<QAbstractSeries *> QChart::series() const

返回所有已添加到图表中的数据系列。

另请参阅 addSeries()、removeSeries() 和removeAllSeries()。

void QChart::setBackgroundBrush(const QBrush &brush)

将用于绘制图表区域背景的画笔设置为brush 。

另请参阅 backgroundBrush()。

void QChart::setBackgroundPen(const QPen &pen)

将用于绘制图表区域背景的画笔设置为pen 。

另请参阅 backgroundPen()。

void QChart::setPlotAreaBackgroundBrush(const QBrush &brush)

将用于填充图表绘图区域背景的画笔设置为brush 。

另请参阅 plotArea()、plotAreaBackgroundVisible 、setPlotAreaBackgroundPen() 以及plotAreaBackgroundBrush()。

void QChart::setPlotAreaBackgroundPen(const QPen &pen)

将用于绘制图表绘图区域背景的画笔设置为pen 。

另请参阅 plotArea()、plotAreaBackgroundVisible 、setPlotAreaBackgroundBrush() 以及plotAreaBackgroundPen()。

void QChart::setTitleBrush(const QBrush &brush)

将用于绘制标题文本的画笔设置为brush 。

另请参阅 titleBrush()。

void QChart::setTitleFont(const QFont &font)

将绘制图表标题时使用的字体设置为font 。

另请参阅 titleFont()。

QBrush QChart::titleBrush() const

返回用于绘制标题文本的画笔。

另请参阅 setTitleBrush()。

QFont QChart::titleFont() const

获取用于绘制图表标题的字体。

另请参阅 setTitleFont()。

void QChart::zoom(qreal factor)

按自定义缩放因子factor 将视图放大。

放大因子大于 1.0 时，视图会放大；放大因子在 0.0 到 1.0 之间时，视图会缩小。

void QChart::zoomIn()

将视图放大两倍。

void QChart::zoomIn(const QRectF &rect)

将视图放大至最大级别，此时矩形rect 仍能完全显示。

void QChart::zoomOut()

将视图缩小至原来的二分之一。

void QChart::zoomReset()

将系列域重置为调用任何缩放方法之前的状态。