class KRecentFilesAction

Recent files action. More...

Definition#include <kaction.h>
InheritsKListAction [public ]
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

Public Methods

Public Slots

Signals

Protected Methods

Protected Slots


Detailed Description

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.

 KRecentFilesAction ( const QString& text, const KShortcut& cut, QObject* parent, const char* name = 0, uint maxItems = 10 )

KRecentFilesAction

Parameters:
textThe text that will be displayed.
accelThe corresponding keyboard accelerator (shortcut).
parentThis action's parent.
nameAn internal name for this action.
maxItemsThe maximum number of files to display

 KRecentFilesAction ( const QString& text, const KShortcut& cut, const QObject* receiver, const char* slot, QObject* parent, const char* name = 0, uint maxItems = 10 )

KRecentFilesAction

Parameters:
textThe text that will be displayed.
accelThe corresponding keyboard accelerator (shortcut).
receiverThe SLOT's parent.
slotThe SLOT to invoke when a URL is selected. Its signature is of the form slotURLSelected( const KURL & ).
parentThis action's parent.
nameAn internal name for this action.
maxItemsThe maximum number of files to display

 KRecentFilesAction ( const QString& text, const QIconSet& pix, const KShortcut& cut, QObject* parent, const char* name = 0, uint maxItems = 10 )

KRecentFilesAction

Parameters:
textThe text that will be displayed.
pixThe icons that go with this action.
accelThe corresponding keyboard accelerator (shortcut).
parentThis action's parent.
nameAn internal name for this action.
maxItemsThe maximum number of files to display

 KRecentFilesAction ( const QString& text, const QString& pix, const KShortcut& cut, QObject* parent, const char* name = 0, uint maxItems = 10 )

KRecentFilesAction

Parameters:
textThe text that will be displayed.
pixThe dynamically loaded icon that goes with this action.
accelThe corresponding keyboard accelerator (shortcut).
parentThis action's parent.
nameAn internal name for this action.
maxItemsThe maximum number of files to display

 KRecentFilesAction ( const QString& text, const QIconSet& pix, const KShortcut& cut, const QObject* receiver, const char* slot, QObject* parent, const char* name = 0, uint maxItems = 10 )

KRecentFilesAction

Parameters:
textThe text that will be displayed.
pixThe icons that go with this action.
accelThe corresponding keyboard accelerator (shortcut).
receiverThe SLOT's parent.
slotThe SLOT to invoke when a URL is selected. Its signature is of the form slotURLSelected( const KURL & ).
parentThis action's parent.
nameAn internal name for this action.
maxItemsThe maximum number of files to display

 KRecentFilesAction ( const QString& text, const QString& pix, const KShortcut& cut, const QObject* receiver, const char* slot, QObject* parent, const char* name = 0, uint maxItems = 10 )

KRecentFilesAction

Parameters:
textThe text that will be displayed.
pixThe dynamically loaded icon that goes with this action.
accelThe corresponding keyboard accelerator (shortcut).
receiverThe SLOT's parent.
slotThe SLOT to invoke when a URL is selected. Its signature is of the form slotURLSelected( const KURL & ).
parentThis action's parent.
nameAn internal name for this action.
maxItemsThe maximum number of files to display

 KRecentFilesAction ( QObject* parent = 0, const char* name = 0, uint maxItems = 10 )

KRecentFilesAction

Parameters:
parentThis action's parent.
nameAn internal name for this action.
maxItemsThe maximum number of files to display

 ~KRecentFilesAction ()

~KRecentFilesAction

[virtual]

Destructor.

uint  maxItems ()

maxItems

[const]

Returns the maximum of items in the recent files list.

void  setMaxItems ( uint maxItems )

setMaxItems

[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.

void  loadEntries ( KConfig* config, QString groupname=QString::null )

loadEntries

[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.

void  saveEntries ( KConfig* config, QString groupname=QString::null )

saveEntries

[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.

void  addURL ( const KURL& url )

addURL

[slot]

Add URL to recent files list.

Parameters:
urlThe URL of the file

void  removeURL ( const KURL& url )

removeURL

[slot]

Remove an URL from the recent files list.

Parameters:
urlThe URL of the file

void  clearURLList ()

clearURLList

[slot]

Removes all entries from the recent files list.

void  urlSelected ( const KURL& url )

urlSelected

[signal]

This signal gets emited when the user selects an URL.

Parameters:
urlThe URL thats the user selected.

void  itemSelected ( const QString& string )

itemSelected

[protected slots slot]

void  virtual_hook ( int id, void* data )

virtual_hook

[protected virtual]

Reimplemented from KListAction.