Remove "All rights reserved" line from license headers.

[profile/ivi/qtdeclarative.git] / doc / src / declarative / qmlviews.qdoc

diff --git a/doc/src/declarative/qmlviews.qdoc b/doc/src/declarative/qmlviews.qdoc
index a4905be..22de80c 100644 (file)
--- a/doc/src/declarative/qmlviews.qdoc
+++ b/doc/src/declarative/qmlviews.qdoc
@@ -1,8 +1,7 @@
 /****************************************************************************
 **
-** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
-** All rights reserved.
-** Contact: Nokia Corporation (qt-info@nokia.com)
+** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
+** Contact: http://www.qt-project.org/
 **
 ** This file is part of the documentation of the Qt Toolkit.
 **
@@ -21,12 +20,14 @@
 **
 **
 **
+**
 ** $QT_END_LICENSE$
 **
 ****************************************************************************/
 
 /*!
 \page qml-views.html
+\inqmlmodule QtQuick 2
 \ingroup qml-features
 \contentspage QML Features
 \previouspage {QML Data Models}{Structuring Data with Models}
@@ -66,7 +67,7 @@ For more information, consult the \l {QML Data Models} article.
 \keyword qml-view-delegate
 \section1 View Delegates
 
-Views need a \e delegate to visually represent an item in a list. A view will
+Views need a \i delegate to visually represent an item in a list. A view will
 visualize each item list according to the template defined by the delegate.
 Items in a model are accessible through the \c index property as well as the
 item's properties.
@@ -75,7 +76,7 @@ item's properties.
 
 \section1 Decorating Views
 
-Views allow visual customization through \e decoration properties such as the \c header, \c footer, and \c section properties. By binding an object, usually
+Views allow visual customization through \i decoration properties such as the \c header, \c footer, and \c section properties. By binding an object, usually
 another visual object, to these properties, the views are decoratable. A footer
 may include a \l Rectangle element showcasing borders or a header that displays
 a logo on top of the list.
@@ -92,9 +93,22 @@ 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
+\l {ListView} contents may be grouped into \i sections, where related list items
 are labeled according to their sections. Further, the sections may be decorated
 with \l{qml-view-delegate}{delegates}.