qchart.cpp
277 lines
| 6.4 KiB
| text/x-c
|
CppLexer
/ src / qchart.cpp
|
r12 | #include "qchart.h" | ||
|
r85 | #include "qchartaxis.h" | ||
|
r131 | #include "chartpresenter_p.h" | ||
#include "chartdataset_p.h" | ||||
|
r42 | #include <QGraphicsScene> | ||
|
r115 | #include <QGraphicsSceneResizeEvent> | ||
|
r21 | #include <QDebug> | ||
|
r12 | |||
|
r277 | QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||
/*! | ||||
\enum QChart::ChartTheme | ||||
This enum describes the theme used by the chart. | ||||
\value ChartThemeDefault | ||||
\value ChartThemeVanilla | ||||
\value ChartThemeIcy | ||||
\value ChartThemeGrayscale | ||||
\value ChartThemeScientific | ||||
*/ | ||||
|
r302 | /*! | ||
\enum QChart::AnimationOption | ||||
For enabling/disabling animations. Defaults to NoAnimation. | ||||
\value NoAnimation | ||||
\value GridAxisAnimations | ||||
\value SeriesAnimations | ||||
\value AllAnimations | ||||
*/ | ||||
|
r264 | /*! | ||
\class QChart | ||||
\brief QtCommercial chart API. | ||||
QChart is a QGraphicsWidget that you can show in a QGraphicsScene. It manages the graphical | ||||
representation of different types of QChartSeries and other chart related objects like | ||||
QChartAxis and QChartLegend. If you simply want to show a chart in a layout, you can use the | ||||
convenience class QChartView instead of QChart. | ||||
|
r274 | \sa QChartView | ||
|
r264 | */ | ||
/*! | ||||
|
r287 | Constructs a chart object which is a child of a\a parent. Parameter \a wFlags is passed to the QGraphicsWidget constructor. | ||
|
r264 | */ | ||
|
r115 | QChart::QChart(QGraphicsItem *parent, Qt::WindowFlags wFlags) : QGraphicsWidget(parent,wFlags), | ||
|
r264 | m_backgroundItem(0), | ||
m_titleItem(0), | ||||
m_dataset(new ChartDataSet(this)), | ||||
m_presenter(new ChartPresenter(this,m_dataset)) | ||||
|
r12 | { | ||
} | ||||
|
r264 | /*! | ||
Destroys the object and it's children, like QChartSeries and QChartAxis object added to it. | ||||
*/ | ||||
QChart::~QChart() | ||||
{ | ||||
} | ||||
|
r12 | |||
|
r264 | /*! | ||
|
r285 | Adds the \a series and optional \a axisY onto the chart and takes the ownership of the objects. | ||
|
r264 | If auto scaling is enabled, re-scales the axes the series is bound to (both the x axis and | ||
the y axis). | ||||
*/ | ||||
|
r360 | void QChart::addSeries(QSeries* series, QChartAxis* axisY) | ||
|
r223 | { | ||
|
r264 | m_dataset->addSeries(series, axisY); | ||
|
r223 | } | ||
|
r42 | |||
|
r274 | /*! | ||
|
r285 | Removes the \a series specified in a perameter from the QChartView. | ||
|
r274 | It releses its ownership of the specified QChartSeries object. | ||
It does not delete the pointed QChartSeries data object | ||||
|
r285 | \sa addSeries(), removeAllSeries() | ||
|
r274 | */ | ||
|
r360 | void QChart::removeSeries(QSeries* series) | ||
|
r223 | { | ||
m_dataset->removeSeries(series); | ||||
|
r42 | } | ||
|
r48 | |||
|
r274 | /*! | ||
Removes all the QChartSeries that have been added to the QChartView | ||||
It also deletes the pointed QChartSeries data objects | ||||
\sa addSeries(), removeSeries() | ||||
*/ | ||||
|
r258 | void QChart::removeAllSeries() | ||
{ | ||||
m_dataset->removeAllSeries(); | ||||
} | ||||
|
r287 | /*! | ||
Sets the \a brush that is used for painting the background of the chart area. | ||||
*/ | ||||
|
r122 | void QChart::setChartBackgroundBrush(const QBrush& brush) | ||
{ | ||||
|
r223 | createChartBackgroundItem(); | ||
|
r122 | m_backgroundItem->setBrush(brush); | ||
m_backgroundItem->update(); | ||||
} | ||||
|
r287 | /*! | ||
Sets the \a pen that is used for painting the background of the chart area. | ||||
*/ | ||||
|
r122 | void QChart::setChartBackgroundPen(const QPen& pen) | ||
{ | ||||
|
r223 | createChartBackgroundItem(); | ||
|
r122 | m_backgroundItem->setPen(pen); | ||
m_backgroundItem->update(); | ||||
} | ||||
|
r274 | /*! | ||
|
r277 | Sets the chart \a title. The description text that is rendered above the chart. | ||
|
r274 | */ | ||
|
r192 | void QChart::setChartTitle(const QString& title) | ||
|
r69 | { | ||
|
r223 | createChartTitleItem(); | ||
|
r87 | m_titleItem->setPlainText(title); | ||
|
r192 | } | ||
|
r274 | /*! | ||
|
r277 | Sets the \a font that is used for rendering the description text that is rendered above the chart. | ||
|
r274 | */ | ||
|
r192 | void QChart::setChartTitleFont(const QFont& font) | ||
{ | ||||
|
r223 | createChartTitleItem(); | ||
|
r87 | m_titleItem->setFont(font); | ||
|
r69 | } | ||
|
r223 | void QChart::createChartBackgroundItem() | ||
{ | ||||
if(!m_backgroundItem) { | ||||
m_backgroundItem = new QGraphicsRectItem(this); | ||||
|
r272 | m_backgroundItem->setPen(Qt::NoPen); | ||
|
r262 | m_backgroundItem->setZValue(ChartPresenter::BackgroundZValue); | ||
|
r223 | } | ||
} | ||||
void QChart::createChartTitleItem() | ||||
{ | ||||
|
r262 | if(!m_titleItem) { | ||
m_titleItem = new QGraphicsTextItem(this); | ||||
m_titleItem->setZValue(ChartPresenter::BackgroundZValue); | ||||
} | ||||
|
r223 | } | ||
|
r277 | /*! | ||
Returns the chart margin, which is the distance between the widget edge and the part of the chart where the actual data can be displayed. | ||||
\sa setMargin() | ||||
*/ | ||||
|
r28 | int QChart::margin() const | ||
{ | ||||
|
r142 | return m_presenter->margin(); | ||
|
r28 | } | ||
|
r277 | /*! | ||
Sets the chart \a margin, which is the distance between the widget edge and the part of the chart where the actual data can be displayed. | ||||
\sa margin() | ||||
*/ | ||||
|
r12 | void QChart::setMargin(int margin) | ||
{ | ||||
|
r143 | m_presenter->setMargin(margin); | ||
|
r12 | } | ||
|
r277 | /*! | ||
|
r285 | Sets the \a theme used by the chart for rendering the graphical representation of the data | ||
|
r277 | \sa ChartTheme, chartTheme() | ||
*/ | ||||
|
r153 | void QChart::setChartTheme(QChart::ChartTheme theme) | ||
|
r64 | { | ||
|
r153 | m_presenter->setChartTheme(theme); | ||
|
r64 | } | ||
|
r277 | /*! | ||
Returns the theme enum used by the chart. | ||||
\sa ChartTheme, setChartTheme() | ||||
*/ | ||||
|
r153 | QChart::ChartTheme QChart::chartTheme() const | ||
|
r120 | { | ||
|
r153 | return m_presenter->chartTheme(); | ||
|
r120 | } | ||
|
r285 | /*! | ||
Zooms in the view by a factor of 2 | ||||
*/ | ||||
|
r223 | void QChart::zoomIn() | ||
|
r67 | { | ||
|
r439 | m_presenter->zoomIn(); | ||
|
r67 | } | ||
|
r285 | /*! | ||
Zooms in the view to a maximum level at which \a rect is still fully visible. | ||||
*/ | ||||
|
r223 | void QChart::zoomIn(const QRectF& rect) | ||
|
r67 | { | ||
|
r439 | |||
|
r223 | if(!rect.isValid()) return; | ||
|
r439 | m_presenter->zoomIn(rect); | ||
|
r67 | } | ||
|
r285 | /*! | ||
Restores the view zoom level to the previous one. | ||||
*/ | ||||
|
r67 | void QChart::zoomOut() | ||
{ | ||||
|
r439 | m_presenter->zoomOut(); | ||
|
r67 | } | ||
|
r287 | /*! | ||
Resets to the default view. | ||||
*/ | ||||
|
r93 | void QChart::zoomReset() | ||
{ | ||||
|
r439 | m_presenter->zoomReset(); | ||
|
r176 | } | ||
|
r277 | /*! | ||
Returns the pointer to the x axis object of the chart | ||||
*/ | ||||
|
r223 | QChartAxis* QChart::axisX() const | ||
|
r176 | { | ||
|
r223 | return m_dataset->axisX(); | ||
|
r176 | } | ||
|
r277 | /*! | ||
Returns the pointer to the y axis object of the chart | ||||
*/ | ||||
|
r223 | QChartAxis* QChart::axisY() const | ||
|
r176 | { | ||
|
r223 | return m_dataset->axisY(); | ||
|
r85 | } | ||
|
r287 | /*! | ||
Resizes and updates the chart area using the \a event data | ||||
*/ | ||||
|
r115 | void QChart::resizeEvent(QGraphicsSceneResizeEvent *event) | ||
{ | ||||
m_rect = QRectF(QPoint(0,0),event->newSize()); | ||||
QRectF rect = m_rect.adjusted(margin(),margin(), -margin(), -margin()); | ||||
// recalculate title position | ||||
if (m_titleItem) { | ||||
QPointF center = m_rect.center() -m_titleItem->boundingRect().center(); | ||||
m_titleItem->setPos(center.x(),m_rect.top()/2 + margin()/2); | ||||
} | ||||
//recalculate background gradient | ||||
if (m_backgroundItem) { | ||||
m_backgroundItem->setRect(rect); | ||||
} | ||||
|
r117 | QGraphicsWidget::resizeEvent(event); | ||
|
r115 | update(); | ||
} | ||||
|
r298 | /*! | ||
|
r302 | Sets animation \a options for the chart | ||
|
r298 | */ | ||
void QChart::setAnimationOptions(AnimationOptions options) | ||||
{ | ||||
m_presenter->setAnimationOptions(options); | ||||
} | ||||
/*! | ||||
Returns animation options for the chart | ||||
*/ | ||||
QChart::AnimationOptions QChart::animationOptions() const | ||||
{ | ||||
return m_presenter->animationOptions(); | ||||
} | ||||
|
r64 | #include "moc_qchart.cpp" | ||
|
r48 | |||
|
r30 | QTCOMMERCIALCHART_END_NAMESPACE | ||