##// END OF EJS Templates
QML bar model mapper documentation
Tero Ahola -
r1497:c1097d2a6ae8
parent child
Show More
@@ -39,12 +39,6 QTCOMMERCIALCHART_BEGIN_NAMESPACE
39 39 Adding/removing value from the BarSet causes the the same change in the rest of the BarSets added to the same series.
40 40 NOTE: used model has to support adding/removing rows/columns and modifying the data of the cells.
41 41 */
42 /*!
43 \qmlclass BarModelMapper
44 Cannot be created by the user. Base for HBarModelMapper and VBarModelMapper. Model mappers allow you to use
45 QAbstractItemModel derived models as a data source for a chart series. Adding/removing value from the BarSet causes
46 the the same change in the rest of the BarSets added to the same series.
47 */
48 42
49 43 /*!
50 44 \property QBarModelMapper::series
@@ -52,23 +46,11 QTCOMMERCIALCHART_BEGIN_NAMESPACE
52 46 All the data in the series is discarded when it is set to the mapper.
53 47 When new series is specified the old series is disconnected (it preserves its data)
54 48 */
55 /*!
56 \qmlproperty BarSeries BarModelMapper::series
57 Defines the BarSeries based object that is used by the mapper. All the data in the series is
58 discarded when it is set to the mapper. When new series is specified the old series is
59 disconnected (it preserves its data).
60 */
61 49
62 50 /*!
63 51 \property QBarModelMapper::model
64 52 \brief Defines the model that is used by the mapper.
65 53 */
66 /*!
67 \qmlproperty Model BarModelMapper::model
68 The QAbstractItemModel based model that is used by the mapper. You need to implement the model and expose it to
69 QML as shown in \l {QML Custom Model} demo application. NOTE: the model has to support adding/removing rows/columns
70 and modifying the data of the cells.
71 */
72 54
73 55 /*!
74 56 \fn void QBarModelMapper::seriesReplaced()
@@ -34,18 +34,18 QTCOMMERCIALCHART_BEGIN_NAMESPACE
34 34 NOTE: used model has to support adding/removing rows/columns and modifying the data of the cells.
35 35 */
36 36 /*!
37 \qmlclass HBarModelMapper
38 \inherits BarModelMapper
37 \qmlclass HBarModelMapper QHBarModelMapper
39 38 \mainclass
40 39
41 40 HBarModelMapper allows you to use your own QAbstractItemModel derived model with data in rows as a data source
42 for any bar series. The following QML example would create a bar series with three bar sets (assuming the model has
43 at least four rows). Each bar set would contain data starting from column 1. The name of a set would be defined
44 by the vertical header (of the row).
41 for any bar series. Adding/removing value from the BarSet causes the the same change in the rest of the BarSets
42 added to the same series. The following QML example would create a bar series with three bar sets (assuming the
43 model has at least four rows). Each bar set would contain data starting from column 1. The name of a set would be
44 defined by the vertical header (of the row).
45 45 \code
46 46 BarSeries {
47 47 HBarModelMapper {
48 model: myCustomModel
48 model: myCustomModel // QAbstractItemModel derived implementation
49 49 firstBarSetRow: 1
50 50 lastBarSetRow: 3
51 51 firstColumn: 1
@@ -55,18 +55,39 QTCOMMERCIALCHART_BEGIN_NAMESPACE
55 55 */
56 56
57 57 /*!
58 \qmlproperty BarSeries HBarModelMapper::series
59 Defines the BarSeries based object that is used by the mapper. All the data in the series is discarded when it is
60 set to the mapper. When new series is specified the old series is disconnected (it preserves its data).
61 */
62
63 /*!
64 \qmlproperty Model HBarModelMapper::model
65 The QAbstractItemModel based model that is used by the mapper. You need to implement the model and expose it to
66 QML as shown in \l {QML Custom Model} demo application. NOTE: the model has to support adding/removing rows/columns
67 and modifying the data of the cells.
68 */
69
70 /*!
58 71 \property QHBarModelMapper::firstBarSetRow
59 72 \brief Defines which column of the model is used as the data source for the first bar set
60
61 73 Default value is: -1 (invalid mapping)
62 74 */
75 /*!
76 \qmlproperty int HBarModelMapper::firstBarSetRow
77 Defines which column of the model is used as the data source for the first bar set. The default value is -1
78 (invalid mapping).
79 */
63 80
64 81 /*!
65 82 \property QHBarModelMapper::lastBarSetRow
66 83 \brief Defines which column of the model is used as the data source for the last bar set
67
68 84 Default value is: -1 (invalid mapping)
69 85 */
86 /*!
87 \qmlproperty int HBarModelMapper::lastBarSetRow
88 Defines which column of the model is used as the data source for the last bar set. The default value is -1
89 (invalid mapping).
90 */
70 91
71 92 /*!
72 93 \property QHBarModelMapper::firstColumn
@@ -74,20 +95,20 QTCOMMERCIALCHART_BEGIN_NAMESPACE
74 95 Minimal and default value is: 0
75 96 */
76 97 /*!
77 \qmlproperty int BarModelMapper::firstColumn
98 \qmlproperty int HBarModelMapper::firstColumn
78 99 Defines which column of the model contains the first values of the QBarSets in the series.
79 100 The default value is 0.
80 101 */
81 102
82 103 /*!
83 104 \property QHBarModelMapper::columnCount
84 \brief Defines the number of rows of the model that are mapped as the data for QBarSeries
85 Minimal and default value is: -1 (count limited by the number of rows in the model)
105 \brief Defines the number of columns of the model that are mapped as the data for QBarSeries
106 Minimal and default value is: -1 (count limited by the number of columns in the model)
86 107 */
87 108 /*!
88 \qmlproperty int BarModelMapper::columnCount
89 Defines the number of rows of the model that are mapped as the data for QBarSeries. The default value is
90 -1 (count limited by the number of rows in the model)
109 \qmlproperty int HBarModelMapper::columnCount
110 Defines the number of columns of the model that are mapped as the data for QBarSeries. The default value is
111 -1 (count limited by the number of columns in the model)
91 112 */
92 113
93 114 /*!
@@ -35,17 +35,17 QTCOMMERCIALCHART_BEGIN_NAMESPACE
35 35 */
36 36 /*!
37 37 \qmlclass VBarModelMapper
38 \inherits BarModelMapper
39 38 \mainclass
40 39
41 40 VBarModelMapper allows you to use your own QAbstractItemModel derived model with data in columns as a data source
42 for any bar series. The following QML example would create a bar series with three bar sets (assuming the model has
43 at least four columns). Each bar set would contain data starting from row 1. The name of a set would be defined
44 by the horizontal header (of the column).
41 for any bar series. Adding/removing value from the BarSet causes the the same change in the rest of the BarSets
42 added to the same series. The following QML example would create a bar series with three bar sets (assuming the
43 model has at least four columns). Each bar set would contain data starting from row 1. The name of a set would be
44 defined by the horizontal header (of the column).
45 45 \code
46 46 GroupedBarSeries {
47 47 VBarModelMapper {
48 model: myCustomModel
48 model: myCustomModel // QAbstractItemModel derived implementation
49 49 firstBarSetColumn: 1
50 50 lastBarSetColumn: 3
51 51 firstRow: 1
@@ -55,6 +55,19 QTCOMMERCIALCHART_BEGIN_NAMESPACE
55 55 */
56 56
57 57 /*!
58 \qmlproperty BarSeries VBarModelMapper::series
59 Defines the BarSeries based object that is used by the mapper. All the data in the series is discarded when it is
60 set to the mapper. When new series is specified the old series is disconnected (it preserves its data).
61 */
62
63 /*!
64 \qmlproperty Model VBarModelMapper::model
65 The QAbstractItemModel based model that is used by the mapper. You need to implement the model and expose it to
66 QML as shown in \l {QML Custom Model} demo application. NOTE: the model has to support adding/removing rows/columns
67 and modifying the data of the cells.
68 */
69
70 /*!
58 71 \property QVBarModelMapper::firstBarSetColumn
59 72 \brief Defines which column of the model is used as the data source for the first bar set
60 73 Default value is: -1 (invalid mapping)
@@ -82,7 +95,7 QTCOMMERCIALCHART_BEGIN_NAMESPACE
82 95 Minimal and default value is: 0
83 96 */
84 97 /*!
85 \qmlproperty int BarModelMapper::firstRow
98 \qmlproperty int VBarModelMapper::firstRow
86 99 Defines which row of the model contains the first values of the QBarSets in the series.
87 100 The default value is 0.
88 101 */
@@ -93,7 +106,7 QTCOMMERCIALCHART_BEGIN_NAMESPACE
93 106 Minimal and default value is: -1 (count limited by the number of rows in the model)
94 107 */
95 108 /*!
96 \qmlproperty int BarModelMapper::rowCount
109 \qmlproperty int VBarModelMapper::rowCount
97 110 Defines the number of rows of the model that are mapped as the data for QBarSeries. The default value is
98 111 -1 (count limited by the number of rows in the model)
99 112 */
General Comments 0
You need to be logged in to leave comments. Login now