diff options
author | Paul Wicking <paul.wicking@qt.io> | 2023-01-05 10:44:44 +0100 |
---|---|---|
committer | Paul Wicking <paul.wicking@qt.io> | 2023-03-01 17:05:13 +0100 |
commit | 7273a0eacc235c5b28394c064cdfc3fa72f0ef5a (patch) | |
tree | f9262bf652b76647e60e3ffa7058fdcbdbe6d6c4 /src/widgets/doc/src/widgets-and-layouts | |
parent | 25d15948f8801d71d446353f6e97f6086bcecb74 (diff) |
Doc: rewrite shortcut focus section
As pointed out in review, somewhat contradictory advise.
Rewrite the section to be more active, focus on the user and
their application, and a bit more consistent.
Pick-to: 6.5
Change-Id: Idbbf29d3033d32ade553290a2e89bd778876224c
Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io>
Diffstat (limited to 'src/widgets/doc/src/widgets-and-layouts')
-rw-r--r-- | src/widgets/doc/src/widgets-and-layouts/focus.qdoc | 13 |
1 files changed, 9 insertions, 4 deletions
diff --git a/src/widgets/doc/src/widgets-and-layouts/focus.qdoc b/src/widgets/doc/src/widgets-and-layouts/focus.qdoc index 6b4d119663..6cd8e58543 100644 --- a/src/widgets/doc/src/widgets-and-layouts/focus.qdoc +++ b/src/widgets/doc/src/widgets-and-layouts/focus.qdoc @@ -126,12 +126,17 @@ explicitly using focus accelerators such as those provided by QLabel::setBuddy(), QGroupBox, and QTabBar. - We advise supporting shortcut focus for all widgets that the user + Your application can support shortcut focus for all widgets that the user may want to jump to. For example, a tab dialog can have keyboard shortcuts for each of its pages, so the user can press e.g. \uicontrol - Alt+P to step to the \underline{P}rinting page. It is easy to - overdo this: there are only a few keys, and it's also important - to provide keyboard shortcuts for commands. + Alt+P to step to the \underline{P}rinting page. Keep in mind that it's easy + to overdo this, as there are only a few keys, and also important to provide + keyboard shortcuts for commands. Refer to the design guidelines for the + platform you target, for example Microsoft's \l + {https://learn.microsoft.com/en-us/previous-versions/windows/desktop/dnacc/guidelines-for-keyboard-user-interface-design} + {guidelines for keyboard user interface design} or Apple's \l + {https://developer.apple.com/design/human-interface-guidelines/inputs/focus-and-selection/} + {focus and selection} guidelines. \section2 The User Rotates the Mouse Wheel |