kdeui/util/kstandardguiitem.cpp

   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
  26 namespace KStandardGuiItem
  27 {
  28
  29 KGuiItem 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
  69 QString 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
 107 KGuiItem ok()
 108 {
 109   return KGuiItem( i18n( "&OK" ), "dialog-ok" );
 110 }
 111
 112
 113 KGuiItem cancel()
 114 {
 115   return KGuiItem( i18n( "&Cancel" ), "dialog-cancel" );
 116 }
 117
 118 KGuiItem yes()
 119 {
 120   return KGuiItem( i18n( "&Yes" ), "dialog-ok", i18n( "Yes" ) );
 121 }
 122
 123 KGuiItem no()
 124 {
 125   return KGuiItem( i18n( "&No" ), "process-stop", i18n( "No" ) );
 126 }
 127
 128 KGuiItem discard()
 129 {
 130   return KGuiItem( i18n( "&Discard" ), "", i18n( "Discard changes" ),
 131                    i18n( "Pressing this button will discard all recent "
 132                          "changes made in this dialog" ) );
 133 }
 134
 135 KGuiItem save()
 136 {
 137   return KGuiItem( i18n( "&Save" ), "document-save", i18n( "Save data" ) );
 138 }
 139
 140 KGuiItem dontSave()
 141 {
 142   return KGuiItem( i18n( "&Do Not Save" ), "",
 143                    i18n( "Do not save data" ) );
 144 }
 145
 146 KGuiItem saveAs()
 147 {
 148   return KGuiItem( i18n( "Save &As..." ), "document-save-as",
 149                    i18n( "Save file with another name" ) );
 150 }
 151
 152 KGuiItem apply()
 153 {
 154   return KGuiItem( i18n( "&Apply" ), "dialog-ok-apply", i18n( "Apply changes" ),
 155                    i18n( "When clicking <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
 161 KGuiItem adminMode()
 162 {
 163   return KGuiItem( i18n( "Administrator &Mode..." ), "", i18n( "Enter Administrator Mode" ),
 164                    i18n( "When clicking <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
 169 KGuiItem 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
 176 KGuiItem help()
 177 {
 178   return KGuiItem( i18nc( "show help", "&Help" ), "help-contents",
 179                    i18n( "Show help" ) );
 180 }
 181
 182 KGuiItem close()
 183 {
 184   return KGuiItem( i18n( "&Close" ), "window-close",
 185                    i18n( "Close the current window or document" ) );
 186 }
 187
 188 KGuiItem closeWindow()
 189 {
 190   return KGuiItem( i18n( "&Close Window" ), "window-close",
 191                    i18n( "Close the current window." ) );
 192 }
 193
 194 KGuiItem closeDocument()
 195 {
 196   return KGuiItem( i18n( "&Close Document" ), "document-close",
 197                    i18n( "Close the current document." ) );
 198 }
 199
 200 KGuiItem defaults()
 201 {
 202   return KGuiItem( i18n( "&Defaults" ), "document-revert",
 203                    i18n( "Reset all items to their default values" ) );
 204 }
 205
 206 KGuiItem 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
 214 KGuiItem 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
 222 QPair<KGuiItem, KGuiItem> backAndForward()
 223 {
 224   return qMakePair( back( UseRTL ), forward( UseRTL ) );
 225 }
 226
 227 KGuiItem print()
 228 {
 229   return KGuiItem( i18n( "&Print..." ), "document-print",
 230                    i18n( "Opens the print dialog to print "
 231                          "the current document" ) );
 232 }
 233
 234 KGuiItem cont()
 235 {
 236   return KGuiItem( i18n( "C&ontinue" ), QString(),
 237                    i18n( "Continue operation" ) );
 238 }
 239
 240 KGuiItem del()
 241 {
 242   return KGuiItem( i18n( "&Delete" ), "edit-delete",
 243                    i18n( "Delete item(s)" ) );
 244 }
 245
 246 KGuiItem open()
 247 {
 248   return KGuiItem( i18n( "&Open..." ), "document-open",
 249                    i18n( "Open file" ) );
 250 }
 251
 252 KGuiItem quit()
 253 {
 254   return KGuiItem( i18n( "&Quit" ), "application-exit",
 255                    i18n( "Quit application" ) );
 256 }
 257
 258 KGuiItem reset()
 259 {
 260   return KGuiItem( i18n( "&Reset" ), "edit-undo",
 261                   i18n( "Reset configuration" ) );
 262 }
 263
 264 KGuiItem insert()
 265 {
 266   return KGuiItem( i18nc( "Verb", "&Insert" ) );
 267 }
 268
 269 KGuiItem configure()
 270 {
 271   return KGuiItem( i18n( "Confi&gure..." ), "configure" );
 272 }
 273
 274 KGuiItem find()
 275 {
 276   return KGuiItem(i18n("&Find"), "edit-find");
 277 }
 278
 279 KGuiItem stop()
 280 {
 281   return KGuiItem(i18n("Stop"), "process-stop");
 282 }
 283
 284 KGuiItem add()
 285 {
 286   return KGuiItem(i18n("Add"), "list-add");
 287 }
 288
 289 KGuiItem remove()
 290 {
 291   return KGuiItem(i18n("Remove"), "list-remove");
 292 }
 293
 294 KGuiItem test()
 295 {
 296   return KGuiItem(i18n("Test"));
 297 }
 298
 299 KGuiItem properties()
 300 {
 301   return KGuiItem(i18n("Properties"), "document-properties");
 302 }
 303
 304 KGuiItem overwrite()
 305 {
 306   return KGuiItem(i18n("&Overwrite"));
 307 }
 308
 309 } // KStandardGuiItem namespace
 310