qvpiemodelmapper.cpp
260 lines
| 7.6 KiB
| text/x-c
|
CppLexer
|
r1309 | /**************************************************************************** | ||
** | ||||
** Copyright (C) 2012 Digia Plc | ||||
** All rights reserved. | ||||
** For any questions to Digia, please use contact form at http://qt.digia.com | ||||
** | ||||
** This file is part of the Qt Commercial Charts Add-on. | ||||
** | ||||
** $QT_BEGIN_LICENSE$ | ||||
** Licensees holding valid Qt Commercial licenses may use this file in | ||||
** accordance with the Qt Commercial License Agreement provided with the | ||||
** Software or, alternatively, in accordance with the terms contained in | ||||
** a written agreement between you and Digia. | ||||
** | ||||
** If you have questions regarding the use of this file, please use | ||||
** contact form at http://qt.digia.com | ||||
** $QT_END_LICENSE$ | ||||
** | ||||
****************************************************************************/ | ||||
|
r1237 | #include "qvpiemodelmapper.h" | ||
QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||||
|
r1331 | /*! | ||
\class QVPieModelMapper | ||||
\mainclass | ||||
|
r1397 | Model mappers allow you to use QAbstractItemModel derived models as a data source for a chart series. | ||
|
r1378 | Vertical model mapper is used to create a connection between QPieSeries and QAbstractItemModel derived model object that keeps the consecutive pie slices data in columns. | ||
|
r1340 | It is possible to use both QAbstractItemModel and QPieSeries model API. QVPieModelMapper makes sure that Pie and the model are kept in sync. | ||
NOTE: used model has to support adding/removing rows/columns and modifying the data of the cells. | ||||
*/ | ||||
|
r1516 | /*! | ||
\qmlclass VPieModelMapper QVPieModelMapper | ||||
VPieModelMapper allows you to use your own QAbstractItemModel derived model with data in columns as a data source | ||||
for a pie series. It is possible to use both QAbstractItemModel and PieSeries data API to manipulate data. | ||||
VPieModelMapper keeps the Pie and the model in sync. | ||||
The following QML example would create a pie series with four slices (assuming the model has at least five rows). | ||||
Each slice would contain a label from column 1 and a value from column 2. | ||||
\code | ||||
VPieModelMapper { | ||||
series: pieSeries | ||||
model: customModel | ||||
labelsColumn: 1 | ||||
valuesColumn: 2 | ||||
firstRow: 1 | ||||
rowCount: 4 | ||||
} | ||||
\endcode | ||||
*/ | ||||
|
r1340 | |||
|
r1508 | /*! | ||
\property QVPieModelMapper::series | ||||
\brief Defines the QPieSeries object that is used by the mapper. | ||||
All the data in the series is discarded when it is set to the mapper. | ||||
When new series is specified the old series is disconnected (it preserves its data) | ||||
*/ | ||||
|
r1516 | /*! | ||
\qmlproperty PieSeries VPieModelMapper::series | ||||
Defines the PieSeries object that is used by the mapper. If you define the mapper element as a child for a | ||||
PieSeries, leave this property undefined. All the data in the series is discarded when it is set to the mapper. | ||||
When new series is specified the old series is disconnected (it preserves its data). | ||||
*/ | ||||
|
r1508 | |||
/*! | ||||
\property QVPieModelMapper::model | ||||
\brief Defines the model that is used by the mapper. | ||||
*/ | ||||
|
r1516 | /*! | ||
\qmlproperty SomeModel VPieModelMapper::model | ||||
The QAbstractItemModel based model that is used by the mapper. You need to implement the model and expose it to | ||||
QML as shown in \l {QML Custom Model} demo application. NOTE: the model has to support adding/removing rows/columns | ||||
and modifying the data of the cells. | ||||
*/ | ||||
|
r1508 | |||
|
r1340 | /*! | ||
\property QVPieModelMapper::valuesColumn | ||||
\brief Defines which column of the model is kept in sync with the values of the pie's slices | ||||
Default value is: -1 (invalid mapping) | ||||
*/ | ||||
|
r1516 | /*! | ||
\qmlproperty int VPieModelMapper::valuesColumn | ||||
Defines which column of the model is kept in sync with the values of the pie's slices. Default value is -1 (invalid | ||||
mapping). | ||||
*/ | ||||
|
r1340 | |||
/*! | ||||
\property QVPieModelMapper::labelsColumn | ||||
\brief Defines which column of the model is kept in sync with the labels of the pie's slices | ||||
Default value is: -1 (invalid mapping) | ||||
|
r1331 | */ | ||
|
r1516 | /*! | ||
\qmlproperty int VPieModelMapper::labelsColumn | ||||
Defines which column of the model is kept in sync with the labels of the pie's slices. Default value is -1 (invalid | ||||
mapping). | ||||
*/ | ||||
|
r1331 | |||
|
r1499 | /*! | ||
\property QVPieModelMapper::firstRow | ||||
\brief Defines which row of the model contains the first slice value. | ||||
Minimal and default value is: 0 | ||||
*/ | ||||
/*! | ||||
|
r1516 | \qmlproperty int VPieModelMapper::firstRow | ||
|
r1499 | Defines which row of the model contains the first slice value. | ||
The default value is 0. | ||||
*/ | ||||
/*! | ||||
\property QVPieModelMapper::rowCount | ||||
\brief Defines the number of rows of the model that are mapped as the data for QPieSeries | ||||
Minimal and default value is: -1 (count limited by the number of rows in the model) | ||||
*/ | ||||
/*! | ||||
|
r1516 | \qmlproperty int VPieModelMapper::columnCount | ||
|
r1499 | Defines the number of rows of the model that are mapped as the data for QPieSeries. The default value is | ||
-1 (count limited by the number of rows in the model) | ||||
*/ | ||||
|
r1508 | /*! | ||
\fn void QVPieModelMapper::seriesReplaced() | ||||
Emitted when the series to which mapper is connected to has changed. | ||||
*/ | ||||
/*! | ||||
\fn void QVPieModelMapper::modelReplaced() | ||||
Emitted when the model to which mapper is connected to has changed. | ||||
*/ | ||||
|
r1476 | /*! | ||
\fn void QVPieModelMapper::valuesColumnChanged() | ||||
Emitted when the valuesColumn has changed. | ||||
*/ | ||||
/*! | ||||
\fn void QVPieModelMapper::labelsColumnChanged() | ||||
Emitted when the labelsColumn has changed. | ||||
*/ | ||||
|
r1499 | /*! | ||
\fn void QVPieModelMapper::firstRowChanged() | ||||
Emitted when the firstRow has changed. | ||||
*/ | ||||
/*! | ||||
\fn void QVPieModelMapper::rowCountChanged() | ||||
Emitted when the rowCount has changed. | ||||
*/ | ||||
|
r1347 | /*! | ||
Constructs a mapper object which is a child of \a parent. | ||||
*/ | ||||
|
r1237 | QVPieModelMapper::QVPieModelMapper(QObject *parent) : | ||
QPieModelMapper(parent) | ||||
{ | ||||
QPieModelMapper::setOrientation(Qt::Vertical); | ||||
} | ||||
|
r1508 | QAbstractItemModel* QVPieModelMapper::model() const | ||
{ | ||||
return QPieModelMapper::model(); | ||||
} | ||||
void QVPieModelMapper::setModel(QAbstractItemModel *model) | ||||
{ | ||||
if (model != QPieModelMapper::model()) { | ||||
QPieModelMapper::setModel(model); | ||||
emit modelReplaced(); | ||||
} | ||||
} | ||||
QPieSeries* QVPieModelMapper::series() const | ||||
{ | ||||
return QPieModelMapper::series(); | ||||
} | ||||
void QVPieModelMapper::setSeries(QPieSeries *series) | ||||
{ | ||||
if (series != QPieModelMapper::series()) { | ||||
QPieModelMapper::setSeries(series); | ||||
emit seriesReplaced(); | ||||
} | ||||
} | ||||
|
r1340 | /*! | ||
Returns which column of the model is kept in sync with the values of the pie's slices | ||||
*/ | ||||
|
r1237 | int QVPieModelMapper::valuesColumn() const | ||
{ | ||||
|
r1320 | return QPieModelMapper::valuesSection(); | ||
|
r1237 | } | ||
|
r1340 | /*! | ||
Sets the model column that is kept in sync with the pie slices values. | ||||
Parameter \a valuesColumn specifies the row of the model. | ||||
*/ | ||||
|
r1237 | void QVPieModelMapper::setValuesColumn(int valuesColumn) | ||
{ | ||||
|
r1474 | if (valuesColumn != valuesSection()) { | ||
QPieModelMapper::setValuesSection(valuesColumn); | ||||
emit valuesColumnChanged(); | ||||
} | ||||
|
r1237 | } | ||
|
r1340 | /*! | ||
Returns which column of the model is kept in sync with the labels of the pie's slices | ||||
*/ | ||||
|
r1237 | int QVPieModelMapper::labelsColumn() const | ||
{ | ||||
|
r1320 | return QPieModelMapper::labelsSection(); | ||
|
r1237 | } | ||
|
r1340 | /*! | ||
Sets the model column that is kept in sync with the pie's slices labels. | ||||
Parameter \a labelsColumn specifies the row of the model. | ||||
*/ | ||||
|
r1237 | void QVPieModelMapper::setLabelsColumn(int labelsColumn) | ||
{ | ||||
|
r1474 | if (labelsColumn != labelsSection()) { | ||
QPieModelMapper::setLabelsSection(labelsColumn); | ||||
emit labelsColumnChanged(); | ||||
} | ||||
|
r1237 | } | ||
|
r1499 | int QVPieModelMapper::firstRow() const | ||
{ | ||||
return first(); | ||||
} | ||||
void QVPieModelMapper::setFirstRow(int firstRow) | ||||
{ | ||||
if (firstRow != first()) { | ||||
setFirst(firstRow); | ||||
emit firstRowChanged(); | ||||
} | ||||
} | ||||
int QVPieModelMapper::rowCount() const | ||||
{ | ||||
return count(); | ||||
} | ||||
void QVPieModelMapper::setRowCount(int rowCount) | ||||
{ | ||||
if (rowCount != count()) { | ||||
setCount(rowCount); | ||||
|
r1923 | emit rowCountChanged(); | ||
|
r1499 | } | ||
} | ||||
|
r1237 | #include "moc_qvpiemodelmapper.cpp" | ||
QTCOMMERCIALCHART_END_NAMESPACE | ||||