|
1 /**************************************************************************** |
|
2 ** |
|
3 ** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). |
|
4 ** All rights reserved. |
|
5 ** Contact: Nokia Corporation (qt-info@nokia.com) |
|
6 ** |
|
7 ** This file is part of the documentation of the Qt Toolkit. |
|
8 ** |
|
9 ** $QT_BEGIN_LICENSE:LGPL$ |
|
10 ** No Commercial Usage |
|
11 ** This file contains pre-release code and may not be distributed. |
|
12 ** You may use this file in accordance with the terms and conditions |
|
13 ** contained in the Technology Preview License Agreement accompanying |
|
14 ** this package. |
|
15 ** |
|
16 ** GNU Lesser General Public License Usage |
|
17 ** Alternatively, this file may be used under the terms of the GNU Lesser |
|
18 ** General Public License version 2.1 as published by the Free Software |
|
19 ** Foundation and appearing in the file LICENSE.LGPL included in the |
|
20 ** packaging of this file. Please review the following information to |
|
21 ** ensure the GNU Lesser General Public License version 2.1 requirements |
|
22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. |
|
23 ** |
|
24 ** In addition, as a special exception, Nokia gives you certain additional |
|
25 ** rights. These rights are described in the Nokia Qt LGPL Exception |
|
26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. |
|
27 ** |
|
28 ** If you have questions regarding the use of this file, please contact |
|
29 ** Nokia at qt-info@nokia.com. |
|
30 ** |
|
31 ** |
|
32 ** |
|
33 ** |
|
34 ** |
|
35 ** |
|
36 ** |
|
37 ** |
|
38 ** $QT_END_LICENSE$ |
|
39 ** |
|
40 ****************************************************************************/ |
|
41 |
|
42 /*! |
|
43 \page accelerators.html |
|
44 \title Standard Accelerator Keys |
|
45 |
|
46 \ingroup best-practices |
|
47 |
|
48 Applications invariably need to define accelerator keys for actions. |
|
49 Qt fully supports accelerators, for example with \l Q3Accel::shortcutKey(). |
|
50 |
|
51 Here are Microsoft's recommendations for accelerator keys, with |
|
52 comments about the Open Group's recommendations where they exist |
|
53 and differ. For most commands, the Open Group either has no advice or |
|
54 agrees with Microsoft. |
|
55 |
|
56 The emboldened letter plus Alt is Microsoft's recommended choice, and |
|
57 we recommend supporting it. For an Apply button, for example, we |
|
58 recommend QAbstractButton::setText(\link QWidget::tr() tr \endlink("&Apply")); |
|
59 |
|
60 If you have conflicting commands (e.g. About and Apply buttons in the |
|
61 same dialog), you must decide for yourself. |
|
62 |
|
63 \list |
|
64 \i \bold{\underline{A}}bout |
|
65 \i Always on \bold{\underline{T}}op |
|
66 \i \bold{\underline{A}}pply |
|
67 \i \bold{\underline{B}}ack |
|
68 \i \bold{\underline{B}}rowse |
|
69 \i \bold{\underline{C}}lose (CDE: Alt+F4; Alt+F4 is "close window" in Windows) |
|
70 \i \bold{\underline{C}}opy (CDE: Ctrl+C, Ctrl+Insert) |
|
71 \i \bold{\underline{C}}opy Here |
|
72 \i Create \bold{\underline{S}}hortcut |
|
73 \i Create \bold{\underline{S}}hortcut Here |
|
74 \i Cu\bold{\underline{t}} |
|
75 \i \bold{\underline{D}}elete |
|
76 \i \bold{\underline{E}}dit |
|
77 \i \bold{\underline{E}}xit (CDE: E\bold{\underline{x}}it) |
|
78 \i \bold{\underline{E}}xplore |
|
79 \i \bold{\underline{F}}ile |
|
80 \i \bold{\underline{F}}ind |
|
81 \i \bold{\underline{H}}elp |
|
82 \i Help \bold{\underline{T}}opics |
|
83 \i \bold{\underline{H}}ide |
|
84 \i \bold{\underline{I}}nsert |
|
85 \i Insert \bold{\underline{O}}bject |
|
86 \i \bold{\underline{L}}ink Here |
|
87 \i Ma\bold{\underline{x}}imize |
|
88 \i Mi\bold{\underline{n}}imize |
|
89 \i \bold{\underline{M}}ove |
|
90 \i \bold{\underline{M}}ove Here |
|
91 \i \bold{\underline{N}}ew |
|
92 \i \bold{\underline{N}}ext |
|
93 \i \bold{\underline{N}}o |
|
94 \i \bold{\underline{O}}pen |
|
95 \i Open \bold{\underline{W}}ith |
|
96 \i Page Set\bold{\underline{u}}p |
|
97 \i \bold{\underline{P}}aste |
|
98 \i Paste \bold{\underline{L}}ink |
|
99 \i Paste \bold{\underline{S}}hortcut |
|
100 \i Paste \bold{\underline{S}}pecial |
|
101 \i \bold{\underline{P}}ause |
|
102 \i \bold{\underline{P}}lay |
|
103 \i \bold{\underline{P}}rint |
|
104 \i \bold{\underline{P}}rint Here |
|
105 \i P\bold{\underline{r}}operties |
|
106 \i \bold{\underline{Q}}uick View |
|
107 \i \bold{\underline{R}}edo (CDE: Ctrl+Y, Shift+Alt+Backspace) |
|
108 \i \bold{\underline{R}}epeat |
|
109 \i \bold{\underline{R}}estore |
|
110 \i \bold{\underline{R}}esume |
|
111 \i \bold{\underline{R}}etry |
|
112 \i \bold{\underline{R}}un |
|
113 \i \bold{\underline{S}}ave |
|
114 \i Save \bold{\underline{A}}s |
|
115 \i Select \bold{\underline{A}}ll |
|
116 \i Se\bold{\underline{n}}d To |
|
117 \i \bold{\underline{S}}how |
|
118 \i \bold{\underline{S}}ize |
|
119 \i S\bold{\underline{p}}lit |
|
120 \i \bold{\underline{S}}top |
|
121 \i \bold{\underline{U}}ndo (CDE: Ctrl+Z or Alt+Backspace) |
|
122 \i \bold{\underline{V}}iew |
|
123 \i \bold{\underline{W}}hat's This? |
|
124 \i \bold{\underline{W}}indow |
|
125 \i \bold{\underline{Y}}es |
|
126 \endlist |
|
127 |
|
128 There are also a lot of other keys and actions (that use other |
|
129 modifier keys than Alt). See the Microsoft and The Open Group |
|
130 documentation for details. |
|
131 |
|
132 The |
|
133 \l{http://www.amazon.com/exec/obidos/ASIN/0735605661/trolltech/t}{Microsoft book} |
|
134 has ISBN 0735605661. The corresponding Open Group |
|
135 book is very hard to find, rather expensive and we cannot recommend |
|
136 it. However, if you really want it, ogpubs@opengroup.org might be able |
|
137 to help. Ask them for ISBN 1859121047. |
|
138 */ |