kdeui Library API Documentation

KStdGuiItem Class Reference

Provides a set of standardized KGuiItems. More...

#include <kstdguiitem.h>

List of all members.

Public Types

enum  BidiMode { UseRTL = 0, IgnoreRTL }
enum  StdItem {
  Ok = 1, Cancel, Yes, No,
  Discard, Save, DontSave, SaveAs,
  Apply, Clear, Help, Defaults,
  Close, Back, Forward, Print,
  Continue, Open, Quit, AdminMode,
  Reset, Delete, Insert, Configure,
  Find, Stop, Add, Remove,
  Test, Properties
}

Static Public Member Functions

static KGuiItem guiItem (StdItem ui_enum)
static QString stdItem (StdItem ui_enum)
static KGuiItem ok ()
static KGuiItem cancel ()
static KGuiItem yes ()
static KGuiItem no ()
static KGuiItem insert ()
static KGuiItem discard ()
static KGuiItem save ()
static KGuiItem help ()
static KGuiItem dontSave ()
static KGuiItem saveAs ()
static KGuiItem apply ()
static KGuiItem clear ()
static KGuiItem defaults ()
static KGuiItem close ()
static KGuiItem print ()
static KGuiItem properties ()
static KGuiItem reset ()
static KGuiItem adminMode ()
static KGuiItem cont ()
static KGuiItem del ()
static KGuiItem open ()
static KGuiItem back (BidiMode useBidi=IgnoreRTL)
static KGuiItem forward (BidiMode useBidi=IgnoreRTL)
static KGuiItem configure ()
static QPair< KGuiItem, KGuiItembackAndForward ()
static KGuiItem quit ()
static KGuiItem find ()
static KGuiItem stop ()
static KGuiItem add ()
static KGuiItem remove ()
static KGuiItem test ()


Detailed Description

Provides a set of standardized KGuiItems.

The various static methods returns standardized KGuiItem's conforming to the KDE UI Standards. Use them instead of creating your own.

Author:
Holger Freyther <freyther@kde.org>

Definition at line 37 of file kstdguiitem.h.


Member Enumeration Documentation

enum KStdGuiItem::BidiMode
 

The back and forward items by default use the RTL settings for Hebrew and Arab countries.

If you want those actions to ignore the RTL value and force 'Western' behavior instead, use the IgnoreRTL value instead.

Definition at line 45 of file kstdguiitem.h.

enum KStdGuiItem::StdItem
 

Enumerator:
Configure 
Since:
3.4
Find 
Since:
3.4
Stop 
Since:
3.4
Add 
Since:
3.4
Remove 
Since:
3.4
Test 
Since:
3.4
Properties 
Since:
3.4

Definition at line 47 of file kstdguiitem.h.


Member Function Documentation

KGuiItem KStdGuiItem::properties  )  [static]
 

Since:
3.4

Definition at line 275 of file kstdguiitem.cpp.

Referenced by guiItem().

KGuiItem KStdGuiItem::adminMode  )  [static]
 

Returns a KGuiItem suiting for cases where code or functionality runs under root privileges.

Used in conjunction with KConfig Modules.

Definition at line 149 of file kstdguiitem.cpp.

Referenced by guiItem().

KGuiItem KStdGuiItem::cont  )  [static]
 

Returns a "continue" item.

The short name is due to "continue" being a reserved word in the C++ language.

Definition at line 210 of file kstdguiitem.cpp.

Referenced by guiItem(), and KBugReport::slotCancel().

KGuiItem KStdGuiItem::del  )  [static]
 

Returns a "delete" item.

The short name is due to "delete" being a reserved word in the C++ language.

Since:
3.3

Definition at line 216 of file kstdguiitem.cpp.

Referenced by guiItem().

KGuiItem KStdGuiItem::back BidiMode  useBidi = IgnoreRTL  )  [static]
 

Return a GUI item for a 'back' action, like Konqueror's back button.

This GUI item can optionally honor the user's setting for BiDi, so the icon for right-to-left languages (Hebrew and Arab) has the arrow pointing in the opposite direction. By default the arrow points in the Western 'back' direction (i.e. to the left). This is because usually you only want the Bidi aware GUI item if you also want the 'forward' item. Those two are available in the separate backAndForward() method.

Definition at line 182 of file kstdguiitem.cpp.

References QApplication::reverseLayout().

Referenced by backAndForward(), guiItem(), KTipDialog::KTipDialog(), and KWizard::KWizard().

KGuiItem KStdGuiItem::forward BidiMode  useBidi = IgnoreRTL  )  [static]
 

Return a GUI item for a 'forward' action, like Konqueror's forward button.

This GUI item can optionally honor the user's setting for BiDi, so the icon for right-to-left languages (Hebrew and Arab) has the arrow pointing in the opposite direction. By default the arrow points in the Western 'forward' direction (i.e. to the right). This is because usually you only want the Bidi aware GUI item if you also want the 'back' item. Those two are available in the separate backAndForward() method.

Definition at line 190 of file kstdguiitem.cpp.

References QApplication::reverseLayout().

Referenced by backAndForward(), guiItem(), KTipDialog::KTipDialog(), and KWizard::KWizard().

KGuiItem KStdGuiItem::configure  )  [static]
 

Returns a "configure" item.

Since:
3.4

Definition at line 245 of file kstdguiitem.cpp.

QPair< KGuiItem, KGuiItem > KStdGuiItem::backAndForward  )  [static]
 

Return both a back and a forward item.

This function always returns items that are aware of the Right-to-Left setting for Arab and Hebrew locales. If you have a reason for wanting the 'Western' back/forward buttons, please use the back() and forward() items instead.

Definition at line 198 of file kstdguiitem.cpp.

References back(), and forward().

KGuiItem KStdGuiItem::find  )  [static]
 

Returns a "find" item.

Since:
3.4

Definition at line 250 of file kstdguiitem.cpp.

Referenced by guiItem().

KGuiItem KStdGuiItem::stop  )  [static]
 

Returns a "stop" item.

Since:
3.4

Definition at line 255 of file kstdguiitem.cpp.

Referenced by guiItem().

KGuiItem KStdGuiItem::add  )  [static]
 

Returns a "add" item.

Since:
3.4

Definition at line 260 of file kstdguiitem.cpp.

Referenced by guiItem().

KGuiItem KStdGuiItem::remove  )  [static]
 

Returns a "remove" item.

Since:
3.4

Definition at line 265 of file kstdguiitem.cpp.

Referenced by guiItem().

KGuiItem KStdGuiItem::test  )  [static]
 

Returns a "test" item.

Since:
3.4

Definition at line 270 of file kstdguiitem.cpp.

Referenced by guiItem().


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for kdeui Library Version 3.4.1.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Mon Jan 23 19:32:51 2006 by doxygen 1.4.3 written by Dimitri van Heesch, © 1997-2003