]>
Commit | Line | Data |
---|---|---|
1 | /////////////////////////////////////////////////////////////////////////////// | |
2 | // Name: src/common/stockitem.cpp | |
3 | // Purpose: Stock buttons, menu and toolbar items labels | |
4 | // Author: Vaclav Slavik | |
5 | // Modified by: | |
6 | // Created: 2004-08-15 | |
7 | // RCS-ID: $Id$ | |
8 | // Copyright: (c) Vaclav Slavik, 2004 | |
9 | // Licence: wxWindows licence | |
10 | /////////////////////////////////////////////////////////////////////////////// | |
11 | ||
12 | // ============================================================================ | |
13 | // declarations | |
14 | // ============================================================================ | |
15 | ||
16 | // ---------------------------------------------------------------------------- | |
17 | // headers | |
18 | // ---------------------------------------------------------------------------- | |
19 | ||
20 | // For compilers that support precompilation, includes "wx.h". | |
21 | #include "wx/wxprec.h" | |
22 | ||
23 | #ifdef __BORLANDC__ | |
24 | #pragma hdrstop | |
25 | #endif | |
26 | ||
27 | #include "wx/stockitem.h" | |
28 | ||
29 | #ifndef WX_PRECOMP | |
30 | #include "wx/intl.h" | |
31 | #include "wx/utils.h" // for wxStripMenuCodes() | |
32 | #endif | |
33 | ||
34 | bool wxIsStockID(wxWindowID id) | |
35 | { | |
36 | switch (id) | |
37 | { | |
38 | case wxID_ABOUT: | |
39 | case wxID_ADD: | |
40 | case wxID_APPLY: | |
41 | case wxID_BACKWARD: | |
42 | case wxID_BOLD: | |
43 | case wxID_BOTTOM: | |
44 | case wxID_CANCEL: | |
45 | case wxID_CDROM: | |
46 | case wxID_CLEAR: | |
47 | case wxID_CLOSE: | |
48 | case wxID_CONVERT: | |
49 | case wxID_COPY: | |
50 | case wxID_CUT: | |
51 | case wxID_DELETE: | |
52 | case wxID_DOWN: | |
53 | case wxID_EDIT: | |
54 | case wxID_EXECUTE: | |
55 | case wxID_EXIT: | |
56 | case wxID_FILE: | |
57 | case wxID_FIND: | |
58 | case wxID_FIRST: | |
59 | case wxID_FLOPPY: | |
60 | case wxID_FORWARD: | |
61 | case wxID_HARDDISK: | |
62 | case wxID_HELP: | |
63 | case wxID_HOME: | |
64 | case wxID_INDENT: | |
65 | case wxID_INDEX: | |
66 | case wxID_INFO: | |
67 | case wxID_ITALIC: | |
68 | case wxID_JUMP_TO: | |
69 | case wxID_JUSTIFY_CENTER: | |
70 | case wxID_JUSTIFY_FILL: | |
71 | case wxID_JUSTIFY_LEFT: | |
72 | case wxID_JUSTIFY_RIGHT: | |
73 | case wxID_LAST: | |
74 | case wxID_NETWORK: | |
75 | case wxID_NEW: | |
76 | case wxID_NO: | |
77 | case wxID_OK: | |
78 | case wxID_OPEN: | |
79 | case wxID_PASTE: | |
80 | case wxID_PREFERENCES: | |
81 | case wxID_PREVIEW: | |
82 | case wxID_PRINT: | |
83 | case wxID_PROPERTIES: | |
84 | case wxID_REDO: | |
85 | case wxID_REFRESH: | |
86 | case wxID_REMOVE: | |
87 | case wxID_REPLACE: | |
88 | case wxID_REVERT_TO_SAVED: | |
89 | case wxID_SAVE: | |
90 | case wxID_SAVEAS: | |
91 | case wxID_SELECTALL: | |
92 | case wxID_SELECT_COLOR: | |
93 | case wxID_SELECT_FONT: | |
94 | case wxID_SORT_ASCENDING: | |
95 | case wxID_SORT_DESCENDING: | |
96 | case wxID_SPELL_CHECK: | |
97 | case wxID_STOP: | |
98 | case wxID_STRIKETHROUGH: | |
99 | case wxID_TOP: | |
100 | case wxID_UNDELETE: | |
101 | case wxID_UNDERLINE: | |
102 | case wxID_UNDO: | |
103 | case wxID_UNINDENT: | |
104 | case wxID_UP: | |
105 | case wxID_YES: | |
106 | case wxID_ZOOM_100: | |
107 | case wxID_ZOOM_FIT: | |
108 | case wxID_ZOOM_IN: | |
109 | case wxID_ZOOM_OUT: | |
110 | return true; | |
111 | ||
112 | default: | |
113 | return false; | |
114 | } | |
115 | } | |
116 | ||
117 | wxString wxGetStockLabel(wxWindowID id, long flags) | |
118 | { | |
119 | wxString stockLabel; | |
120 | ||
121 | #define STOCKITEM(stockid, label) \ | |
122 | case stockid: \ | |
123 | stockLabel = label; \ | |
124 | break; | |
125 | ||
126 | switch (id) | |
127 | { | |
128 | STOCKITEM(wxID_ABOUT, _("&About...")) | |
129 | STOCKITEM(wxID_ADD, _("Add")) | |
130 | STOCKITEM(wxID_APPLY, _("&Apply")) | |
131 | STOCKITEM(wxID_BACKWARD, _("&Back")) | |
132 | STOCKITEM(wxID_BOLD, _("&Bold")) | |
133 | STOCKITEM(wxID_BOTTOM, _("&Bottom")) | |
134 | STOCKITEM(wxID_CANCEL, _("&Cancel")) | |
135 | STOCKITEM(wxID_CDROM, _("&CD-Rom")) | |
136 | STOCKITEM(wxID_CLEAR, _("&Clear")) | |
137 | STOCKITEM(wxID_CLOSE, _("&Close")) | |
138 | STOCKITEM(wxID_CONVERT, _("&Convert")) | |
139 | STOCKITEM(wxID_COPY, _("&Copy")) | |
140 | STOCKITEM(wxID_CUT, _("Cu&t")) | |
141 | STOCKITEM(wxID_DELETE, _("&Delete")) | |
142 | STOCKITEM(wxID_DOWN, _("&Down")) | |
143 | STOCKITEM(wxID_EDIT, _("&Edit")) | |
144 | STOCKITEM(wxID_EXECUTE, _("&Execute")) | |
145 | STOCKITEM(wxID_EXIT, _("&Quit")) | |
146 | STOCKITEM(wxID_FILE, _("&File")) | |
147 | STOCKITEM(wxID_FIND, _("&Find")) | |
148 | STOCKITEM(wxID_FIRST, _("&First")) | |
149 | STOCKITEM(wxID_FLOPPY, _("&Floppy")) | |
150 | STOCKITEM(wxID_FORWARD, _("&Forward")) | |
151 | STOCKITEM(wxID_HARDDISK, _("&Harddisk")) | |
152 | STOCKITEM(wxID_HELP, _("&Help")) | |
153 | STOCKITEM(wxID_HOME, _("&Home")) | |
154 | STOCKITEM(wxID_INDENT, _("Indent")) | |
155 | STOCKITEM(wxID_INDEX, _("&Index")) | |
156 | STOCKITEM(wxID_INFO, _("&Info")) | |
157 | STOCKITEM(wxID_ITALIC, _("&Italic")) | |
158 | STOCKITEM(wxID_JUMP_TO, _("&Jump to")) | |
159 | STOCKITEM(wxID_JUSTIFY_CENTER, _("Centered")) | |
160 | STOCKITEM(wxID_JUSTIFY_FILL, _("Justified")) | |
161 | STOCKITEM(wxID_JUSTIFY_LEFT, _("Align Left")) | |
162 | STOCKITEM(wxID_JUSTIFY_RIGHT, _("Align Right")) | |
163 | STOCKITEM(wxID_LAST, _("&Last")) | |
164 | STOCKITEM(wxID_NETWORK, _("&Network")) | |
165 | STOCKITEM(wxID_NEW, _("&New")) | |
166 | STOCKITEM(wxID_NO, _("&No")) | |
167 | STOCKITEM(wxID_OK, _("&OK")) | |
168 | STOCKITEM(wxID_OPEN, _("&Open...")) | |
169 | STOCKITEM(wxID_PASTE, _("&Paste")) | |
170 | STOCKITEM(wxID_PREFERENCES, _("&Preferences")) | |
171 | STOCKITEM(wxID_PREVIEW, _("Print previe&w")) | |
172 | STOCKITEM(wxID_PRINT, _("&Print...")) | |
173 | STOCKITEM(wxID_PROPERTIES, _("&Properties")) | |
174 | STOCKITEM(wxID_REDO, _("&Redo")) | |
175 | STOCKITEM(wxID_REFRESH, _("Refresh")) | |
176 | STOCKITEM(wxID_REMOVE, _("Remove")) | |
177 | STOCKITEM(wxID_REPLACE, _("Rep&lace")) | |
178 | STOCKITEM(wxID_REVERT_TO_SAVED, _("Revert to Saved")) | |
179 | STOCKITEM(wxID_SAVE, _("&Save")) | |
180 | STOCKITEM(wxID_SAVEAS, _("Save &As...")) | |
181 | STOCKITEM(wxID_SELECTALL, _("Select &All")) | |
182 | STOCKITEM(wxID_SELECT_COLOR, _("&Color")) | |
183 | STOCKITEM(wxID_SELECT_FONT, _("&Font")) | |
184 | STOCKITEM(wxID_SORT_ASCENDING, _("&Ascending")) | |
185 | STOCKITEM(wxID_SORT_DESCENDING, _("&Descending")) | |
186 | STOCKITEM(wxID_SPELL_CHECK, _("&Spell Check")) | |
187 | STOCKITEM(wxID_STOP, _("&Stop")) | |
188 | STOCKITEM(wxID_STRIKETHROUGH, _("&Strikethrough")) | |
189 | STOCKITEM(wxID_TOP, _("&Top")) | |
190 | STOCKITEM(wxID_UNDELETE, _("Undelete")) | |
191 | STOCKITEM(wxID_UNDERLINE, _("&Underline")) | |
192 | STOCKITEM(wxID_UNDO, _("&Undo")) | |
193 | STOCKITEM(wxID_UNINDENT, _("&Unindent")) | |
194 | STOCKITEM(wxID_UP, _("&Up")) | |
195 | STOCKITEM(wxID_YES, _("&Yes")) | |
196 | STOCKITEM(wxID_ZOOM_100, _("&Actual Size")) | |
197 | STOCKITEM(wxID_ZOOM_FIT, _("Zoom to &Fit")) | |
198 | STOCKITEM(wxID_ZOOM_IN, _("Zoom &In")) | |
199 | STOCKITEM(wxID_ZOOM_OUT, _("Zoom &Out")) | |
200 | ||
201 | default: | |
202 | wxFAIL_MSG( wxT("invalid stock item ID") ); | |
203 | break; | |
204 | }; | |
205 | ||
206 | #undef STOCKITEM | |
207 | ||
208 | // we assume that buttons use the same labels as menu items but unlike them | |
209 | // they should never use ellipsis | |
210 | if ( (flags & wxSTOCK_FOR_BUTTON) == wxSTOCK_FOR_BUTTON ) | |
211 | { | |
212 | wxString baseLabel; | |
213 | if ( stockLabel.EndsWith("...", &baseLabel) ) | |
214 | stockLabel = baseLabel; | |
215 | ||
216 | wxASSERT_MSG( !(flags & wxSTOCK_WITH_ACCELERATOR), | |
217 | "button labels never use accelerators" ); | |
218 | } | |
219 | ||
220 | #ifdef __WXMSW__ | |
221 | // special case: the "Cancel" button shouldn't have a mnemonic under MSW | |
222 | // for consistency with the native dialogs (which don't use any mnemonic | |
223 | // for it because it is already bound to Esc implicitly) | |
224 | if ( id == wxID_CANCEL ) | |
225 | flags &= ~wxSTOCK_WITH_MNEMONIC; | |
226 | #endif // __WXMSW__ | |
227 | ||
228 | if ( !(flags & wxSTOCK_WITH_MNEMONIC) ) | |
229 | { | |
230 | stockLabel = wxStripMenuCodes(stockLabel); | |
231 | } | |
232 | ||
233 | #if wxUSE_ACCEL | |
234 | if ( !stockLabel.empty() && (flags & wxSTOCK_WITH_ACCELERATOR) ) | |
235 | { | |
236 | wxAcceleratorEntry accel = wxGetStockAccelerator(id); | |
237 | if (accel.IsOk()) | |
238 | stockLabel << wxT('\t') << accel.ToString(); | |
239 | } | |
240 | #endif // wxUSE_ACCEL | |
241 | ||
242 | return stockLabel; | |
243 | } | |
244 | ||
245 | wxString wxGetStockHelpString(wxWindowID id, wxStockHelpStringClient client) | |
246 | { | |
247 | wxString stockHelp; | |
248 | ||
249 | #define STOCKITEM(stockid, ctx, helpstr) \ | |
250 | case stockid: \ | |
251 | if (client==ctx) stockHelp = helpstr; \ | |
252 | break; | |
253 | ||
254 | switch (id) | |
255 | { | |
256 | // NB: these help string should be not too specific as they could be used | |
257 | // in completely different programs! | |
258 | STOCKITEM(wxID_ABOUT, wxSTOCK_MENU, _("Show about dialog")) | |
259 | STOCKITEM(wxID_COPY, wxSTOCK_MENU, _("Copy selection")) | |
260 | STOCKITEM(wxID_CUT, wxSTOCK_MENU, _("Cut selection")) | |
261 | STOCKITEM(wxID_DELETE, wxSTOCK_MENU, _("Delete selection")) | |
262 | STOCKITEM(wxID_REPLACE, wxSTOCK_MENU, _("Replace selection")) | |
263 | STOCKITEM(wxID_PASTE, wxSTOCK_MENU, _("Paste selection")) | |
264 | STOCKITEM(wxID_EXIT, wxSTOCK_MENU, _("Quit this program")) | |
265 | STOCKITEM(wxID_REDO, wxSTOCK_MENU, _("Redo last action")) | |
266 | STOCKITEM(wxID_UNDO, wxSTOCK_MENU, _("Undo last action")) | |
267 | STOCKITEM(wxID_CLOSE, wxSTOCK_MENU, _("Close current document")) | |
268 | STOCKITEM(wxID_SAVE, wxSTOCK_MENU, _("Save current document")) | |
269 | STOCKITEM(wxID_SAVEAS, wxSTOCK_MENU, _("Save current document with a different filename")) | |
270 | ||
271 | default: | |
272 | // there's no stock help string for this ID / client | |
273 | return wxEmptyString; | |
274 | } | |
275 | ||
276 | #undef STOCKITEM | |
277 | ||
278 | return stockHelp; | |
279 | } | |
280 | ||
281 | #if wxUSE_ACCEL | |
282 | ||
283 | wxAcceleratorEntry wxGetStockAccelerator(wxWindowID id) | |
284 | { | |
285 | wxAcceleratorEntry ret; | |
286 | ||
287 | #define STOCKITEM(stockid, flags, keycode) \ | |
288 | case stockid: \ | |
289 | ret.Set(flags, keycode, stockid); \ | |
290 | break; | |
291 | ||
292 | switch (id) | |
293 | { | |
294 | STOCKITEM(wxID_COPY, wxACCEL_CMD,'C') | |
295 | STOCKITEM(wxID_CUT, wxACCEL_CMD,'X') | |
296 | STOCKITEM(wxID_FIND, wxACCEL_CMD,'F') | |
297 | STOCKITEM(wxID_HELP, wxACCEL_CMD,'H') | |
298 | STOCKITEM(wxID_NEW, wxACCEL_CMD,'N') | |
299 | STOCKITEM(wxID_OPEN, wxACCEL_CMD,'O') | |
300 | STOCKITEM(wxID_PASTE, wxACCEL_CMD,'V') | |
301 | STOCKITEM(wxID_REDO, wxACCEL_CMD | wxACCEL_SHIFT,'Z') | |
302 | STOCKITEM(wxID_REPLACE, wxACCEL_CMD,'R') | |
303 | STOCKITEM(wxID_SAVE, wxACCEL_CMD,'S') | |
304 | STOCKITEM(wxID_UNDO, wxACCEL_CMD,'Z') | |
305 | ||
306 | default: | |
307 | // set the wxAcceleratorEntry to return into an invalid state: | |
308 | // there's no stock accelerator for that. | |
309 | ret.Set(0, 0, id); | |
310 | break; | |
311 | }; | |
312 | ||
313 | #undef STOCKITEM | |
314 | ||
315 | // always use wxAcceleratorEntry::IsOk on returned value ! | |
316 | return ret; | |
317 | } | |
318 | ||
319 | #endif // wxUSE_ACCEL | |
320 | ||
321 | bool wxIsStockLabel(wxWindowID id, const wxString& label) | |
322 | { | |
323 | if (label.empty()) | |
324 | return true; | |
325 | ||
326 | wxString stock = wxGetStockLabel(id); | |
327 | ||
328 | if (label == stock) | |
329 | return true; | |
330 | ||
331 | stock.Replace(wxT("&"), wxEmptyString); | |
332 | if (label == stock) | |
333 | return true; | |
334 | ||
335 | return false; | |
336 | } |