diff options
Diffstat (limited to 'doc/src/qtquick2/focus.qdoc')
| -rw-r--r-- | doc/src/qtquick2/focus.qdoc | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/doc/src/qtquick2/focus.qdoc b/doc/src/qtquick2/focus.qdoc index e2c4c79d3c..3528169995 100644 --- a/doc/src/qtquick2/focus.qdoc +++ b/doc/src/qtquick2/focus.qdoc @@ -34,7 +34,7 @@ When a key is pressed or released, a key event is generated and delivered to the focused QML \l Item. To facilitate the construction of reusable components and to address some of the cases unique to fluid user interfaces, the QML items add aged -\i scope based extension to Qt's traditional keyboard focus model. +\e scope based extension to Qt's traditional keyboard focus model. \tableofcontents @@ -42,13 +42,13 @@ and to address some of the cases unique to fluid user interfaces, the QML items When the user presses or releases a key, the following occurs: \list 1 -\o Qt receives the key action and generates a key event. -\o If the Qt widget containing the \l QQuickView has focus, the key event +\li Qt receives the key action and generates a key event. +\li If the Qt widget containing the \l QQuickView has focus, the key event is delivered to it. Otherwise, regular Qt key handling continues. -\o The key event is delivered by the scene to the QML \l Item with -\i {active focus}. If no Item has active focus, the key event is +\li The key event is delivered by the scene to the QML \l Item with +\e {active focus}. If no Item has active focus, the key event is \l {QEvent::ignore()}{ignored} and regular Qt key handling continues. -\o If the QML Item with active focus accepts the key event, propagation +\li If the QML Item with active focus accepts the key event, propagation stops. Otherwise the event is "bubbled up", by recursively passing it to each Item's parent until either the event is accepted, or the root Item is reached. @@ -59,7 +59,7 @@ item and thus subsequently be ignored. \snippet doc/src/snippets/qml/focus/rectangle.qml simple key event \snippet doc/src/snippets/qml/focus/rectangle.qml simple key event end -\o If the root \l Item is reached, the key event is \l {QEvent::ignore()}{ignored} and regular Qt key handling continues. +\li If the root \l Item is reached, the key event is \l {QEvent::ignore()}{ignored} and regular Qt key handling continues. \endlist @@ -119,7 +119,7 @@ the focus, but it cannot control the focus when it is imported or reused. Likewise, the \c window component does not have the ability to know if its imported components are requesting the focus. -To solve this problem, the QML introduces a concept known as a \i {focus scope}. +To solve this problem, the QML introduces a concept known as a \e {focus scope}. For existing Qt users, a focus scope is like an automatic focus proxy. A focus scope is created by declaring the \l FocusScope element. @@ -131,13 +131,13 @@ visual result shown. \image declarative-qmlfocus3.png -Conceptually \i {focus scopes} are quite simple. +Conceptually \e {focus scopes} are quite simple. \list -\o Within each focus scope one element may have \c {Item::focus} set to +\li Within each focus scope one element may have \c {Item::focus} set to \c true. If more than one \l Item has the \c focus property set, the last element to set the \c focus will have the focus and the others are unset, similar to when there are no focus scopes. -\o When a focus scope receives active focus, the contained element with +\li When a focus scope receives active focus, the contained element with \c focus set (if any) also gets the active focus. If this element is also a \l FocusScope, the proxying behavior continues. Both the focus scope and the sub-focused item will have \c activeFocus property set. |