diff options
author | Tomasz Siekierda (sierdzio) <sierdzio@gmail.com> | 2013-08-04 12:12:26 +0200 |
---|---|---|
committer | The Qt Project <gerrit-noreply@qt-project.org> | 2013-08-10 10:46:53 +0200 |
commit | 55867c2f0016fc395f91a4df1c8ae32cbf2d11db (patch) | |
tree | d1db7fa9770b2a3b529f7a91e4cb99741278515d /src | |
parent | fc6afa7f7d567f32d167f04b659e7bf4f546f48d (diff) |
Document parenting behaviour of delegates in QML ListView and Component.
ListView:
As delegates are instantiated in ListView, they are parented to views
contentItem. This is now explicitly stated in the documentation.
Component:
Components are not derived from Items, so they cannot hook to anchors.
Task-number: QTBUG-24822
Change-Id: I09e04fbcc01b2858c039d22f9600ef201a9a91ab
Reviewed-by: Topi Reiniƶ <topi.reinio@digia.com>
Reviewed-by: Alan Alpert <aalpert@blackberry.com>
Reviewed-by: Jerome Pasion <jerome.pasion@digia.com>
Diffstat (limited to 'src')
-rw-r--r-- | src/qml/qml/qqmlcomponent.cpp | 3 | ||||
-rw-r--r-- | src/quick/items/qquicklistview.cpp | 2 |
2 files changed, 4 insertions, 1 deletions
diff --git a/src/qml/qml/qqmlcomponent.cpp b/src/qml/qml/qqmlcomponent.cpp index e59116a7c1..850ee53ab7 100644 --- a/src/qml/qml/qqmlcomponent.cpp +++ b/src/qml/qml/qqmlcomponent.cpp @@ -231,7 +231,8 @@ static inline QString buildTypeNameForDebug(const QMetaObject *metaObject) because it is defined inside a \c Component. The component encapsulates the QML types within, as if they were defined in a separate QML file, and is not loaded until requested (in this case, by the - two \l Loader objects). + two \l Loader objects). Because Component is not derived from Item, you cannot + anchor anything to it. Defining a \c Component is similar to defining a \l {QML Document}{QML document}. A QML document has a single top-level item that defines the behaviors and diff --git a/src/quick/items/qquicklistview.cpp b/src/quick/items/qquicklistview.cpp index d79f535fd4..558fbcd405 100644 --- a/src/quick/items/qquicklistview.cpp +++ b/src/quick/items/qquicklistview.cpp @@ -1690,6 +1690,7 @@ bool QQuickListViewPrivate::flick(AxisData &data, qreal minExtent, qreal maxExte The list view itself is a focus scope (see \l{Keyboard Focus in Qt Quick} for more details). Delegates are instantiated as needed and may be destroyed at any time. + They are parented to ListView's \l {Flickable::contentItem}{contentItem}, not to the view itself. State should \e never be stored in a delegate. ListView attaches a number of properties to the root item of the delegate, for example @@ -1862,6 +1863,7 @@ QQuickListView::~QQuickListView() alignment of items. \note Delegates are instantiated as needed and may be destroyed at any time. + They are parented to ListView's \l {Flickable::contentItem}{contentItem}, not to the view itself. State should \e never be stored in a delegate. */ /*! |