qbarseries.cpp
252 lines
| 5.7 KiB
| text/x-c
|
CppLexer
sauimone
|
r71 | #include <QDebug> | ||
|
sauimone
|
r338 | #include "qbarseries.h" | ||
|
sauimone
|
r172 | #include "qbarcategory.h" | ||
| #include "qbarset.h" | ||||
| #include "barchartmodel_p.h" | ||||
|
sauimone
|
r126 | |||
|
sauimone
|
r56 | QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||
|
sauimone
|
r313 | /*! | ||
|
sauimone
|
r338 | \class QBarSeries | ||
|
sauimone
|
r313 | \brief part of QtCommercial chart API. | ||
|
sauimone
|
r338 | QBarSeries represents a series of data shown as bars. One QBarSeries can contain multible | ||
| QBarSet data sets. QBarSeries groups the data from sets to categories, which are defined | ||||
|
sauimone
|
r313 | by QBarCategory class. | ||
|
sauimone
|
r319 | \mainclass | ||
|
sauimone
|
r325 | Example on how to create category: | ||
| \snippet ../example/barchart/main.cpp 1 | ||||
| Example on how to create sets of data: | ||||
|
sauimone
|
r319 | \snippet ../example/barchart/main.cpp 2 | ||
|
sauimone
|
r325 | Example on how to add sets to bar chart: | ||
| \snippet ../example/barchart/main.cpp 3 | ||||
|
sauimone
|
r319 | |||
| Example on how to enable tooltip and floating values: | ||||
|
sauimone
|
r325 | \snippet ../example/barchart/main.cpp 4 | ||
| Example on how to create view and apply theme: | ||||
| \snippet ../example/barchart/main.cpp 5 | ||||
|
sauimone
|
r319 | |||
|
sauimone
|
r338 | \sa QBarCategory, QBarSet, QStackedBarSeries, QPercentBarSeries | ||
|
sauimone
|
r313 | */ | ||
| /*! | ||||
|
sauimone
|
r338 | \fn virtual QChartSeriesType QBarSeries::type() const | ||
|
sauimone
|
r313 | \brief Returns type of series. | ||
| \sa QChartSeries, QChartSeriesType | ||||
| */ | ||||
| /*! | ||||
|
sauimone
|
r338 | \fn void QBarSeries::changed(int index) | ||
|
sauimone
|
r319 | \brief \internal \a index | ||
|
sauimone
|
r313 | */ | ||
| /*! | ||||
|
sauimone
|
r338 | \fn void QBarSeries::floatingValuesEnabled(bool enabled) | ||
|
sauimone
|
r319 | \brief \internal \a enabled | ||
|
sauimone
|
r313 | */ | ||
| /*! | ||||
|
sauimone
|
r338 | \fn void QBarSeries::toolTipEnabled(bool enabled) | ||
|
sauimone
|
r319 | \brief \internal \a enabled | ||
|
sauimone
|
r313 | */ | ||
| /*! | ||||
|
sauimone
|
r338 | \fn void QBarSeries::separatorsEnabled(bool enabled) | ||
|
sauimone
|
r319 | \brief \internal \a enabled | ||
|
sauimone
|
r313 | */ | ||
| /*! | ||||
|
sauimone
|
r338 | \fn void QBarSeries::showToolTip(QPoint pos, QString tip) | ||
|
sauimone
|
r319 | \brief \internal \a pos \a tip | ||
|
sauimone
|
r313 | */ | ||
| /*! | ||||
|
sauimone
|
r338 | Constructs empty QBarSeries. Parameter \a category defines the categories for chart. | ||
|
sauimone
|
r323 | Takes ownership of \a category. | ||
|
sauimone
|
r338 | QBarSeries is QObject which is a child of a \a parent. | ||
|
sauimone
|
r313 | */ | ||
|
sauimone
|
r338 | QBarSeries::QBarSeries(QBarCategory *category, QObject *parent) | ||
|
sauimone
|
r172 | : QChartSeries(parent) | ||
| ,mModel(new BarChartModel(category, this)) | ||||
|
sauimone
|
r71 | { | ||
| } | ||||
|
sauimone
|
r313 | /*! | ||
| Adds a set of bars to series. Takes ownership of \a set | ||||
| */ | ||||
|
sauimone
|
r338 | void QBarSeries::addBarSet(QBarSet *set) | ||
|
sauimone
|
r171 | { | ||
|
sauimone
|
r172 | mModel->addBarSet(set); | ||
|
sauimone
|
r171 | } | ||
|
sauimone
|
r313 | /*! | ||
| Removes a set of bars from series. Releases ownership of \a set. Doesnt delete \a set. | ||||
| */ | ||||
|
sauimone
|
r338 | void QBarSeries::removeBarSet(QBarSet *set) | ||
|
sauimone
|
r171 | { | ||
|
sauimone
|
r172 | mModel->removeBarSet(set); | ||
| } | ||||
|
sauimone
|
r313 | /*! | ||
| Returns number of sets in series. | ||||
| */ | ||||
|
sauimone
|
r338 | int QBarSeries::countSets() | ||
|
sauimone
|
r214 | { | ||
| return mModel->countSets(); | ||||
| } | ||||
|
sauimone
|
r323 | /*! | ||
| Returns number of categories in series | ||||
| */ | ||||
|
sauimone
|
r338 | int QBarSeries::countCategories() | ||
|
sauimone
|
r323 | { | ||
| return mModel->countCategories(); | ||||
| } | ||||
|
sauimone
|
r313 | /*! | ||
| Simple iterator for set. Returns pointer to next set in series. | ||||
|
sauimone
|
r319 | Returns first set, if parameter \a getFirst is true. | ||
| If series is empty, returns 0. | ||||
| Returns 0 after last set. | ||||
|
sauimone
|
r313 | */ | ||
|
sauimone
|
r338 | QBarSet* QBarSeries::nextSet(bool getFirst) | ||
|
sauimone
|
r214 | { | ||
| return mModel->nextSet(getFirst); | ||||
| } | ||||
|
sauimone
|
r313 | /*! | ||
| Returns set indexed by \a index. Doesn't check for index bounds. | ||||
| Assumes that \a index is between 0 and number of sets. Use countSets() to get valid index bound. | ||||
| \sa countSets() | ||||
| */ | ||||
|
sauimone
|
r338 | QBarSet* QBarSeries::setAt(int index) | ||
|
sauimone
|
r288 | { | ||
| return mModel->setAt(index); | ||||
| } | ||||
|
sauimone
|
r313 | /*! | ||
| Returns legend of series. Legend is a list of set names in series. | ||||
| */ | ||||
|
sauimone
|
r338 | QList<QString> QBarSeries::legend() | ||
|
sauimone
|
r280 | { | ||
| return mModel->legend(); | ||||
| } | ||||
|
sauimone
|
r313 | /*! | ||
|
sauimone
|
r319 | \internal \a category | ||
|
sauimone
|
r313 | */ | ||
|
sauimone
|
r338 | QString QBarSeries::label(int category) | ||
|
sauimone
|
r288 | { | ||
| return mModel->label(category); | ||||
| } | ||||
|
sauimone
|
r313 | /*! | ||
| Enables or disables floating values depending on parameter \a enabled. | ||||
| Floating values are bar values, that are displayed on top of each bar. | ||||
| Calling without parameter \a enabled, enables the floating values | ||||
| */ | ||||
|
sauimone
|
r338 | void QBarSeries::enableFloatingValues(bool enabled) | ||
|
sauimone
|
r280 | { | ||
|
sauimone
|
r296 | if (enabled) { | ||
| for (int i=0; i<mModel->countSets(); i++) { | ||||
| QBarSet *set = mModel->setAt(i); | ||||
| connect(set,SIGNAL(clicked()),set,SIGNAL(toggleFloatingValues())); | ||||
| } | ||||
| } else { | ||||
| for (int i=0; i<mModel->countSets(); i++) { | ||||
| QBarSet *set = mModel->setAt(i); | ||||
| disconnect(set,SIGNAL(clicked()),set,SIGNAL(toggleFloatingValues())); | ||||
| } | ||||
| } | ||||
|
sauimone
|
r280 | } | ||
|
sauimone
|
r313 | /*! | ||
| Enables or disables tooltip depending on parameter \a enabled. | ||||
| Tooltip shows the name of set, when mouse is hovering on top of bar. | ||||
| Calling without parameter \a enabled, enables the tooltip | ||||
| */ | ||||
|
sauimone
|
r338 | void QBarSeries::enableToolTip(bool enabled) | ||
|
sauimone
|
r280 | { | ||
|
sauimone
|
r296 | if (enabled) { | ||
| for (int i=0; i<mModel->countSets(); i++) { | ||||
| QBarSet *set = mModel->setAt(i); | ||||
| connect(set,SIGNAL(showToolTip(QPoint,QString)),this,SIGNAL(showToolTip(QPoint,QString))); | ||||
| } | ||||
| } else { | ||||
| for (int i=0; i<mModel->countSets(); i++) { | ||||
| QBarSet *set = mModel->setAt(i); | ||||
| disconnect(set,SIGNAL(showToolTip(QPoint,QString)),this,SIGNAL(showToolTip(QPoint,QString))); | ||||
| } | ||||
| } | ||||
|
sauimone
|
r288 | } | ||
|
sauimone
|
r313 | /*! | ||
| Enables or disables separators depending on parameter \a enabled. | ||||
| Separators are visual elements that are drawn between categories. | ||||
| Calling without parameter \a enabled, enables the separators | ||||
| */ | ||||
|
sauimone
|
r338 | void QBarSeries::enableSeparators(bool enabled) | ||
|
sauimone
|
r288 | { | ||
| emit separatorsEnabled(enabled); | ||||
|
sauimone
|
r280 | } | ||
|
sauimone
|
r313 | /*! | ||
|
sauimone
|
r319 | \internal | ||
|
sauimone
|
r313 | */ | ||
|
sauimone
|
r338 | qreal QBarSeries::min() | ||
|
sauimone
|
r172 | { | ||
| return mModel->min(); | ||||
| } | ||||
|
sauimone
|
r313 | /*! | ||
|
sauimone
|
r319 | \internal | ||
|
sauimone
|
r313 | */ | ||
|
sauimone
|
r338 | qreal QBarSeries::max() | ||
|
sauimone
|
r172 | { | ||
| return mModel->max(); | ||||
|
sauimone
|
r171 | } | ||
|
sauimone
|
r313 | /*! | ||
|
sauimone
|
r319 | \internal \a set \a category | ||
|
sauimone
|
r313 | */ | ||
|
sauimone
|
r338 | qreal QBarSeries::valueAt(int set, int category) | ||
|
sauimone
|
r172 | { | ||
| return mModel->valueAt(set,category); | ||||
| } | ||||
|
sauimone
|
r313 | /*! | ||
|
sauimone
|
r319 | \internal \a set \a category | ||
|
sauimone
|
r313 | */ | ||
|
sauimone
|
r338 | qreal QBarSeries::percentageAt(int set, int category) | ||
|
sauimone
|
r288 | { | ||
| return mModel->percentageAt(set,category); | ||||
| } | ||||
|
sauimone
|
r313 | /*! | ||
|
sauimone
|
r319 | \internal \a category | ||
|
sauimone
|
r313 | */ | ||
|
sauimone
|
r338 | qreal QBarSeries::categorySum(int category) | ||
|
sauimone
|
r288 | { | ||
| return mModel->categorySum(category); | ||||
| } | ||||
|
sauimone
|
r313 | /*! | ||
|
sauimone
|
r319 | \internal | ||
|
sauimone
|
r313 | */ | ||
|
sauimone
|
r338 | qreal QBarSeries::maxCategorySum() | ||
|
sauimone
|
r172 | { | ||
| return mModel->maxCategorySum(); | ||||
| } | ||||
|
sauimone
|
r313 | /*! | ||
|
sauimone
|
r319 | \internal | ||
|
sauimone
|
r313 | */ | ||
|
sauimone
|
r338 | BarChartModel& QBarSeries::model() | ||
|
sauimone
|
r172 | { | ||
| return *mModel; | ||||
| } | ||||
|
sauimone
|
r338 | #include "moc_qbarseries.cpp" | ||
|
sauimone
|
r71 | |||
|
sauimone
|
r56 | QTCOMMERCIALCHART_END_NAMESPACE | ||