From 1a1ce3775b937ee2ba952d4a7360a1626afdf7a5 Mon Sep 17 00:00:00 2001 From: Martin Jones Date: Wed, 27 Jul 2011 09:19:47 +1000 Subject: [PATCH] Document view touch interaction with their content. Fixes: QTBUG-18601 Change-Id: I9e793fa205d0eb2f2c312a9a73559720a4d4f00a Reviewed-on: http://codereview.qt.nokia.com/2223 Reviewed-by: Martin Jones --- doc/src/declarative/qmlviews.qdoc | 13 +++++++++++++ 1 files changed, 13 insertions(+), 0 deletions(-) diff --git a/doc/src/declarative/qmlviews.qdoc b/doc/src/declarative/qmlviews.qdoc index a4905be..e28c4ec 100644 --- a/doc/src/declarative/qmlviews.qdoc +++ b/doc/src/declarative/qmlviews.qdoc @@ -92,6 +92,19 @@ The club may decorate the members list by binding visual objects to the \snippet doc/src/snippets/declarative/listview-decorations.qml decorations \image listview-decorations.png +\section1 Mouse/touch Handling + +The views handle dragging and flicking of their content, however they do +not handle touch interaction with the individual delegates. In order for the +delegates to react to touch input, e.g. to set the \c currentIndex, a MouseArea +with the appropriate touch handling logic must be provided by the delegate. + +Note that if \c highlightRangeMode is set to \c StrictlyEnforceRange the +currentIndex will be affected by dragging/flicking the view, since the view +will always ensure that the \c currentIndex is within the highlight range +specified. + + \section1 ListView Sections \l {ListView} contents may be grouped into \e sections, where related list items -- 1.7.2.5