X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=src%2Fquick%2Fdoc%2Fsrc%2Fconcepts%2Finput%2Ftopic.qdoc;h=5079e0678a1e5230dd8ee5da35784695ec1a787d;hb=87679b3499e68957998b98bf13b6d98b3aa8b4c3;hp=94c29e120e6162e474e96fb6016e46a706a47849;hpb=422033971f5d74b8ed7dcf3492379403d4d0eb3d;p=profile%2Fivi%2Fqtdeclarative.git diff --git a/src/quick/doc/src/concepts/input/topic.qdoc b/src/quick/doc/src/concepts/input/topic.qdoc index 94c29e1..5079e06 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. + */