• Skip to content
  • Skip to link menu
  • KDE API Reference
  • kdelibs-4.14.38 API Reference
  • KDE Home
  • Contact Us
 

KDEUI

  • kdeui
  • util
kstandardguiitem.cpp
Go to the documentation of this file.
1/* This file is part of the KDE libraries
2 Copyright (C) 2001 Holger Freyther <freyther@kde.org>
3
4 This library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Library General Public
6 License version 2 as published by the Free Software Foundation.
7
8 This library is distributed in the hope that it will be useful,
9 but WITHOUT ANY WARRANTY; without even the implied warranty of
10 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 Library General Public License for more details.
12
13 You should have received a copy of the GNU Library General Public License
14 along with this library; see the file COPYING.LIB. If not, write to
15 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
16 Boston, MA 02110-1301, USA.
17*/
18
19#include "kstandardguiitem.h"
20
21#include <QtGui/QApplication>
22
23#include <kguiitem.h>
24#include <klocale.h>
25
26namespace KStandardGuiItem
27{
28
29KGuiItem guiItem( StandardItem ui_enum )
30{
31 switch (ui_enum ) {
32 case Ok : return ok();
33 case Cancel : return cancel();
34 case Yes : return yes();
35 case No : return no();
36 case Discard : return discard();
37 case Save : return save();
38 case DontSave : return dontSave();
39 case SaveAs : return saveAs();
40 case Apply : return apply();
41 case Clear : return clear();
42 case Help : return help();
43 case Close : return close();
44 case CloseWindow : return closeWindow();
45 case CloseDocument : return closeDocument();
46 case Defaults : return defaults();
47 case Back : return back();
48 case Forward : return forward();
49 case Print : return print();
50 case Continue : return cont();
51 case Open : return open();
52 case Quit : return quit();
53 case AdminMode: return adminMode();
54 case Reset : return reset();
55 case Delete : return del();
56 case Insert : return insert();
57 case Configure: return configure();
58 case Find : return find();
59 case Stop : return stop();
60 case Add : return add();
61 case Remove : return remove();
62 case Test : return test();
63 case Properties : return properties();
64 case Overwrite : return overwrite();
65 default : return KGuiItem();
66 };
67}
68
69QString standardItem( StandardItem ui_enum )
70{
71 switch (ui_enum ) {
72 case Ok : return QLatin1String("ok");
73 case Cancel : return QLatin1String("cancel");
74 case Yes : return QLatin1String("yes");
75 case No : return QLatin1String("no");
76 case Discard : return QLatin1String("discard");
77 case Save : return QLatin1String("save");
78 case DontSave : return QLatin1String("dontSave");
79 case SaveAs : return QLatin1String("saveAs");
80 case Apply : return QLatin1String("apply");
81 case Help : return QLatin1String("help");
82 case Close : return QLatin1String("close");
83 case CloseWindow : return QLatin1String("closeWindow");
84 case CloseDocument : return QLatin1String("closeDocument");
85 case Defaults : return QLatin1String("defaults");
86 case Back : return QLatin1String("back");
87 case Forward : return QLatin1String("forward");
88 case Print : return QLatin1String("print");
89 case Continue : return QLatin1String("continue");
90 case Open : return QLatin1String("open");
91 case Quit : return QLatin1String("quit");
92 case AdminMode: return QLatin1String("adminMode");
93 case Delete : return QLatin1String("delete");
94 case Insert : return QLatin1String("insert");
95 case Configure: return QLatin1String("configure");
96 case Find : return QLatin1String("find");
97 case Stop : return QLatin1String("stop");
98 case Add : return QLatin1String("add");
99 case Remove : return QLatin1String("remove");
100 case Test : return QLatin1String("test");
101 case Properties : return QLatin1String("properties");
102 case Overwrite : return QLatin1String("overwrite");
103 default : return QString();
104 };
105}
106
107KGuiItem ok()
108{
109 return KGuiItem( i18n( "&OK" ), "dialog-ok" );
110}
111
112
113KGuiItem cancel()
114{
115 return KGuiItem( i18n( "&Cancel" ), "dialog-cancel" );
116}
117
118KGuiItem yes()
119{
120 return KGuiItem( i18n( "&Yes" ), "dialog-ok", i18n( "Yes" ) );
121}
122
123KGuiItem no()
124{
125 return KGuiItem( i18n( "&No" ), "process-stop", i18n( "No" ) );
126}
127
128KGuiItem discard()
129{
130 return KGuiItem( i18n( "&Discard" ), "edit-clear", i18n( "Discard changes" ),
131 i18n( "Pressing this button will discard all recent "
132 "changes made in this dialog." ) );
133}
134
135KGuiItem save()
136{
137 return KGuiItem( i18n( "&Save" ), "document-save", i18n( "Save data" ) );
138}
139
140KGuiItem dontSave()
141{
142 return KGuiItem( i18n( "&Do Not Save" ), "",
143 i18n( "Do not save data" ) );
144}
145
146KGuiItem saveAs()
147{
148 return KGuiItem( i18n( "Save &As..." ), "document-save-as",
149 i18n( "Save file with another name" ) );
150}
151
152KGuiItem apply()
153{
154 return KGuiItem( i18n( "&Apply" ), "dialog-ok-apply", i18n( "Apply changes" ),
155 i18n( "When you click <b>Apply</b>, the settings will be "
156 "handed over to the program, but the dialog "
157 "will not be closed.\n"
158 "Use this to try different settings." ) );
159}
160
161KGuiItem adminMode()
162{
163 return KGuiItem( i18n( "Administrator &Mode..." ), "", i18n( "Enter Administrator Mode" ),
164 i18n( "When you click <b>Administrator Mode</b> you will be prompted "
165 "for the administrator (root) password in order to make changes "
166 "which require root privileges." ) );
167}
168
169KGuiItem clear()
170{
171 return KGuiItem( i18n( "C&lear" ), "edit-clear",
172 i18n( "Clear input" ),
173 i18n( "Clear the input in the edit field" ) );
174}
175
176KGuiItem help()
177{
178 return KGuiItem( i18nc( "show help", "&Help" ), "help-contents",
179 i18n( "Show help" ) );
180}
181
182KGuiItem close()
183{
184 return KGuiItem( i18n( "&Close" ), "window-close",
185 i18n( "Close the current window or document" ) );
186}
187
188KGuiItem closeWindow()
189{
190 return KGuiItem( i18n( "&Close Window" ), "window-close",
191 i18n( "Close the current window." ) );
192}
193
194KGuiItem closeDocument()
195{
196 return KGuiItem( i18n( "&Close Document" ), "document-close",
197 i18n( "Close the current document." ) );
198}
199
200KGuiItem defaults()
201{
202 return KGuiItem( i18n( "&Defaults" ), "document-revert",
203 i18n( "Reset all items to their default values" ) );
204}
205
206KGuiItem back( BidiMode useBidi )
207{
208 QString icon = ( useBidi == UseRTL && QApplication::isRightToLeft() )
209 ? "go-next" : "go-previous";
210 return KGuiItem( i18nc( "go back", "&Back" ), icon,
211 i18n( "Go back one step" ) );
212}
213
214KGuiItem forward( BidiMode useBidi )
215{
216 QString icon = ( useBidi == UseRTL && QApplication::isRightToLeft() )
217 ? "go-previous" : "go-next";
218 return KGuiItem( i18nc( "go forward", "&Forward" ), icon,
219 i18n( "Go forward one step" ) );
220}
221
222QPair<KGuiItem, KGuiItem> backAndForward()
223{
224 return qMakePair( back( UseRTL ), forward( UseRTL ) );
225}
226
227KGuiItem print()
228{
229 return KGuiItem( i18n( "&Print..." ), "document-print",
230 i18n( "Opens the print dialog to print "
231 "the current document" ) );
232}
233
234KGuiItem cont()
235{
236 return KGuiItem( i18n( "C&ontinue" ), "arrow-right",
237 i18n( "Continue operation" ) );
238}
239
240KGuiItem del()
241{
242 return KGuiItem( i18n( "&Delete" ), "edit-delete",
243 i18n( "Delete item(s)" ) );
244}
245
246KGuiItem open()
247{
248 return KGuiItem( i18n( "&Open..." ), "document-open",
249 i18n( "Open file" ) );
250}
251
252KGuiItem quit()
253{
254 return KGuiItem( i18n( "&Quit" ), "application-exit",
255 i18n( "Quit application" ) );
256}
257
258KGuiItem reset()
259{
260 return KGuiItem( i18n( "&Reset" ), "edit-undo",
261 i18n( "Reset configuration" ) );
262}
263
264KGuiItem insert()
265{
266 return KGuiItem( i18nc( "Verb", "&Insert" ) );
267}
268
269KGuiItem configure()
270{
271 return KGuiItem( i18n( "Confi&gure..." ), "configure" );
272}
273
274KGuiItem find()
275{
276 return KGuiItem(i18n("&Find"), "edit-find");
277}
278
279KGuiItem stop()
280{
281 return KGuiItem(i18n("Stop"), "process-stop");
282}
283
284KGuiItem add()
285{
286 return KGuiItem(i18n("Add"), "list-add");
287}
288
289KGuiItem remove()
290{
291 return KGuiItem(i18n("Remove"), "list-remove");
292}
293
294KGuiItem test()
295{
296 return KGuiItem(i18n("Test"));
297}
298
299KGuiItem properties()
300{
301 return KGuiItem(i18n("Properties"), "document-properties");
302}
303
304KGuiItem overwrite()
305{
306 return KGuiItem(i18n("&Overwrite"));
307}
308
309} // KStandardGuiItem namespace
310
Defaults
Returns true if this action is enabled to have a global shortcut.
KGuiItem
An abstract class for GUI data such as ToolTip and Icon.
Definition: kguiitem.h:37
QPair
kguiitem.h
klocale.h
i18n
QString i18n(const char *text)
i18nc
QString i18nc(const char *ctxt, const char *text)
kstandardguiitem.h
open
int open(const QString &pathname, int flags, mode_t mode)
KStandardGuiItem
Provides a set of standardized KGuiItems.
Definition: kstandardguiitem.cpp:27
KStandardGuiItem::reset
KGuiItem reset()
Returns the 'Reset' gui item.
Definition: kstandardguiitem.cpp:258
KStandardGuiItem::add
KGuiItem add()
Returns the 'Add' gui item.
Definition: kstandardguiitem.cpp:284
KStandardGuiItem::BidiMode
BidiMode
The back and forward items by default use the RTL settings for Hebrew and Arab countries.
Definition: kstandardguiitem.h:46
KStandardGuiItem::UseRTL
@ UseRTL
Definition: kstandardguiitem.h:46
KStandardGuiItem::remove
KGuiItem remove()
Returns the 'Remove' gui item.
Definition: kstandardguiitem.cpp:289
KStandardGuiItem::yes
KGuiItem yes()
Returns the 'Yes' gui item.
Definition: kstandardguiitem.cpp:118
KStandardGuiItem::overwrite
KGuiItem overwrite()
Returns the 'Overwrite' gui item.
Definition: kstandardguiitem.cpp:304
KStandardGuiItem::properties
KGuiItem properties()
Returns the 'Properties' gui item.
Definition: kstandardguiitem.cpp:299
KStandardGuiItem::cont
KGuiItem cont()
Returns the 'Continue' gui item.
Definition: kstandardguiitem.cpp:234
KStandardGuiItem::stop
KGuiItem stop()
Returns the 'Stop' gui item.
Definition: kstandardguiitem.cpp:279
KStandardGuiItem::configure
KGuiItem configure()
Returns the 'Configure' gui item.
Definition: kstandardguiitem.cpp:269
KStandardGuiItem::no
KGuiItem no()
Returns the 'No' gui item.
Definition: kstandardguiitem.cpp:123
KStandardGuiItem::standardItem
QString standardItem(StandardItem ui_enum)
Returns the name of the gui item for the given identifier.
Definition: kstandardguiitem.cpp:69
KStandardGuiItem::cancel
KGuiItem cancel()
Returns the 'Cancel' gui item.
Definition: kstandardguiitem.cpp:113
KStandardGuiItem::defaults
KGuiItem defaults()
Returns the 'Defaults' gui item.
Definition: kstandardguiitem.cpp:200
KStandardGuiItem::dontSave
KGuiItem dontSave()
Returns the 'DontSave' gui item.
Definition: kstandardguiitem.cpp:140
KStandardGuiItem::apply
KGuiItem apply()
Returns the 'Apply' gui item.
Definition: kstandardguiitem.cpp:152
KStandardGuiItem::ok
KGuiItem ok()
Returns the 'Ok' gui item.
Definition: kstandardguiitem.cpp:107
KStandardGuiItem::test
KGuiItem test()
Returns the 'Test' gui item.
Definition: kstandardguiitem.cpp:294
KStandardGuiItem::discard
KGuiItem discard()
Returns the 'Discard' gui item.
Definition: kstandardguiitem.cpp:128
KStandardGuiItem::del
KGuiItem del()
Returns the 'Delete' gui item.
Definition: kstandardguiitem.cpp:240
KStandardGuiItem::closeDocument
KGuiItem closeDocument()
Returns the 'CloseDocument' gui item.
Definition: kstandardguiitem.cpp:194
KStandardGuiItem::StandardItem
StandardItem
Definition: kstandardguiitem.h:49
KStandardGuiItem::Cancel
@ Cancel
Definition: kstandardguiitem.h:50
KStandardGuiItem::Ok
@ Ok
Definition: kstandardguiitem.h:50
KStandardGuiItem::Remove
@ Remove
Definition: kstandardguiitem.h:52
KStandardGuiItem::Reset
@ Reset
Definition: kstandardguiitem.h:52
KStandardGuiItem::CloseWindow
@ CloseWindow
Definition: kstandardguiitem.h:53
KStandardGuiItem::Overwrite
@ Overwrite
Definition: kstandardguiitem.h:53
KStandardGuiItem::No
@ No
Definition: kstandardguiitem.h:50
KStandardGuiItem::Apply
@ Apply
Definition: kstandardguiitem.h:50
KStandardGuiItem::Insert
@ Insert
Definition: kstandardguiitem.h:52
KStandardGuiItem::Stop
@ Stop
Definition: kstandardguiitem.h:52
KStandardGuiItem::Discard
@ Discard
Definition: kstandardguiitem.h:50
KStandardGuiItem::Delete
@ Delete
Definition: kstandardguiitem.h:52
KStandardGuiItem::CloseDocument
@ CloseDocument
Definition: kstandardguiitem.h:53
KStandardGuiItem::DontSave
@ DontSave
Definition: kstandardguiitem.h:50
KStandardGuiItem::AdminMode
@ AdminMode
Definition: kstandardguiitem.h:52
KStandardGuiItem::Test
@ Test
Definition: kstandardguiitem.h:53
KStandardGuiItem::Continue
@ Continue
Definition: kstandardguiitem.h:51
KStandardGuiItem::Add
@ Add
Definition: kstandardguiitem.h:52
KStandardGuiItem::Properties
@ Properties
Definition: kstandardguiitem.h:53
KStandardGuiItem::Yes
@ Yes
Definition: kstandardguiitem.h:50
KStandardGuiItem::Configure
@ Configure
Definition: kstandardguiitem.h:52
KStandardGuiItem::backAndForward
QPair< KGuiItem, KGuiItem > backAndForward()
Return both a back and a forward gui item.
Definition: kstandardguiitem.cpp:222
KStandardGuiItem::guiItem
KGuiItem guiItem(StandardItem ui_enum)
Returns the gui item for the given identifier.
Definition: kstandardguiitem.cpp:29
KStandardGuiItem::closeWindow
KGuiItem closeWindow()
Returns the 'CloseWindow' gui item.
Definition: kstandardguiitem.cpp:188
KStandardGuiItem::adminMode
KGuiItem adminMode()
Returns a KGuiItem suiting for cases where code or functionality runs under root privileges.
Definition: kstandardguiitem.cpp:161
This file is part of the KDE documentation.
Documentation copyright © 1996-2023 The KDE developers.
Generated on Mon Feb 20 2023 00:00:00 by doxygen 1.9.6 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.

KDEUI

Skip menu "KDEUI"
  • Main Page
  • Namespace List
  • Namespace Members
  • Alphabetical List
  • Class List
  • Class Hierarchy
  • Class Members
  • File List
  • File Members
  • Modules
  • Related Pages

kdelibs-4.14.38 API Reference

Skip menu "kdelibs-4.14.38 API Reference"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDEWebKit
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • kio
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • KPty
  • Kross
  • KUnitConversion
  • KUtils
  • Nepomuk
  • Plasma
  • Solid
  • Sonnet
  • ThreadWeaver
Report problems with this website to our bug tracking system.
Contact the specific authors with questions and comments about the page contents.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal