KWidgetsAddons

kstandardguiitem.cpp
1 /*
2  This file is part of the KDE libraries
3  SPDX-FileCopyrightText: 2001 Holger Freyther <[email protected]>
4 
5  SPDX-License-Identifier: LGPL-2.0-only
6 */
7 
8 #include "kstandardguiitem.h"
9 
10 #include <QApplication>
11 
13 {
15 {
16  switch (ui_enum) {
17  case Ok:
18  return ok();
19  case Cancel:
20  return cancel();
21 #if KWIDGETSADDONS_BUILD_DEPRECATED_SINCE(5, 100)
22  case Yes:
23  return yes();
24  case No:
25  return no();
26 #endif
27  case Discard:
28  return discard();
29  case Save:
30  return save();
31  case DontSave:
32  return dontSave();
33  case SaveAs:
34  return saveAs();
35  case Apply:
36  return apply();
37  case Clear:
38  return clear();
39  case Help:
40  return help();
41  case Close:
42  return close();
43  case CloseWindow:
44  return closeWindow();
45  case CloseDocument:
46  return closeDocument();
47  case Defaults:
48  return defaults();
49  case Back:
50  return back();
51  case Forward:
52  return forward();
53  case Print:
54  return print();
55  case Continue:
56  return cont();
57  case Open:
58  return open();
59  case Quit:
60  return quit();
61  case AdminMode:
62  return adminMode();
63  case Reset:
64  return reset();
65  case Delete:
66  return del();
67  case Insert:
68  return insert();
69  case Configure:
70  return configure();
71  case Find:
72  return find();
73  case Stop:
74  return stop();
75  case Add:
76  return add();
77  case Remove:
78  return remove();
79  case Test:
80  return test();
81  case Properties:
82  return properties();
83  case Overwrite:
84  return overwrite();
85  default:
86  return KGuiItem();
87  };
88 }
89 
91 {
92  switch (ui_enum) {
93  case Ok:
94  return QStringLiteral("ok");
95  case Cancel:
96  return QStringLiteral("cancel");
97 #if KWIDGETSADDONS_BUILD_DEPRECATED_SINCE(5, 100)
98  case Yes:
99  return QStringLiteral("yes");
100  case No:
101  return QStringLiteral("no");
102 #endif
103  case Discard:
104  return QStringLiteral("discard");
105  case Save:
106  return QStringLiteral("save");
107  case DontSave:
108  return QStringLiteral("dontSave");
109  case SaveAs:
110  return QStringLiteral("saveAs");
111  case Apply:
112  return QStringLiteral("apply");
113  case Help:
114  return QStringLiteral("help");
115  case Close:
116  return QStringLiteral("close");
117  case CloseWindow:
118  return QStringLiteral("closeWindow");
119  case CloseDocument:
120  return QStringLiteral("closeDocument");
121  case Defaults:
122  return QStringLiteral("defaults");
123  case Back:
124  return QStringLiteral("back");
125  case Forward:
126  return QStringLiteral("forward");
127  case Print:
128  return QStringLiteral("print");
129  case Continue:
130  return QStringLiteral("continue");
131  case Open:
132  return QStringLiteral("open");
133  case Quit:
134  return QStringLiteral("quit");
135  case AdminMode:
136  return QStringLiteral("adminMode");
137  case Delete:
138  return QStringLiteral("delete");
139  case Insert:
140  return QStringLiteral("insert");
141  case Configure:
142  return QStringLiteral("configure");
143  case Find:
144  return QStringLiteral("find");
145  case Stop:
146  return QStringLiteral("stop");
147  case Add:
148  return QStringLiteral("add");
149  case Remove:
150  return QStringLiteral("remove");
151  case Test:
152  return QStringLiteral("test");
153  case Properties:
154  return QStringLiteral("properties");
155  case Overwrite:
156  return QStringLiteral("overwrite");
157  default:
158  return QString();
159  };
160 }
161 
163 {
164  return KGuiItem(QApplication::translate("KStandardGuiItem", "&OK"), QStringLiteral("dialog-ok"));
165 }
166 
168 {
169  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Cancel"), QStringLiteral("dialog-cancel"));
170 }
171 
172 #if KWIDGETSADDONS_BUILD_DEPRECATED_SINCE(5, 100)
174 {
175  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Yes"), QStringLiteral("dialog-ok"));
176 }
177 #endif
178 
179 #if KWIDGETSADDONS_BUILD_DEPRECATED_SINCE(5, 100)
181 {
182  return KGuiItem(QApplication::translate("KStandardGuiItem", "&No"), QStringLiteral("dialog-cancel"));
183 }
184 #endif
185 
187 {
188  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Discard"),
189  QStringLiteral("edit-delete"),
190  QApplication::translate("KStandardGuiItem", "Discard changes"),
191  QApplication::translate("KStandardGuiItem",
192  "Pressing this button will discard all recent "
193  "changes made in this dialog."));
194 }
195 
197 {
198  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Save"),
199  QStringLiteral("document-save"),
200  QApplication::translate("KStandardGuiItem", "Save data"));
201 }
202 
204 {
205  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Do Not Save"), QString(), QApplication::translate("KStandardGuiItem", "Do not save data"));
206 }
207 
209 {
210  return KGuiItem(QApplication::translate("KStandardGuiItem", "Save &As..."),
211  QStringLiteral("document-save-as"),
212  QApplication::translate("KStandardGuiItem", "Save file with another name"));
213 }
214 
216 {
217  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Apply"),
218  QStringLiteral("dialog-ok-apply"),
219  QApplication::translate("KStandardGuiItem", "Apply changes"),
220  QApplication::translate("KStandardGuiItem",
221  "When you click <b>Apply</b>, the settings will be "
222  "handed over to the program, but the dialog "
223  "will not be closed.\n"
224  "Use this to try different settings."));
225 }
226 
228 {
229  return KGuiItem(QApplication::translate("KStandardGuiItem", "Administrator &Mode..."),
230  QString(),
231  QApplication::translate("KStandardGuiItem", "Enter Administrator Mode"),
232  QApplication::translate("KStandardGuiItem",
233  "When you click <b>Administrator Mode</b> you will be prompted "
234  "for the administrator (root) password in order to make changes "
235  "which require root privileges."));
236 }
237 
239 {
240  return KGuiItem(QApplication::translate("KStandardGuiItem", "C&lear"),
241  QStringLiteral("edit-clear"),
242  QApplication::translate("KStandardGuiItem", "Clear input"),
243  QApplication::translate("KStandardGuiItem", "Clear the input in the edit field"));
244 }
245 
247 {
248  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Help", "show help"),
249  QStringLiteral("help-contents"),
250  QApplication::translate("KStandardGuiItem", "Show help"));
251 }
252 
254 {
255  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Close"),
256  QStringLiteral("window-close"),
257  QApplication::translate("KStandardGuiItem", "Close the current window or document"));
258 }
259 
261 {
262  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Close Window"),
263  QStringLiteral("window-close"),
264  QApplication::translate("KStandardGuiItem", "Close the current window."));
265 }
266 
268 {
269  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Close Document"),
270  QStringLiteral("document-close"),
271  QApplication::translate("KStandardGuiItem", "Close the current document."));
272 }
273 
275 {
276  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Defaults"),
277  QStringLiteral("document-revert"),
278  QApplication::translate("KStandardGuiItem", "Reset all items to their default values"));
279 }
280 
282 {
283  QString icon = (useBidi == UseRTL && QApplication::isRightToLeft()) ? QStringLiteral("go-next") : QStringLiteral("go-previous");
284  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Back", "go back"), icon, QApplication::translate("KStandardGuiItem", "Go back one step"));
285 }
286 
288 {
289  QString icon = (useBidi == UseRTL && QApplication::isRightToLeft()) ? QStringLiteral("go-previous") : QStringLiteral("go-next");
290  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Forward", "go forward"),
291  icon,
292  QApplication::translate("KStandardGuiItem", "Go forward one step"));
293 }
294 
296 {
297  return qMakePair(back(UseRTL), forward(UseRTL));
298 }
299 
301 {
302  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Print..."),
303  QStringLiteral("document-print"),
304  QApplication::translate("KStandardGuiItem",
305  "Opens the print dialog to print "
306  "the current document"));
307 }
308 
310 {
311  return KGuiItem(QApplication::translate("KStandardGuiItem", "C&ontinue"),
312  QStringLiteral("arrow-right"),
313  QApplication::translate("KStandardGuiItem", "Continue operation"));
314 }
315 
317 {
318  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Delete"),
319  QStringLiteral("edit-delete"),
320  QApplication::translate("KStandardGuiItem", "Delete item(s)"));
321 }
322 
324 {
325  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Open..."),
326  QStringLiteral("document-open"),
327  QApplication::translate("KStandardGuiItem", "Open file"));
328 }
329 
331 {
332  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Quit"),
333  QStringLiteral("application-exit"),
334  QApplication::translate("KStandardGuiItem", "Quit application"));
335 }
336 
338 {
339  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Reset"),
340  QStringLiteral("edit-undo"),
341  QApplication::translate("KStandardGuiItem", "Reset configuration"));
342 }
343 
345 {
346  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Insert", "Verb"));
347 }
348 
350 {
351  return KGuiItem(QApplication::translate("KStandardGuiItem", "Confi&gure..."), QStringLiteral("configure"));
352 }
353 
355 {
356  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Find"), QStringLiteral("edit-find"));
357 }
358 
360 {
361  return KGuiItem(QApplication::translate("KStandardGuiItem", "Stop"), QStringLiteral("process-stop"));
362 }
363 
365 {
366  return KGuiItem(QApplication::translate("KStandardGuiItem", "Add"), QStringLiteral("list-add"));
367 }
368 
370 {
371  return KGuiItem(QApplication::translate("KStandardGuiItem", "Remove"), QStringLiteral("list-remove"));
372 }
373 
375 {
376  return KGuiItem(QApplication::translate("KStandardGuiItem", "Test"));
377 }
378 
380 {
381  return KGuiItem(QApplication::translate("KStandardGuiItem", "Properties"), QStringLiteral("document-properties"));
382 }
383 
385 {
386  return KGuiItem(QApplication::translate("KStandardGuiItem", "&Overwrite"), QStringLiteral("document-replace"));
387 }
388 
389 void assign(QPushButton *button, StandardItem item)
390 {
392 }
393 
394 } // KStandardGuiItem namespace
KGuiItem no()
Returns the 'No' gui item.
BidiMode
The back and forward items by default use the RTL settings for Hebrew and Arab countries.
KGuiItem quit()
Returns the 'Quit' gui item.
KGuiItem configure()
Returns the 'Configure' gui item.
QString translate(const char *context, const char *sourceText, const char *disambiguation, int n)
KGuiItem closeDocument()
Returns the 'CloseDocument' gui item.
KGuiItem properties()
Returns the 'Properties' gui item.
KGuiItem guiItem(StandardItem ui_enum)
Returns the gui item for the given identifier id.
KGuiItem dontSave()
Returns the 'DontSave' gui item.
KGuiItem save()
Returns the 'Save' gui item.
QString standardItem(StandardItem ui_enum)
Returns the name of the gui item for the given identifier id.
KGuiItem close()
Returns the 'Close' gui item.
KGuiItem cancel()
Returns the 'Cancel' gui item.
KGuiItem test()
Returns the 'Test' gui item.
static void assign(QPushButton *button, const KGuiItem &item)
A static method that can be used to set the text, icon, tooltip and WhatThis properties from item on ...
Definition: kguiitem.cpp:172
KGuiItem adminMode()
Returns a KGuiItem suiting for cases where code or functionality runs under root privileges.
KGuiItem closeWindow()
Returns the 'CloseWindow' gui item.
KGuiItem clear()
Returns the 'Clear' gui item.
Provides a set of standardized KGuiItems.
KGuiItem yes()
Returns the 'Yes' gui item.
KGuiItem remove()
Returns the 'Remove' gui item.
KGuiItem stop()
Returns the 'Stop' gui item.
bool isRightToLeft()
KGuiItem forward(BidiMode useBidi)
Returns the 'Forward' gui item, like Konqueror's forward button.
KGuiItem print()
Returns the 'Print' gui item.
KGuiItem del()
Returns the 'Delete' gui item.
KGuiItem insert()
Returns the 'Insert' gui item.
KGuiItem add()
Returns the 'Add' gui item.
KGuiItem defaults()
Returns the 'Defaults' gui item.
KGuiItem cont()
Returns the 'Continue' gui item.
KGuiItem reset()
Returns the 'Reset' gui item.
KGuiItem back(BidiMode useBidi)
Returns the 'Back' gui item, like Konqueror's back button.
KGuiItem ok()
Returns the 'Ok' gui item.
KGuiItem apply()
Returns the 'Apply' gui item.
KGuiItem open()
Returns the 'Open' gui item.
KGuiItem overwrite()
Returns the 'Overwrite' gui item.
KGuiItem saveAs()
Returns the 'SaveAs' gui item.
KGuiItem discard()
Returns the 'Discard' gui item.
KGuiItem find()
Returns the 'Find' gui item.
KGuiItem help()
Returns the 'Help' gui item.
An abstract class for setting the text, icon, tooltip and WhatsThis data on a GUI item (e....
Definition: kguiitem.h:33
QPair< KGuiItem, KGuiItem > backAndForward()
Return both a back and a forward gui item.
This file is part of the KDE documentation.
Documentation copyright © 1996-2023 The KDE developers.
Generated on Mon Dec 11 2023 04:01:37 by doxygen 1.8.17 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.