##// END OF EJS Templates
HG_REPOSITORIES » LPP » INSTRUMENTATION » USERS » JEANDET » qtcharts
RSS

Clone from http://code.qt.io/qt/qtcharts.git

QML bar model mapper documentation
QML bar model mapper documentation
Tero Ahola - - Load All Authors

File last commit:

r1497:c1097d2a6ae8
r1497:c1097d2a6ae8
Show More
qvbarmodelmapper.cpp
197 lines | 6.2 KiB | text/x-c | CppLexer
/ src / barchart / qvbarmodelmapper.cpp
History | Source | Raw |Copy content |Copy permalink
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 "qvbarmodelmapper.h"
QTCOMMERCIALCHART_BEGIN_NAMESPACE
Marek Rosa
Added placeholders for mappers documentation
 r1331 /*!
\class QVBarModelMapper
\brief part of QtCommercial chart API.
\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 Vertical 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 /*!
\qmlclass VBarModelMapper
\mainclass
VBarModelMapper allows you to use your own QAbstractItemModel derived model with data in columns as a data source
Tero Ahola
QML bar model mapper documentation
 r1497 for any bar series. Adding/removing value from the BarSet causes the the same change in the rest of the BarSets
added to the same series. The following QML example would create a bar series with three bar sets (assuming the
model has at least four columns). Each bar set would contain data starting from row 1. The name of a set would be
defined by the horizontal header (of the column).
Tero Ahola
Documenting QML bar model mappers
 r1492 \code
GroupedBarSeries {
VBarModelMapper {
Tero Ahola
QML bar model mapper documentation
 r1497 model: myCustomModel // QAbstractItemModel derived implementation
Tero Ahola
Documenting QML bar model mappers
 r1492 firstBarSetColumn: 1
lastBarSetColumn: 3
Tero Ahola
Updated QML bar model mapper property names
 r1496 firstRow: 1
Tero Ahola
Documenting QML bar model mappers
 r1492 }
}
\endcode
*/
Marek Rosa
Added placeholders for mappers documentation
 r1331
Tero Ahola
QML bar model mapper documentation
 r1497 /*!
\qmlproperty BarSeries VBarModelMapper::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).
*/
/*!
\qmlproperty Model VBarModelMapper::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.
*/
Marek Rosa
Added documentation for BarModelMapper classes
 r1348 /*!
\property QVBarModelMapper::firstBarSetColumn
\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
Documenting QML bar model mappers
 r1492 /*!
\qmlproperty int VBarModelMapper::firstBarSetColumn
Defines which column of the model is used as the data source for the first bar set. Default value
is: -1 (invalid mapping).
*/
Marek Rosa
Added documentation for BarModelMapper classes
 r1348
/*!
\property QVBarModelMapper::lastBarSetColumn
\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
Documenting QML bar model mappers
 r1492 /*!
\qmlproperty int VBarModelMapper::lastBarSetColumn
Defines which column of the model is used as the data source for the last bar set. 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 QVBarModelMapper::firstRow
\brief Defines which row 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 VBarModelMapper::firstRow
Marek Rosa
BarModel mapper properties first, count moved to Vertical and Horizontal mappers with more descriptive names
 r1495 Defines which row of the model contains the first values of the QBarSets in the series.
The default value is 0.
*/
/*!
\property QVBarModelMapper::rowCount
\brief Defines the number of rows of the model that are mapped as the data for QBarSeries
Minimal and default value is: -1 (count limited by the number of rows in the model)
*/
/*!
Tero Ahola
QML bar model mapper documentation
 r1497 \qmlproperty int VBarModelMapper::rowCount
Marek Rosa
BarModel mapper properties first, count moved to Vertical and Horizontal mappers with more descriptive names
 r1495 Defines the number of rows of the model that are mapped as the data for QBarSeries. The default value is
-1 (count limited by the number of rows in the model)
*/
Marek Rosa
Added NOTIFY to BarModelMapper properties
 r1478 /*!
\fn void QVBarModelMapper::firstBarSetColumnChanged()
Emitted when the firstBarSetColumn has changed.
*/
/*!
\fn void QVBarModelMapper::lastBarSetColumnChanged()
Emitted when the lastBarSetColumn has changed.
*/
Marek Rosa
BarModel mapper properties first, count moved to Vertical and Horizontal mappers with more descriptive names
 r1495 /*!
\fn void QVBarModelMapper::firstRowChanged()
Emitted when the firstRow has changed.
*/
/*!
\fn void QVBarModelMapper::rowCountChanged()
Emitted when the rowCount 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 QVBarModelMapper::QVBarModelMapper(QObject *parent) :
QBarModelMapper(parent)
{
Marek Rosa
Minor fix to barModelMapper
 r1311 QBarModelMapper::setOrientation(Qt::Vertical);
Marek Rosa
Added Vertical and Horizontal BarModelMappers
 r1294 }
Marek Rosa
Replaced 'Bar' with 'BarSet' in BarModelMapper functions and member variables
 r1312 int QVBarModelMapper::firstBarSetColumn() 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 QVBarModelMapper::setFirstBarSetColumn(int firstBarSetColumn)
Marek Rosa
Added Vertical and Horizontal BarModelMappers
 r1294 {
Marek Rosa
Added NOTIFY to BarModelMapper properties
 r1478 if (firstBarSetColumn != firstBarSetSection()) {
Marek Rosa
BarModel mapper properties first, count moved to Vertical and Horizontal mappers with more descriptive names
 r1495 QBarModelMapper::setFirstBarSetSection(firstBarSetColumn);
Marek Rosa
Added NOTIFY to BarModelMapper properties
 r1478 emit firstBarSetColumnChanged();
}
Marek Rosa
Added Vertical and Horizontal BarModelMappers
 r1294 }
Marek Rosa
Replaced 'Bar' with 'BarSet' in BarModelMapper functions and member variables
 r1312 int QVBarModelMapper::lastBarSetColumn() 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 QVBarModelMapper::setLastBarSetColumn(int lastBarSetColumn)
Marek Rosa
Added Vertical and Horizontal BarModelMappers
 r1294 {
Marek Rosa
Added NOTIFY to BarModelMapper properties
 r1478 if (lastBarSetColumn != lastBarSetSection()) {
Marek Rosa
BarModel mapper properties first, count moved to Vertical and Horizontal mappers with more descriptive names
 r1495 QBarModelMapper::setLastBarSetSection(lastBarSetColumn);
Marek Rosa
Added NOTIFY to BarModelMapper properties
 r1478 emit lastBarSetColumnChanged();
}
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 QVBarModelMapper::firstRow() const
{
return QBarModelMapper::first();
}
void QVBarModelMapper::setFirstRow(int firstRow)
{
if (firstRow != first()) {
QBarModelMapper::setFirst(firstRow);
emit firstRowChanged();
}
}
int QVBarModelMapper::rowCount() const
{
return QBarModelMapper::count();
}
void QVBarModelMapper::setRowCount(int rowCount)
{
if (rowCount != count()) {
QBarModelMapper::setCount(rowCount);
emit firstRowChanged();
}
}
Marek Rosa
Added Vertical and Horizontal BarModelMappers
 r1294 #include "moc_qvbarmodelmapper.cpp"
QTCOMMERCIALCHART_END_NAMESPACE