成员函数文档
[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 添加到图表中,并获得其所有权。
注: 默认情况下,新添加的序列不会附加到任何坐标轴上,甚至在序列添加到图表之前使用createDefaultAxes() 为图表创建的坐标轴也不会附加到序列上。如果在显示图表之前没有为新添加的序列附加任何坐标轴,那么在绘制该序列时,就会将其视为有坐标轴,而坐标轴的范围正好适合该序列在图表中的绘制区域。如果同一图表中还显示有正确附加轴的其他系列,这可能会造成混乱,因此请务必在添加系列后调用createDefaultAxes() 或明确为系列附加轴。
另请参阅 removeSeries()、removeAllSeries()、createDefaultAxes() 和QAbstractSeries::attachAxis()。
QList
以orientation 指定的方向返回连接到系列series 的坐标轴。如果未指定系列,则返回以指定方向添加到图表中的所有坐标轴。
另请参阅 addAxis() 和createDefaultAxes()。
QBrush QChart::backgroundBrush() const
获取用于绘制图表区域背景的笔刷。
另请参阅 setBackgroundBrush()。
QPen QChart::backgroundPen() const
获取用于绘制图表区域背景的笔。
另请参阅 setBackgroundPen()。
void QChart::createDefaultAxes()
根据已添加到图表中的序列为图表创建坐标轴。之前添加到图表中的坐标轴将被删除。
注意: 必须在所有序列都添加到图表后才调用此函数。此函数创建的坐标轴不会自动附加到调用此函数后添加到图表中的序列。默认情况下,未附加坐标轴的系列将缩放以利用图表的整个绘图区域,如果其他系列也有正确附加的坐标轴,则会造成混乱。
系列类型水平轴 (X)垂直轴(Y)
QXYSeriesQValueAxisQValueAxis
QBarSeriesQBarCategoryAxisQValueAxis
QPieSeries无无
如果图表中添加了多个QXYSeries 派生系列,且未添加其他类型的系列,则只创建一对坐标轴。如果图表中添加了多个不同类型的系列,则每个系列都有自己的一对坐标轴。
axes QPieSeries 不创建任何坐标轴。
另请参阅 axes() 和QAbstractSeries::attachAxis()。
bool QChart::isZoomed()
如果有序列具有缩放域,则返回true 。
QLegend *QChart::legend() const
返回图表的图例对象。所有权随图表一起保留。
QPointF QChart::mapToPosition(const QPointF &value, QAbstractSeries *series = nullptr)
返回series 指定的系列中与value 值相对应的图表位置。
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
返回添加到图表中的所有系列。
另请参阅 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 仍完全可见的最大水平。
注: 应用缩放可能会修改附加坐标轴的属性,例如 QAbstractAxis::min 和 QAbstractAxis::max。
注: 极坐标图表不支持此功能。
void QChart::zoomOut()
将视图缩小 2 倍。
注意: 如果结果包含无效的对数轴范围,该操作将不起任何作用。
void QChart::zoomReset()
将系列域重置为调用任何缩放方法之前的状态。
注: 此方法还将重置在第一次缩放操作和调用此方法之间指定的滚动和显式轴范围设置。如果未执行缩放操作,则此方法不会执行任何操作。