diff options
author | Bea Lam <bea.lam@nokia.com> | 2012-08-28 11:21:19 +1000 |
---|---|---|
committer | Qt by Nokia <qt-info@nokia.com> | 2012-08-28 06:21:58 +0200 |
commit | 87679b3499e68957998b98bf13b6d98b3aa8b4c3 (patch) | |
tree | 4e6d613173a1e6abf5ef0afc65a615fd6b7fdbfe /src/quick/doc/src/concepts/input/topic.qdoc | |
parent | abaee0a83588f86740ea553ff7623a789b6b787a (diff) |
Docs - add missing images and code, clean up sections
Includes the removal of concepts/modelviewsdata/localstorage.qdoc
since that is a duplicate of the existing Local Storage module docs.
Also removes classes from whatsnew.qdoc that are internal.
Change-Id: I4170c1797bbec09bb67784b0b2ad67fd990365a8
Reviewed-by: Andrew den Exter <andrew.den-exter@nokia.com>
Diffstat (limited to 'src/quick/doc/src/concepts/input/topic.qdoc')
-rw-r--r-- | src/quick/doc/src/concepts/input/topic.qdoc | 58 |
1 files changed, 28 insertions, 30 deletions
diff --git a/src/quick/doc/src/concepts/input/topic.qdoc b/src/quick/doc/src/concepts/input/topic.qdoc index 94c29e120e..5079e0678a 100644 --- a/src/quick/doc/src/concepts/input/topic.qdoc +++ b/src/quick/doc/src/concepts/input/topic.qdoc @@ -47,34 +47,11 @@ and thus touch events are supported in various visual object types, from in the \l{MouseArea} type (which will be documented thoroughly in a proceeding section). -\section1 Motion Gestures - -Detecting gestures with an accelerometer, or through camera-based gesture -recognition, can allow users to interact with an application without requiring -their full and undevided attention. It can also provide a more interactive -and engaging experience. - -Qt Quick itself does not offer first-class support for motion gestures, however -another QML add-on module which provides support for gestures, which uses -Qt Quick and integrates with Qt Quick's visual canvas does exist. See the -Qt Sensors module documentation for more information on the topic. - -\section1 Keyboard - -Supporting input from a keyboard is a vital component of the user-interface of -many applications. - -XXX TODO: generic keypress event handling documentation? - -Qt Quick also provides visual object types which automatically receive keyboard -events and key-presses, and displays the appropriate text. Please see the -documentation about \l{qtquick-input-textinput.html}{text input} for -in-depth information on the topic. \section1 Mouse -The computer mouse is still a very important vector for user-input. Detecting -and reacting to clicks and presses according to their position is a fundamental +Mouse input is another important user input for user interfaces. Detecting +and reacting to clicks and presses according to the mouse cursor position is a fundamental concept in user-interface design. Qt Quick provides the MouseArea visual object type which automatically receives @@ -83,13 +60,34 @@ create custom user-interface objects to handle mouse input. Please see the documentation about \l{qtquick-input-mouseevents.html} {mouse events in Qt Quick} for more information on the topic. -\section1 Focus -Most user-interfaces have multiple visual objects, but usually only one object -has focus (that is, receives key-press events) at any time. Qt Quick has -support for complex focus specification. See the documentation about -\l{qtquick-input-focus.html}{keyboard focus in Qt Quick} for more +\section1 Keyboard Input and Keyboard Focus + +Supporting input from a keyboard is a vital component of the user interface of +many applications. + +Any visual item can receive keyboard input through the \l Keys attached type. +Additionally, the issue of \e {keyboard focus} arises when multiple items +are required to receive key events, as these events must be passed to the +correct item. See the documentation about \l{Keyboard focus in Qt Quick} for more information on this topic. +Qt Quick also provides visual text items which automatically receive keyboard +events and key-presses, and displays the appropriate text. See the +documentation about \l{qtquick-input-textinput.html}{text input} for +in-depth information on the topic. + + +\section1 Device Motion Gestures + +Detecting device gestures with an accelerometer, or through camera-based gesture +recognition, can allow users to interact with an application without requiring +their full and undevided attention. It can also provide a more interactive +and engaging experience. + +Qt Quick itself does not offer first-class support for physical device motion gestures; +however, the \l{Qt Sensors} module provides QML types with support for such gestures. +See the \l{Qt Sensors} module documentation for more information on the topic. + */ |