diff options
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. + */ |