More example docs

MouseArea, Threading and TouchInteraction

Change-Id: I9ca812d20a6c87d68ef91066ae0a4b9bc8829478
Reviewed-by: Michael Brasser <michael.brasser@nokia.com>

5 files changed, 25 insertions, 4 deletions

diff --git a/examples/quick/touchinteraction/flickable/basic-flickable.qml b/examples/quick/touchinteraction/flickable/basic-flickable.qml
index 58650d7334..dd64be4910 100644
--- a/examples/quick/touchinteraction/flickable/basic-flickable.qml
+++ b/examples/quick/touchinteraction/flickable/basic-flickable.qml
@@ -40,6 +40,7 @@
 
 import QtQuick 2.0
 
+    //![0]
 Rectangle {
     width: 320
     height: 480
@@ -50,6 +51,7 @@ Rectangle {
         Rectangle {
             width: 1000
             height: 1000
+    //![0]
             x: 100
             y: 100
             radius: 128
diff --git a/examples/quick/touchinteraction/multipointtouch/content/AugmentedTouchPoint.qml b/examples/quick/touchinteraction/multipointtouch/content/AugmentedTouchPoint.qml
index aede1a8f4e..74da7f1f37 100644
--- a/examples/quick/touchinteraction/multipointtouch/content/AugmentedTouchPoint.qml
+++ b/examples/quick/touchinteraction/multipointtouch/content/AugmentedTouchPoint.qml
@@ -40,6 +40,7 @@
 import QtQuick 2.0
 import QtQuick.Particles 2.0
 
+//! [0]
 TouchPoint {
     id: container
     property ParticleSystem system
@@ -68,3 +69,4 @@ TouchPoint {
         goalState: "falling"
     }
 }
+//! [0]
diff --git a/examples/quick/touchinteraction/multipointtouch/multiflame.qml b/examples/quick/touchinteraction/multipointtouch/multiflame.qml
index 72a0ce21f8..90640baaa4 100644
--- a/examples/quick/touchinteraction/multipointtouch/multiflame.qml
+++ b/examples/quick/touchinteraction/multipointtouch/multiflame.qml
@@ -45,6 +45,7 @@ Rectangle {
     height: 480
     color: "black"
 
+//! [0]
     MultiPointTouchArea {
         anchors.fill: parent
         minimumTouchPoints: 1
@@ -57,13 +58,16 @@ Rectangle {
             TouchPoint { id: touch31 }
         ]
     }
+//! [0]
 
+//! [1]
     ParticleFlame {
         color: "red"
         x: touch1.x
         y: touch1.y
         emitting: touch1.pressed
     }
+//! [1]
     ParticleFlame {
         color: "green"
         x: touch2.x
diff --git a/examples/quick/touchinteraction/pincharea/flickresize.qml b/examples/quick/touchinteraction/pincharea/flickresize.qml
index 037766e4a0..f5fb77c7ee 100644
--- a/examples/quick/touchinteraction/pincharea/flickresize.qml
+++ b/examples/quick/touchinteraction/pincharea/flickresize.qml
@@ -57,6 +57,7 @@ Rectangle {
 
             property real initialWidth
             property real initialHeight
+            //![0]
             onPinchStarted: {
                 initialWidth = flick.contentWidth
                 initialHeight = flick.contentHeight
@@ -75,6 +76,7 @@ Rectangle {
                 // Move its content within bounds.
                 flick.returnToBounds()
             }
+            //![0]
 
             Rectangle {
                 width: flick.contentWidth
diff --git a/examples/quick/touchinteraction/touchinteraction.qml b/examples/quick/touchinteraction/touchinteraction.qml
index e64c145714..c8285438ef 100644
--- a/examples/quick/touchinteraction/touchinteraction.qml
+++ b/examples/quick/touchinteraction/touchinteraction.qml
@@ -49,15 +49,26 @@ import "../../shared"
 
     This is a collection of small QML examples relating to touch interaction methods.
 
-    Multipoint Flames demonstrates distinguishing different fingers in a MultiPointTouchArea, by assignning a different colored flame to each touch point.
+    Multipoint Flames demonstrates distinguishing different fingers in a MultiPointTouchArea, by assigning a different colored flame to each touch point.
+    The MultipointTouchArea sets up multiple touch points:
+    \snippet examples/quick/touchinteraction/multipointtouch/multiflame.qml 0
+    The flames are then simply bound to the coordiates of the touch point, and whether it is currently pressed, like so:
+    \snippet examples/quick/touchinteraction/multipointtouch/multiflame.qml 1
 
-    Bear-Whack demonstrates using a MultiPointTouchArea to add multiple finger support to a simple game.
+    Bear-Whack demonstrates using a MultiPointTouchArea to add multiple finger support to a simple game. The interaction with the game
+    is done through a SpriteGoal that follows the TouchPoint. The TouchPoints added to the MultiPointTouchArea are a component with all
+    this logic embedded into it:
+    \snippet examples/quick/touchinteraction/multipointtouch/bearwhack/content/AugmentedTouchPoint.qml 0
 
-    Flick Resize uses a PinchArea to allow Pinch-to-Resize behavior.
+    Flick Resize uses a PinchArea to allow Pinch-to-Resize behavior. This is easily achieved just by listening to the PinchArea signals and responding
+    to user input.
+    \snippet examples/quick/touchinteraction/pincharea/flickresize.qml 0
 
-    Flickable is a simple example demonstrating the Flickable element.
+    Flickable is a simple example demonstrating the Flickable element. The element inside the flickable is very big, but the flickable itself is very small:
+    \snippet examples/quick/touchinteraction/flickable/basic-flickable.qml 0
 
     Corkboards shows a more complex Flickable usecase, with elements on the flickable that respond to mouse and keyboard interaction.
+    This doesn't require special code, the QtQuick elements automatically cooperate with Flickable for accepting the touch events.
 */
 
 Item {