diff options
| author | Jens Bache-Wiig <jens.bache-wiig@digia.com> | 2014-03-28 16:21:43 +0100 |
|---|---|---|
| committer | The Qt Project <gerrit-noreply@qt-project.org> | 2014-03-28 16:57:34 +0100 |
| commit | 05b3fc4d583f886afe2f9e698a6224da46646e47 (patch) | |
| tree | cdd1767dcc9209ec78d5db45bb981b56a2949002 | |
| parent | cff094ae801425a7da43f80af15c7ead8c4afcac (diff) | |
| download | qtquickcontrols-05b3fc4d583f886afe2f9e698a6224da46646e47.tar.gz | |
Add a note on recycling of delegates for TableView
Since this is a new feature in 5.3, we should clearly document
the implication this will have on delegates.
Change-Id: I2255e9306bbac503c38d79586b4cac4eb5c8ba1e
Reviewed-by: J-P Nurmi <jpnurmi@digia.com>
| -rw-r--r-- | src/controls/TableView.qml | 17 |
1 files changed, 16 insertions, 1 deletions
diff --git a/src/controls/TableView.qml b/src/controls/TableView.qml index 3eb73cf6..8006c443 100644 --- a/src/controls/TableView.qml +++ b/src/controls/TableView.qml @@ -160,7 +160,15 @@ ScrollView { text: styleData.value } } - \endcode */ + \endcode + + \note For performance reasons, created delegates can be recycled + across multiple table rows. This implies that when you make use of implicit + properties such as \c styledata.row or \c model, these values can change also + after the delegate has been constructed. In practice this means you should not assume + that content is fixed when \c Component.onCompleted happens, but instead rely on + bindings to such properties. + */ property Component itemDelegate: __style ? __style.itemDelegate : null /*! This property defines a delegate to draw a row. @@ -171,6 +179,13 @@ ScrollView { \li styleData.selected - true when the row is currently selected \li styleData.row - the index of the row \endlist + + \note For performance reasons, created delegates can be recycled + across multiple table rows. This implies that when you make use of implicit + properties such as \c styledata.row or \c model, these values can change also + after the delegate has been constructed. In practice this means you should not assume + that content is fixed when \c Component.onCompleted happens, but instead rely on + bindings to such properties. */ property Component rowDelegate: __style ? __style.rowDelegate : null |