Supports key navigation by arrow keys. 更多...
导入语句: | import QtQuick 2.2 |
Key-based user interfaces commonly allow the use of arrow keys to navigate between focusable items. The KeyNavigation attached property enables this behavior by providing a convenient way to specify the item that should gain focus when an arrow or tab key is pressed.
The following example provides key navigation for a 2x2 grid of items:
import QtQuick 2.0 Grid { width: 100; height: 100 columns: 2 Rectangle { id: topLeft width: 50; height: 50 color: focus ? "red" : "lightgray" focus: true KeyNavigation.right: topRight KeyNavigation.down: bottomLeft } Rectangle { id: topRight width: 50; height: 50 color: focus ? "red" : "lightgray" KeyNavigation.left: topLeft KeyNavigation.down: bottomRight } Rectangle { id: bottomLeft width: 50; height: 50 color: focus ? "red" : "lightgray" KeyNavigation.right: bottomRight KeyNavigation.up: topLeft } Rectangle { id: bottomRight width: 50; height: 50 color: focus ? "red" : "lightgray" KeyNavigation.left: bottomLeft KeyNavigation.up: topRight } }
The top-left item initially receives focus by setting
focus
to
true
. When an arrow key is pressed, the focus will move to the appropriate item, as defined by the value that has been set for the KeyNavigation
left
,
right
,
up
or
down
特性。
Note that if a KeyNavigation attached property receives the key press and release events for a requested arrow or tab key, the event is accepted and does not propagate any further.
By default, KeyNavigation receives key events after the item to which it is attached. If the item accepts the key event, the KeyNavigation attached property will not receive an event for that key. Setting the
priority
特性到
KeyNavigation.BeforeItem
allows the event to be used for key navigation before the item, rather than after.
If the item to which the focus is switching is not enabled or visible, an attempt will be made to skip this item and focus on the next. This is possible if there are a chain of items with the same KeyNavigation handler. If multiple items in a row are not enabled or visible, they will also be skipped.
KeyNavigation will implicitly set the other direction to return focus to this item. So if you set left to another item, right will be set on that item's KeyNavigation to set focus back to this item. However, if that item's KeyNavigation has had right explicitly set then no change will occur. This means that the example above could achieve the same behavior without specifying KeyNavigation.right or KeyNavigation.down for any of the items.
另请参阅 Keys attached property .
KeyNavigation.backtab : Item |
This property holds the item to assign focus to when the Shift+Tab key combination (Backtab) is pressed.
KeyNavigation.down : Item |
This property holds the item to assign focus to when the down cursor key is pressed.
KeyNavigation.left : Item |
This property holds the item to assign focus to when the left cursor key is pressed.
KeyNavigation.priority : enumeration |
This property determines whether the keys are processed before or after the attached item's own key handling.
KeyNavigation.right : Item |
This property holds the item to assign focus to when the right cursor key is pressed.
KeyNavigation.tab : Item |
This property holds the item to assign focus to when the Tab key is pressed.
KeyNavigation.up : Item |
This property holds the item to assign focus to when the up cursor key is pressed.