##// END OF EJS Templates
Add qml Font properties & docs
Add qml Font properties & docs

File last commit:

r1516:267764825d23
r1517:7e86792a50b2
Show More
qhbarmodelmapper.cpp
249 lines | 7.5 KiB | text/x-c | CppLexer
/ src / barchart / qhbarmodelmapper.cpp
Marek Rosa
Added license text to mapper classes
r1355 /****************************************************************************
**
** 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$
**
****************************************************************************/
Marek Rosa
Added Vertical and Horizontal BarModelMappers
r1294 #include "qhbarmodelmapper.h"
QTCOMMERCIALCHART_BEGIN_NAMESPACE
Marek Rosa
Added placeholders for mappers documentation
r1331 /*!
\class QHBarModelMapper
sauimone
better brief descriptions for barcharts
r1502 \brief Horizontal model mapper for bar series
Marek Rosa
Added placeholders for mappers documentation
r1331 \mainclass
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 QBarSeries and QAbstractItemModel derived model object.
Marek Rosa
Updated BarModelMapper docs
r1485 Model mapper maintains equal size of all the BarSets.
Adding/removing value from the BarSet causes the the same change in the rest of the BarSets added to the same series.
Marek Rosa
Model mappers docs updated
r1378 NOTE: used model has to support adding/removing rows/columns and modifying the data of the cells.
Marek Rosa
Added placeholders for mappers documentation
r1331 */
Tero Ahola
Documenting QML bar model mappers
r1492 /*!
Tero Ahola
QML bar model mapper documentation
r1497 \qmlclass HBarModelMapper QHBarModelMapper
Tero Ahola
Documenting QML bar model mappers
r1492
HBarModelMapper allows you to use your own QAbstractItemModel derived model with data in rows as a data source
Tero Ahola
QML model mapper documentation for pie and xy
r1516 for any bar series. It is possible to use both QAbstractItemModel and bar series data API to manipulate data.
HBarModelMapper keeps the series and the model in sync.
The following QML example would create a bar series with three bar sets (assuming the model has
at least four rows). Each bar set would contain data starting from column 1. The name of a set would be defined by
the vertical header (of the row).
Tero Ahola
Documenting QML bar model mappers
r1492 \code
BarSeries {
HBarModelMapper {
Tero Ahola
QML bar model mapper documentation
r1497 model: myCustomModel // QAbstractItemModel derived implementation
Tero Ahola
Documenting QML bar model mappers
r1492 firstBarSetRow: 1
lastBarSetRow: 3
Tero Ahola
Updated QML bar model mapper property names
r1496 firstColumn: 1
Tero Ahola
Documenting QML bar model mappers
r1492 }
}
\endcode
*/
Marek Rosa
Added placeholders for mappers documentation
r1331
Marek Rosa
BarModelMapper removed from the docs
r1509 /*!
\property QHBarModelMapper::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 bar model mapper documentation
r1497 /*!
\qmlproperty BarSeries HBarModelMapper::series
Defines the BarSeries based 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).
*/
Marek Rosa
BarModelMapper removed from the docs
r1509 /*!
\property QHBarModelMapper::model
\brief Defines the model that is used by the mapper.
*/
Tero Ahola
QML bar model mapper documentation
r1497 /*!
Tero Ahola
QML model mapper documentation for pie and xy
r1516 \qmlproperty SomeModel HBarModelMapper::model
Tero Ahola
QML bar model mapper documentation
r1497 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.
*/
Marek Rosa
Added documentation for BarModelMapper classes
r1348 /*!
\property QHBarModelMapper::firstBarSetRow
\brief Defines which column of the model is used as the data source for the first bar set
Default value is: -1 (invalid mapping)
*/
Tero Ahola
QML bar model mapper documentation
r1497 /*!
\qmlproperty int HBarModelMapper::firstBarSetRow
Defines which column of the model is used as the data source for the first bar set. The default value is -1
(invalid mapping).
*/
Marek Rosa
Added documentation for BarModelMapper classes
r1348
/*!
\property QHBarModelMapper::lastBarSetRow
\brief Defines which column of the model is used as the data source for the last bar set
Default value is: -1 (invalid mapping)
*/
Tero Ahola
QML bar model mapper documentation
r1497 /*!
\qmlproperty int HBarModelMapper::lastBarSetRow
Defines which column of the model is used as the data source for the last bar set. The default value is -1
(invalid mapping).
*/
Marek Rosa
Added documentation for BarModelMapper classes
r1348
Marek Rosa
BarModel mapper properties first, count moved to Vertical and Horizontal mappers with more descriptive names
r1495 /*!
\property QHBarModelMapper::firstColumn
\brief Defines which column of the model contains the first values of the QBarSets in the series.
Minimal and default value is: 0
*/
/*!
Tero Ahola
QML bar model mapper documentation
r1497 \qmlproperty int HBarModelMapper::firstColumn
Marek Rosa
BarModel mapper properties first, count moved to Vertical and Horizontal mappers with more descriptive names
r1495 Defines which column of the model contains the first values of the QBarSets in the series.
The default value is 0.
*/
/*!
\property QHBarModelMapper::columnCount
Tero Ahola
QML bar model mapper documentation
r1497 \brief Defines the number of columns of the model that are mapped as the data for QBarSeries
Minimal and default value is: -1 (count limited by the number of columns in the model)
Marek Rosa
BarModel mapper properties first, count moved to Vertical and Horizontal mappers with more descriptive names
r1495 */
/*!
Tero Ahola
QML bar model mapper documentation
r1497 \qmlproperty int HBarModelMapper::columnCount
Defines the number of columns of the model that are mapped as the data for QBarSeries. The default value is
-1 (count limited by the number of columns in the model)
Marek Rosa
BarModel mapper properties first, count moved to Vertical and Horizontal mappers with more descriptive names
r1495 */
Marek Rosa
BarModelMapper removed from the docs
r1509 /*!
\fn void QHBarModelMapper::seriesReplaced()
Emitted when the series to which mapper is connected to has changed.
*/
/*!
\fn void QHBarModelMapper::modelReplaced()
Emitted when the model to which mapper is connected to has changed.
*/
Marek Rosa
Added NOTIFY to BarModelMapper properties
r1478 /*!
\fn void QHBarModelMapper::firstBarSetRowChanged()
Emitted when the firstBarSetRow has changed.
*/
/*!
\fn void QHBarModelMapper::lastBarSetRowChanged()
Emitted when the lastBarSetRow has changed.
*/
Marek Rosa
BarModel mapper properties first, count moved to Vertical and Horizontal mappers with more descriptive names
r1495 /*!
\fn void QHBarModelMapper::firstColumnChanged()
Emitted when the firstColumn has changed.
*/
/*!
\fn void QHBarModelMapper::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 BarModelMappers
r1294 QHBarModelMapper::QHBarModelMapper(QObject *parent) :
QBarModelMapper(parent)
{
Marek Rosa
Minor fix to barModelMapper
r1311 QBarModelMapper::setOrientation(Qt::Horizontal);
Marek Rosa
Added Vertical and Horizontal BarModelMappers
r1294 }
Marek Rosa
BarModelMapper removed from the docs
r1509 QAbstractItemModel* QHBarModelMapper::model() const
{
return QBarModelMapper::model();
}
void QHBarModelMapper::setModel(QAbstractItemModel *model)
{
if (model != QBarModelMapper::model()) {
QBarModelMapper::setModel(model);
emit modelReplaced();
}
}
QBarSeries* QHBarModelMapper::series() const
{
return QBarModelMapper::series();
}
void QHBarModelMapper::setSeries(QBarSeries *series)
{
if (series != QBarModelMapper::series()) {
QBarModelMapper::setSeries(series);
emit seriesReplaced();
}
}
Marek Rosa
Replaced 'Bar' with 'BarSet' in BarModelMapper functions and member variables
r1312 int QHBarModelMapper::firstBarSetRow() const
Marek Rosa
Added Vertical and Horizontal BarModelMappers
r1294 {
Marek Rosa
Replaced 'Bar' with 'BarSet' in BarModelMapper functions and member variables
r1312 return QBarModelMapper::firstBarSetSection();
Marek Rosa
Added Vertical and Horizontal BarModelMappers
r1294 }
Marek Rosa
Replaced 'Bar' with 'BarSet' in BarModelMapper functions and member variables
r1312 void QHBarModelMapper::setFirstBarSetRow(int firstBarSetRow)
Marek Rosa
Added Vertical and Horizontal BarModelMappers
r1294 {
Marek Rosa
Added NOTIFY to BarModelMapper properties
r1478 if (firstBarSetRow != firstBarSetSection()) {
Marek Rosa
BarModel mapper properties first, count moved to Vertical and Horizontal mappers with more descriptive names
r1495 QBarModelMapper::setFirstBarSetSection(firstBarSetRow);
Marek Rosa
Added NOTIFY to BarModelMapper properties
r1478 emit firstBarSetRowChanged();
}
Marek Rosa
Added Vertical and Horizontal BarModelMappers
r1294 }
Marek Rosa
Replaced 'Bar' with 'BarSet' in BarModelMapper functions and member variables
r1312 int QHBarModelMapper::lastBarSetRow() const
Marek Rosa
Added Vertical and Horizontal BarModelMappers
r1294 {
Marek Rosa
Replaced 'Bar' with 'BarSet' in BarModelMapper functions and member variables
r1312 return QBarModelMapper::lastBarSetSection();
Marek Rosa
Added Vertical and Horizontal BarModelMappers
r1294 }
Marek Rosa
Replaced 'Bar' with 'BarSet' in BarModelMapper functions and member variables
r1312 void QHBarModelMapper::setLastBarSetRow(int lastBarSetRow)
Marek Rosa
Added Vertical and Horizontal BarModelMappers
r1294 {
Marek Rosa
Added NOTIFY to BarModelMapper properties
r1478 if (lastBarSetRow != lastBarSetSection()) {
Marek Rosa
BarModel mapper properties first, count moved to Vertical and Horizontal mappers with more descriptive names
r1495 QBarModelMapper::setLastBarSetSection(lastBarSetRow);
Marek Rosa
Added NOTIFY to BarModelMapper properties
r1478 emit lastBarSetRowChanged();
}
Marek Rosa
Added Vertical and Horizontal BarModelMappers
r1294 }
Marek Rosa
BarModel mapper properties first, count moved to Vertical and Horizontal mappers with more descriptive names
r1495 int QHBarModelMapper::firstColumn() const
{
return QBarModelMapper::first();
}
void QHBarModelMapper::setFirstColumn(int firstColumn)
{
if (firstColumn != first()) {
QBarModelMapper::setFirst(firstColumn);
emit firstColumnChanged();
}
}
int QHBarModelMapper::columnCount() const
{
return QBarModelMapper::count();
}
void QHBarModelMapper::setColumnCount(int columnCount)
{
if (columnCount != count()) {
QBarModelMapper::setCount(columnCount);
emit firstColumnChanged();
}
}
Marek Rosa
Added Vertical and Horizontal BarModelMappers
r1294 #include "moc_qhbarmodelmapper.cpp"
QTCOMMERCIALCHART_END_NAMESPACE