#include <kactionclasses.h>

Public Slots | |
void | setMaxItems (uint maxItems) |
void | loadEntries (KConfig *config, TQString groupname=TQString::null) |
void | saveEntries (KConfig *config, TQString groupname=TQString::null) |
void | addURL (const KURL &url) |
void | addURL (const KURL &url, const TQString &name) |
void | removeURL (const KURL &url) |
void | clearURLList () |
![]() | |
virtual void | setCurrentItem (int index) |
![]() | |
virtual void | setCurrentItem (int index) |
virtual void | setItems (const TQStringList &lst) |
virtual void | clear () |
virtual void | setEditable (bool) |
virtual void | setComboWidth (int width) |
![]() | |
virtual void | setText (const TQString &text) |
virtual bool | setShortcut (const KShortcut &) |
virtual void | setGroup (const TQString &) |
virtual void | setWhatsThis (const TQString &text) |
virtual void | setToolTip (const TQString &) |
virtual void | setIconSet (const TQIconSet &iconSet) |
virtual void | setIcon (const TQString &icon) |
virtual void | setEnabled (bool enable) |
void | setDisabled (bool disable) |
virtual void | setShortcutConfigurable (bool) |
virtual void | activate () |
Signals | |
void | urlSelected (const KURL &url) |
![]() | |
void | activated (int index) |
void | activated (const TQString &text) |
![]() | |
void | activated () |
void | activated (KAction::ActivationReason reason, TQt::ButtonState state) |
void | enabled (bool) |
Public Member Functions | |
KRecentFilesAction (const TQString &text, const KShortcut &cut, TQObject *parent, const char *name=0, uint maxItems=10) | |
KRecentFilesAction (const TQString &text, const KShortcut &cut, const TQObject *receiver, const char *slot, TQObject *parent, const char *name=0, uint maxItems=10) | |
KRecentFilesAction (const TQString &text, const TQIconSet &pix, const KShortcut &cut, TQObject *parent, const char *name=0, uint maxItems=10) | |
KRecentFilesAction (const TQString &text, const TQString &pix, const KShortcut &cut, TQObject *parent, const char *name=0, uint maxItems=10) | |
KRecentFilesAction (const TQString &text, const TQIconSet &pix, const KShortcut &cut, const TQObject *receiver, const char *slot, TQObject *parent, const char *name=0, uint maxItems=10) | |
KRecentFilesAction (const TQString &text, const TQString &pix, const KShortcut &cut, const TQObject *receiver, const char *slot, TQObject *parent, const char *name=0, uint maxItems=10) | |
KRecentFilesAction (TQObject *parent=0, const char *name=0, uint maxItems=10) | |
virtual | ~KRecentFilesAction () |
virtual int | plug (TQWidget *widget, int index=-1) |
uint | maxItems () const |
virtual TQStringList | items () const |
TQStringList | completeItems () const |
![]() | |
KListAction (const TQString &text, const KShortcut &cut=KShortcut(), TQObject *parent=0, const char *name=0) | |
KListAction (const TQString &text, const KShortcut &cut, const TQObject *receiver, const char *slot, TQObject *parent, const char *name=0) | |
KListAction (const TQString &text, const TQIconSet &pix, const KShortcut &cut=KShortcut(), TQObject *parent=0, const char *name=0) | |
KListAction (const TQString &text, const TQString &pix, const KShortcut &cut=KShortcut(), TQObject *parent=0, const char *name=0) | |
KListAction (const TQString &text, const TQIconSet &pix, const KShortcut &cut, const TQObject *receiver, const char *slot, TQObject *parent, const char *name=0) | |
KListAction (const TQString &text, const TQString &pix, const KShortcut &cut, const TQObject *receiver, const char *slot, TQObject *parent, const char *name=0) | |
KListAction (TQObject *parent=0, const char *name=0) | |
virtual | ~KListAction () |
virtual TQString | currentText () const |
virtual int | currentItem () const |
![]() | |
KSelectAction (const TQString &text, const KShortcut &cut=KShortcut(), TQObject *parent=0, const char *name=0) | |
KSelectAction (const TQString &text, const KShortcut &cut, const TQObject *receiver, const char *slot, TQObject *parent, const char *name=0) | |
KSelectAction (const TQString &text, const TQIconSet &pix, const KShortcut &cut=KShortcut(), TQObject *parent=0, const char *name=0) | |
KSelectAction (const TQString &text, const TQString &pix, const KShortcut &cut=KShortcut(), TQObject *parent=0, const char *name=0) | |
KSelectAction (const TQString &text, const TQIconSet &pix, const KShortcut &cut, const TQObject *receiver, const char *slot, TQObject *parent, const char *name=0) | |
KSelectAction (const TQString &text, const TQString &pix, const KShortcut &cut, const TQObject *receiver, const char *slot, TQObject *parent, const char *name=0) | |
KSelectAction (TQObject *parent=0, const char *name=0) | |
virtual | ~KSelectAction () |
virtual bool | isEditable () const |
virtual void | changeItem (int index, const TQString &text) |
virtual int | comboWidth () const |
void | setMaxComboViewCount (int n) |
TQPopupMenu * | popupMenu () const |
void | setRemoveAmpersandsInCombo (bool b) KDE_DEPRECATED |
bool | removeAmpersandsInCombo () const |
void | setMenuAccelsEnabled (bool b) |
bool | menuAccelsEnabled () const |
virtual bool | isShortcutConfigurable () const |
![]() | |
KAction (const TQString &text, const KShortcut &cut, const TQObject *receiver, const char *slot, KActionCollection *parent, const char *name) | |
KAction (const TQString &text, const TQIconSet &pix, const KShortcut &cut, const TQObject *receiver, const char *slot, KActionCollection *parent, const char *name) | |
KAction (const TQString &text, const TQString &pix, const KShortcut &cut, const TQObject *receiver, const char *slot, KActionCollection *parent, const char *name) | |
KAction (const KGuiItem &item, const KShortcut &cut, const TQObject *receiver, const char *slot, KActionCollection *parent, const char *name) | |
KAction (const TQString &text, const KShortcut &cut=KShortcut(), TQObject *parent=0, const char *name=0) | |
KAction (const TQString &text, const KShortcut &cut, const TQObject *receiver, const char *slot, TQObject *parent, const char *name=0) | |
KAction (const TQString &text, const TQIconSet &pix, const KShortcut &cut=KShortcut(), TQObject *parent=0, const char *name=0) | |
KAction (const TQString &text, const TQString &pix, const KShortcut &cut=KShortcut(), TQObject *parent=0, const char *name=0) | |
KAction (const TQString &text, const TQIconSet &pix, const KShortcut &cut, const TQObject *receiver, const char *slot, TQObject *parent, const char *name=0) | |
KAction (const TQString &text, const TQString &pix, const KShortcut &cut, const TQObject *receiver, const char *slot, TQObject *parent, const char *name=0) | |
KAction (TQObject *parent=0, const char *name=0) | |
virtual | ~KAction () |
virtual void | plugAccel (KAccel *accel, bool configurable=true) KDE_DEPRECATED |
virtual void | unplug (TQWidget *w) |
virtual void | unplugAccel () KDE_DEPRECATED |
virtual bool | isPlugged () const |
bool | isPlugged (const TQWidget *container) const |
virtual bool | isPlugged (const TQWidget *container, int id) const |
virtual bool | isPlugged (const TQWidget *container, const TQWidget *_representative) const |
TQWidget * | container (int index) const |
int | itemId (int index) const |
TQWidget * | representative (int index) const |
int | containerCount () const |
uint | kaccelCount () const |
virtual bool | hasIcon () const |
bool | hasIconSet () const |
virtual TQString | plainText () const |
virtual TQString | text () const |
virtual const KShortcut & | shortcut () const |
virtual const KShortcut & | shortcutDefault () const |
TQString | shortcutText () const |
void | setShortcutText (const TQString &) |
virtual bool | isEnabled () const |
virtual TQString | group () const |
virtual TQString | whatsThis () const |
virtual TQString | toolTip () const |
virtual TQIconSet | iconSet (KIcon::Group group, int size=0) const |
TQIconSet | iconSet () const |
virtual TQString | icon () const |
KActionCollection * | parentCollection () const |
void | unplugAll () |
int | accel () const KDE_DEPRECATED |
TQString | statusText () const |
void | setAccel (int key) KDE_DEPRECATED |
void | setStatusText (const TQString &text) |
int | menuId (int i) |
Protected Slots | |
void | itemSelected (const TQString &string) |
void | menuAboutToShow () |
void | menuItemActivated (int id) |
void | slotClicked () |
virtual void | slotActivated (int) |
virtual void | slotActivated (const TQString &) |
virtual void | slotActivated () |
![]() | |
virtual void | slotActivated (int id) |
virtual void | slotActivated (const TQString &text) |
virtual void | slotActivated () |
![]() | |
virtual void | slotDestroyed () |
virtual void | slotKeycodeChanged () |
virtual void | slotActivated () |
void | slotPopupActivated () |
void | slotButtonClicked (int, TQt::ButtonState state) |
Protected Member Functions | |
virtual void | virtual_hook (int id, void *data) |
![]() | |
virtual void | changeItem (int id, int index, const TQString &text) |
TQStringList | comboItems () const |
virtual void | updateCurrentItem (int id) |
virtual void | updateComboWidth (int id) |
virtual void | updateItems (int id) |
virtual void | updateClear (int id) |
![]() | |
KToolBar * | toolBar (int index) const |
TQPopupMenu * | popupMenu (int index) const |
void | removeContainer (int index) |
int | findContainer (const TQWidget *widget) const |
int | findContainer (int id) const |
void | plugMainWindowAccel (TQWidget *w) |
void | addContainer (TQWidget *parent, int id) |
void | addContainer (TQWidget *parent, TQWidget *representative) |
virtual void | updateShortcut (int i) |
virtual void | updateShortcut (TQPopupMenu *menu, int id) |
virtual void | updateGroup (int id) |
virtual void | updateText (int i) |
virtual void | updateEnabled (int i) |
virtual void | updateIconSet (int i) |
virtual void | updateIcon (int i) |
virtual void | updateToolTip (int id) |
virtual void | updateWhatsThis (int i) |
TQString | whatsThisWithIcon () const |
const KGuiItem & | guiItem () const |
Additional Inherited Members | |
![]() | |
enum | ActivationReason { UnknownActivation, EmulatedActivation, AccelActivation, PopupMenuActivation, ToolBarActivation } |
![]() | |
static int | getToolButtonID () |
![]() | |
KActionCollection * | m_parentCollection |
Detailed Description
Recent files action.
This class is an action to handle a recent files submenu. The best way to create the action is to use KStdAction::openRecent. Then you simply need to call loadEntries on startup, saveEntries on shutdown, addURL when your application loads/saves a file.
Definition at line 700 of file kactionclasses.h.
Constructor & Destructor Documentation
KRecentFilesAction::KRecentFilesAction | ( | const TQString & | text, |
const KShortcut & | cut, | ||
TQObject * | parent, | ||
const char * | name = 0 , |
||
uint | maxItems = 10 |
||
) |
- Parameters
-
text The text that will be displayed. cut The corresponding keyboard accelerator (shortcut). parent This action's parent. name An internal name for this action. maxItems The maximum number of files to display
Definition at line 947 of file kactionclasses.cpp.
KRecentFilesAction::KRecentFilesAction | ( | const TQString & | text, |
const KShortcut & | cut, | ||
const TQObject * | receiver, | ||
const char * | slot, | ||
TQObject * | parent, | ||
const char * | name = 0 , |
||
uint | maxItems = 10 |
||
) |
- Parameters
-
text The text that will be displayed. cut The corresponding keyboard accelerator (shortcut). receiver The SLOT's parent. slot The TQT_SLOT to invoke when a URL is selected. Its signature is of the form slotURLSelected( const KURL & ). parent This action's parent. name An internal name for this action. maxItems The maximum number of files to display
Definition at line 959 of file kactionclasses.cpp.
KRecentFilesAction::KRecentFilesAction | ( | const TQString & | text, |
const TQIconSet & | pix, | ||
const KShortcut & | cut, | ||
TQObject * | parent, | ||
const char * | name = 0 , |
||
uint | maxItems = 10 |
||
) |
- Parameters
-
text The text that will be displayed. pix The icons that go with this action. cut The corresponding keyboard accelerator (shortcut). parent This action's parent. name An internal name for this action. maxItems The maximum number of files to display
Definition at line 977 of file kactionclasses.cpp.
KRecentFilesAction::KRecentFilesAction | ( | const TQString & | text, |
const TQString & | pix, | ||
const KShortcut & | cut, | ||
TQObject * | parent, | ||
const char * | name = 0 , |
||
uint | maxItems = 10 |
||
) |
- Parameters
-
text The text that will be displayed. pix The dynamically loaded icon that goes with this action. cut The corresponding keyboard accelerator (shortcut). parent This action's parent. name An internal name for this action. maxItems The maximum number of files to display
Definition at line 990 of file kactionclasses.cpp.
KRecentFilesAction::KRecentFilesAction | ( | const TQString & | text, |
const TQIconSet & | pix, | ||
const KShortcut & | cut, | ||
const TQObject * | receiver, | ||
const char * | slot, | ||
TQObject * | parent, | ||
const char * | name = 0 , |
||
uint | maxItems = 10 |
||
) |
- Parameters
-
text The text that will be displayed. pix The icons that go with this action. cut The corresponding keyboard accelerator (shortcut). receiver The SLOT's parent. slot The TQT_SLOT to invoke when a URL is selected. Its signature is of the form slotURLSelected( const KURL & ). parent This action's parent. name An internal name for this action. maxItems The maximum number of files to display
Definition at line 1003 of file kactionclasses.cpp.
KRecentFilesAction::KRecentFilesAction | ( | const TQString & | text, |
const TQString & | pix, | ||
const KShortcut & | cut, | ||
const TQObject * | receiver, | ||
const char * | slot, | ||
TQObject * | parent, | ||
const char * | name = 0 , |
||
uint | maxItems = 10 |
||
) |
- Parameters
-
text The text that will be displayed. pix The dynamically loaded icon that goes with this action. cut The corresponding keyboard accelerator (shortcut). receiver The SLOT's parent. slot The TQT_SLOT to invoke when a URL is selected. Its signature is of the form slotURLSelected( const KURL & ). parent This action's parent. name An internal name for this action. maxItems The maximum number of files to display
Definition at line 1022 of file kactionclasses.cpp.
KRecentFilesAction::KRecentFilesAction | ( | TQObject * | parent = 0 , |
const char * | name = 0 , |
||
uint | maxItems = 10 |
||
) |
- Parameters
-
parent This action's parent. name An internal name for this action. maxItems The maximum number of files to display
Definition at line 1041 of file kactionclasses.cpp.
|
virtual |
Destructor.
Definition at line 1063 of file kactionclasses.cpp.
Member Function Documentation
|
slot |
Add URL to recent files list.
- Parameters
-
url The URL of the file
Definition at line 1097 of file kactionclasses.cpp.
|
slot |
Add URL to recent files list.
- Parameters
-
url The URL of the file name The user visible pretty name that appears before the URL
- Since
- 3.5
Definition at line 1102 of file kactionclasses.cpp.
|
slot |
Removes all entries from the recent files list.
Definition at line 1160 of file kactionclasses.cpp.
TQStringList KRecentFilesAction::completeItems | ( | ) | const |
- Returns
- the items that can be selected with this action. The returned items contain the pretty name that can be set by addURL.
- Since
- 3.5
Definition at line 1344 of file kactionclasses.cpp.
|
virtual |
- Returns
- the items that can be selected with this action. The returned items do not contain the pretty name that can be set by addURL, matching the pre-3.5 behavior.
Reimplemented from KSelectAction.
Definition at line 1330 of file kactionclasses.cpp.
|
slot |
Loads the recent files entries from a given KConfig object.
You can provide the name of the group used to load the entries. If the groupname is empty, entries are load from a group called 'RecentFiles'
This method does not effect the active group of KConfig.
Definition at line 1167 of file kactionclasses.cpp.
uint KRecentFilesAction::maxItems | ( | ) | const |
Returns the maximum of items in the recent files list.
|
virtual |
"Plug" or insert this action into a given widget.
This will typically be a menu or a toolbar. From this point on, you will never need to directly manipulate the item in the menu or toolbar. You do all enabling/disabling/manipulation directly with your KSelectAction object.
- Parameters
-
widget The GUI element to display this action. index The index of the item.
Reimplemented from KSelectAction.
Definition at line 1269 of file kactionclasses.cpp.
|
slot |
Remove an URL from the recent files list.
- Parameters
-
url The URL of the file
Definition at line 1140 of file kactionclasses.cpp.
|
slot |
Saves the current recent files entries to a given KConfig object.
You can provide the name of the group used to load the entries. If the groupname is empty, entries are saved to a group called 'RecentFiles'
This method does not effect the active group of KConfig.
Definition at line 1212 of file kactionclasses.cpp.
|
slot |
Sets the maximum of items in the recent files list.
The default for this value is 10 set in the constructor.
If this value is lesser than the number of items currently in the recent files list the last items are deleted until the number of items are equal to the new maximum.
Definition at line 1074 of file kactionclasses.cpp.
|
signal |
This signal gets emited when the user selects an URL.
- Parameters
-
url The URL thats the user selected.
The documentation for this class was generated from the following files: