qhpiemodelmapper.cpp
171 lines
| 4.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 "qhpiemodelmapper.h" | ||
QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||||
|
r1331 | /*! | ||
\class QHPieModelMapper | ||||
\brief part of QtCommercial chart API. | ||||
\mainclass | ||||
|
r1397 | Model mappers allow you to use QAbstractItemModel derived models as a data source for a chart series. | ||
|
r1378 | Horizontal model mapper is used to create a connection between QPieSeries and QAbstractItemModel derived model object that keeps the consecutive pie slices data in rows. | ||
|
r1340 | It is possible to use both QAbstractItemModel and QPieSeries model API. QHPieModelMapper 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. | ||||
*/ | ||||
/*! | ||||
\property QHPieModelMapper::valuesRow | ||||
\brief Defines which row of the model is kept in sync with the values of the pie's slices | ||||
Default value is: -1 (invalid mapping) | ||||
*/ | ||||
/*! | ||||
\property QHPieModelMapper::labelsRow | ||||
\brief Defines which row of the model is kept in sync with the labels of the pie's slices | ||||
Default value is: -1 (invalid mapping) | ||||
|
r1331 | */ | ||
|
r1499 | /*! | ||
\property QHPieModelMapper::firstColumn | ||||
\brief Defines which column of the model contains the first slice value. | ||||
Minimal and default value is: 0 | ||||
*/ | ||||
/*! | ||||
\qmlproperty int QHPieModelMapper::firstColumn | ||||
Defines which column of the model contains the first slice value. | ||||
The default value is 0. | ||||
*/ | ||||
/*! | ||||
\property QHPieModelMapper::columnCount | ||||
\brief Defines the number of columns of the model that are mapped as the data for QPieSeries | ||||
Minimal and default value is: -1 (count limited by the number of columns in the model) | ||||
*/ | ||||
/*! | ||||
\qmlproperty int QHPieModelMapper::columnCount | ||||
Defines the number of columns of the model that are mapped as the data for QPieSeries. The default value is | ||||
-1 (count limited by the number of columns in the model) | ||||
*/ | ||||
|
r1476 | /*! | ||
\fn void QHPieModelMapper::valuesRowChanged() | ||||
Emitted when the valuesRow has changed. | ||||
*/ | ||||
/*! | ||||
\fn void QHPieModelMapper::labelsRowChanged() | ||||
Emitted when the labelsRow has changed. | ||||
*/ | ||||
|
r1499 | /*! | ||
\fn void QHPieModelMapper::firstColumnChanged() | ||||
Emitted when the firstColumn has changed. | ||||
*/ | ||||
/*! | ||||
\fn void QHPieModelMapper::columnCountChanged() | ||||
Emitted when the columnCount has changed. | ||||
*/ | ||||
|
r1347 | /*! | ||
Constructs a mapper object which is a child of \a parent. | ||||
*/ | ||||
|
r1237 | QHPieModelMapper::QHPieModelMapper(QObject *parent) : | ||
QPieModelMapper(parent) | ||||
{ | ||||
|
r1499 | setOrientation(Qt::Horizontal); | ||
|
r1237 | } | ||
|
r1340 | /*! | ||
Returns which row of the model is kept in sync with the values of the pie's slices | ||||
*/ | ||||
|
r1237 | int QHPieModelMapper::valuesRow() const | ||
{ | ||||
|
r1499 | return valuesSection(); | ||
|
r1237 | } | ||
|
r1340 | /*! | ||
Sets the model row that is kept in sync with the pie slices values. | ||||
Parameter \a valuesRow specifies the row of the model. | ||||
*/ | ||||
|
r1237 | void QHPieModelMapper::setValuesRow(int valuesRow) | ||
{ | ||||
|
r1474 | if (valuesRow != valuesSection()) { | ||
|
r1499 | setValuesSection(valuesRow); | ||
|
r1474 | emit valuesRowChanged(); | ||
} | ||||
|
r1237 | } | ||
|
r1340 | /*! | ||
Returns which row of the model is kept in sync with the labels of the pie's slices | ||||
*/ | ||||
|
r1237 | int QHPieModelMapper::labelsRow() const | ||
{ | ||||
|
r1499 | return labelsSection(); | ||
|
r1237 | } | ||
|
r1340 | /*! | ||
Sets the model row that is kept in sync with the pie's slices labels. | ||||
Parameter \a labelsRow specifies the row of the model. | ||||
*/ | ||||
|
r1237 | void QHPieModelMapper::setLabelsRow(int labelsRow) | ||
{ | ||||
|
r1474 | if (labelsRow != labelsSection()) { | ||
|
r1499 | setLabelsSection(labelsRow); | ||
|
r1474 | emit labelsRowChanged(); | ||
} | ||||
|
r1237 | } | ||
|
r1499 | int QHPieModelMapper::firstColumn() const | ||
{ | ||||
return first(); | ||||
} | ||||
void QHPieModelMapper::setFirstColumn(int firstColumn) | ||||
{ | ||||
if (firstColumn != first()) { | ||||
setFirst(firstColumn); | ||||
emit firstColumnChanged(); | ||||
} | ||||
} | ||||
int QHPieModelMapper::columnCount() const | ||||
{ | ||||
return count(); | ||||
} | ||||
void QHPieModelMapper::setColumnCount(int columnCount) | ||||
{ | ||||
if (columnCount != count()) { | ||||
setCount(columnCount); | ||||
emit firstColumnChanged(); | ||||
} | ||||
} | ||||
|
r1237 | #include "moc_qhpiemodelmapper.cpp" | ||
QTCOMMERCIALCHART_END_NAMESPACE | ||||