##// END OF EJS Templates
Remove header.GPL now that it exists in QtBase...
Remove header.GPL now that it exists in QtBase Change-Id: I2cb53cb638b00bef34a313b0678066ef91c6d7a2 Reviewed-by: Tomi Korpipää <tomi.korpipaa@theqtcompany.com> Reviewed-by: Miikka Heikkinen <miikka.heikkinen@theqtcompany.com>

File last commit:

r2854:46147b040d06
r2856:f5f060e330b7
Show More
qhpiemodelmapper.cpp
275 lines | 8.2 KiB | text/x-c | CppLexer
/ src / charts / piechart / qhpiemodelmapper.cpp
Miikka Heikkinen
Updated license...
r2854 /****************************************************************************
Marek Rosa
Added license text to piemodelmapper classes
r1309 **
Miikka Heikkinen
Updated license...
r2854 ** Copyright (C) 2016 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
Marek Rosa
Added license text to piemodelmapper classes
r1309 **
Miikka Heikkinen
Updated license...
r2854 ** This file is part of the Qt Charts module of the Qt Toolkit.
Marek Rosa
Added license text to piemodelmapper classes
r1309 **
Miikka Heikkinen
Updated license...
r2854 ** $QT_BEGIN_LICENSE:GPL$
Titta Heikkala
Updated license headers...
r2845 ** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
Miikka Heikkinen
Updated license...
r2854 ** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3 or (at your option) any later version
** approved by the KDE Free Qt Foundation. The licenses are as published by
** the Free Software Foundation and appearing in the file LICENSE.GPL3
** included in the packaging of this file. Please review the following
** information to ensure the GNU General Public License requirements will
** be met: https://www.gnu.org/licenses/gpl-3.0.html.
Marek Rosa
Added license text to piemodelmapper classes
r1309 **
Titta Heikkala
Updated license headers...
r2845 ** $QT_END_LICENSE$
**
Miikka Heikkinen
Updated license...
r2854 ****************************************************************************/
Marek Rosa
Added license text to piemodelmapper classes
r1309
Titta Heikkala
Fix include syntax...
r2714 #include <QtCharts/QHPieModelMapper>
Marek Rosa
Added Vertical and Horizontal PieModelMapper
r1237
Titta Heikkala
Qt Charts project file structure change...
r2712 QT_CHARTS_BEGIN_NAMESPACE
Marek Rosa
Added Vertical and Horizontal PieModelMapper
r1237
Marek Rosa
Added placeholders for mappers documentation
r1331 /*!
\class QHPieModelMapper
Titta Heikkala
Fix Charts documentation...
r2639 \inmodule Qt Charts
Titta Heikkala
Qt Charts project file structure change...
r2712 \brief Horizontal model mapper for pie series.
Marek Rosa
Added placeholders for mappers documentation
r1331
Marek Rosa
Updated mapper classes descriptions
r1397 Model mappers allow you to use QAbstractItemModel derived models as a data source for a chart series.
Marek Rosa
Model mappers docs updated
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.
Marek Rosa
Added documentation for PieModelMapper classes
r1340 It is possible to use both QAbstractItemModel and QPieSeries model API. QHPieModelMapper makes sure that Pie and the model are kept in sync.
Miikka Heikkinen
Documentation updates...
r2494 \note Used model has to support adding/removing rows/columns and modifying the data of the cells.
Marek Rosa
Added documentation for PieModelMapper classes
r1340 */
Tero Ahola
QML model mapper documentation for pie and xy
r1516 /*!
Titta Heikkala
Fix Charts documentation...
r2639 \qmltype HPieModelMapper
\instantiates QHPieModelMapper
Titta Heikkala
Qt Charts project file structure change...
r2712 \inqmlmodule QtCharts
\brief Horizontal model mapper for pie series.
HPieModelMapper allows you to use your own QAbstractItemModel derived model with data in rows as
a data source for a pie series. It is possible to use both QAbstractItemModel and PieSeries data
API to manipulate data. HPieModelMapper 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 columns). Each slice would contain a label from row 1 and a value from row 2.
\code
HPieModelMapper {
series: pieSeries
model: customModel
labelsRow: 1
valuesRow: 2
firstColumn: 1
columnCount: 4
}
\endcode
Tero Ahola
QML model mapper documentation for pie and xy
r1516 */
Marek Rosa
Added documentation for PieModelMapper classes
r1340
Marek Rosa
PieModelMapper removed from the docs
r1508 /*!
\property QHPieModelMapper::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)
*/
Tero Ahola
QML model mapper documentation for pie and xy
r1516 /*!
\qmlproperty PieSeries HPieModelMapper::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).
*/
Marek Rosa
PieModelMapper removed from the docs
r1508
/*!
\property QHPieModelMapper::model
\brief Defines the model that is used by the mapper.
*/
Tero Ahola
QML model mapper documentation for pie and xy
r1516 /*!
\qmlproperty SomeModel HPieModelMapper::model
Titta Heikkala
Remove qmlcustommodel demo...
r2618 The QAbstractItemModel based model that is used by the mapper. You need to implement the model
and expose it to QML. Note: the model has to support adding/removing rows/columns and modifying
the data of the cells.
Tero Ahola
QML model mapper documentation for pie and xy
r1516 */
Marek Rosa
PieModelMapper removed from the docs
r1508
Marek Rosa
Added documentation for PieModelMapper classes
r1340 /*!
\property QHPieModelMapper::valuesRow
Miikka Heikkinen
Fix some documentation issues...
r2520 \brief Defines which row of the model is kept in sync with the values of the pie's slices.
Marek Rosa
Added documentation for PieModelMapper classes
r1340 Default value is: -1 (invalid mapping)
*/
Tero Ahola
QML model mapper documentation for pie and xy
r1516 /*!
\qmlproperty int HPieModelMapper::valuesRow
Defines which row of the model is kept in sync with the values of the pie's slices. Default value is: -1 (invalid
mapping).
*/
Marek Rosa
Added documentation for PieModelMapper classes
r1340
/*!
\property QHPieModelMapper::labelsRow
Miikka Heikkinen
Fix some documentation issues...
r2520 \brief Defines which row of the model is kept in sync with the labels of the pie's slices.
Tero Ahola
QML model mapper documentation for pie and xy
r1516 Default value is: -1 (invalid mapping)
*/
/*!
\qmlproperty int HPieModelMapper::labelsRow
Defines which row of the model is kept in sync with the labels of the pie's slices
Marek Rosa
Added documentation for PieModelMapper classes
r1340 Default value is: -1 (invalid mapping)
Marek Rosa
Added placeholders for mappers documentation
r1331 */
Marek Rosa
PieModelMapper properties first and count moved to Vertical and Horizontal mappers with more descriptive names
r1499 /*!
\property QHPieModelMapper::firstColumn
\brief Defines which column of the model contains the first slice value.
Miikka Heikkinen
Fix some documentation issues...
r2520
Marek Rosa
PieModelMapper properties first and count moved to Vertical and Horizontal mappers with more descriptive names
r1499 Minimal and default value is: 0
*/
/*!
Tero Ahola
QML model mapper documentation for pie and xy
r1516 \qmlproperty int HPieModelMapper::firstColumn
Marek Rosa
PieModelMapper properties first and count moved to Vertical and Horizontal mappers with more descriptive names
r1499 Defines which column of the model contains the first slice value.
The default value is 0.
*/
/*!
\property QHPieModelMapper::columnCount
Miikka Heikkinen
Fix some documentation issues...
r2520 \brief Defines the number of columns of the model that are mapped as the data for QPieSeries.
Marek Rosa
PieModelMapper properties first and count moved to Vertical and Horizontal mappers with more descriptive names
r1499 Minimal and default value is: -1 (count limited by the number of columns in the model)
*/
/*!
Tero Ahola
QML model mapper documentation for pie and xy
r1516 \qmlproperty int HPieModelMapper::columnCount
Marek Rosa
PieModelMapper properties first and count moved to Vertical and Horizontal mappers with more descriptive names
r1499 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)
*/
Marek Rosa
PieModelMapper removed from the docs
r1508 /*!
\fn void QHPieModelMapper::seriesReplaced()
Emitted when the series to which mapper is connected to has changed.
*/
/*!
\fn void QHPieModelMapper::modelReplaced()
Emitted when the model to which mapper is connected to has changed.
*/
Marek Rosa
Added docs for NOTIFY signals of the PieModelMapper
r1476 /*!
\fn void QHPieModelMapper::valuesRowChanged()
Emitted when the valuesRow has changed.
*/
/*!
\fn void QHPieModelMapper::labelsRowChanged()
Emitted when the labelsRow has changed.
*/
Marek Rosa
PieModelMapper properties first and count moved to Vertical and Horizontal mappers with more descriptive names
r1499 /*!
\fn void QHPieModelMapper::firstColumnChanged()
Emitted when the firstColumn has changed.
*/
/*!
\fn void QHPieModelMapper::columnCountChanged()
Emitted when the columnCount has changed.
*/
Marek Rosa
ModelMappers dosc update
r1347 /*!
Constructs a mapper object which is a child of \a parent.
*/
Marek Rosa
Added Vertical and Horizontal PieModelMapper
r1237 QHPieModelMapper::QHPieModelMapper(QObject *parent) :
QPieModelMapper(parent)
{
Marek Rosa
PieModelMapper properties first and count moved to Vertical and Horizontal mappers with more descriptive names
r1499 setOrientation(Qt::Horizontal);
Marek Rosa
Added Vertical and Horizontal PieModelMapper
r1237 }
Jani Honkonen
more coding style fixes for src-folder...
r2104 QAbstractItemModel *QHPieModelMapper::model() const
Marek Rosa
PieModelMapper removed from the docs
r1508 {
return QPieModelMapper::model();
}
void QHPieModelMapper::setModel(QAbstractItemModel *model)
{
if (model != QPieModelMapper::model()) {
QPieModelMapper::setModel(model);
emit modelReplaced();
}
}
Jani Honkonen
more coding style fixes for src-folder...
r2104 QPieSeries *QHPieModelMapper::series() const
Marek Rosa
PieModelMapper removed from the docs
r1508 {
return QPieModelMapper::series();
}
void QHPieModelMapper::setSeries(QPieSeries *series)
{
if (series != QPieModelMapper::series()) {
QPieModelMapper::setSeries(series);
emit seriesReplaced();
}
}
Marek Rosa
Added documentation for PieModelMapper classes
r1340 /*!
Returns which row of the model is kept in sync with the values of the pie's slices
*/
Marek Rosa
Added Vertical and Horizontal PieModelMapper
r1237 int QHPieModelMapper::valuesRow() const
{
Marek Rosa
PieModelMapper properties first and count moved to Vertical and Horizontal mappers with more descriptive names
r1499 return valuesSection();
Marek Rosa
Added Vertical and Horizontal PieModelMapper
r1237 }
Marek Rosa
Added documentation for PieModelMapper classes
r1340 /*!
Sets the model row that is kept in sync with the pie slices values.
Parameter \a valuesRow specifies the row of the model.
*/
Marek Rosa
Added Vertical and Horizontal PieModelMapper
r1237 void QHPieModelMapper::setValuesRow(int valuesRow)
{
Marek Rosa
Added NOTIFY to PieModelMapper class properties
r1474 if (valuesRow != valuesSection()) {
Marek Rosa
PieModelMapper properties first and count moved to Vertical and Horizontal mappers with more descriptive names
r1499 setValuesSection(valuesRow);
Marek Rosa
Added NOTIFY to PieModelMapper class properties
r1474 emit valuesRowChanged();
}
Marek Rosa
Added Vertical and Horizontal PieModelMapper
r1237 }
Marek Rosa
Added documentation for PieModelMapper classes
r1340 /*!
Returns which row of the model is kept in sync with the labels of the pie's slices
*/
Marek Rosa
Added Vertical and Horizontal PieModelMapper
r1237 int QHPieModelMapper::labelsRow() const
{
Marek Rosa
PieModelMapper properties first and count moved to Vertical and Horizontal mappers with more descriptive names
r1499 return labelsSection();
Marek Rosa
Added Vertical and Horizontal PieModelMapper
r1237 }
Marek Rosa
Added documentation for PieModelMapper classes
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.
*/
Marek Rosa
Added Vertical and Horizontal PieModelMapper
r1237 void QHPieModelMapper::setLabelsRow(int labelsRow)
{
Marek Rosa
Added NOTIFY to PieModelMapper class properties
r1474 if (labelsRow != labelsSection()) {
Marek Rosa
PieModelMapper properties first and count moved to Vertical and Horizontal mappers with more descriptive names
r1499 setLabelsSection(labelsRow);
Marek Rosa
Added NOTIFY to PieModelMapper class properties
r1474 emit labelsRowChanged();
}
Marek Rosa
Added Vertical and Horizontal PieModelMapper
r1237 }
Marek Rosa
PieModelMapper properties first and count moved to Vertical and Horizontal mappers with more descriptive names
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);
Marek Rosa
Fix: wrong signal emitted in pie and bar model mappers
r1923 emit columnCountChanged();
Marek Rosa
PieModelMapper properties first and count moved to Vertical and Horizontal mappers with more descriptive names
r1499 }
}
Marek Rosa
Added Vertical and Horizontal PieModelMapper
r1237 #include "moc_qhpiemodelmapper.cpp"
Titta Heikkala
Qt Charts project file structure change...
r2712 QT_CHARTS_END_NAMESPACE