• Skip to content
  • Skip to link menu
KDE 3.5 API Reference
  • KDE API Reference
  • API Reference
  • Sitemap
  • Contact Us
 

kdeui

KRecentFilesAction Class Reference

Recent files action. More...

#include <kactionclasses.h>

Inheritance diagram for KRecentFilesAction:

Inheritance graph
[legend]

List of all members.


Public Slots

void addURL (const KURL &url, const QString &name)
void addURL (const KURL &url)
void clearURLList ()
void loadEntries (KConfig *config, QString groupname=QString::null)
void removeURL (const KURL &url)
void saveEntries (KConfig *config, QString groupname=QString::null)
void setMaxItems (uint maxItems)

Signals

void urlSelected (const KURL &url)

Public Member Functions

QStringList completeItems () const
virtual QStringList items () const
 KRecentFilesAction (QObject *parent=0, const char *name=0, uint maxItems=10)
 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 (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 (const QString &text, const QString &pix, const KShortcut &cut, QObject *parent, const char *name=0, uint maxItems=10)
 KRecentFilesAction (const QString &text, const QIconSet &pix, const KShortcut &cut, QObject *parent, const char *name=0, uint maxItems=10)
 KRecentFilesAction (const QString &text, const KShortcut &cut, const QObject *receiver, const char *slot, QObject *parent, const char *name=0, uint maxItems=10)
 KRecentFilesAction (const QString &text, const KShortcut &cut, QObject *parent, const char *name=0, uint maxItems=10)
uint maxItems () const
virtual int plug (QWidget *widget, int index=-1)
virtual ~KRecentFilesAction ()

Protected Slots

void itemSelected (const QString &string)
void menuAboutToShow ()
void menuItemActivated (int id)
virtual void slotActivated ()
virtual void slotActivated (const QString &)
virtual void slotActivated (int)
void slotClicked ()

Protected Member Functions

virtual void virtual_hook (int id, void *data)

Properties

uint maxItems

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.

Author:
Michael Koch

Definition at line 696 of file kactionclasses.h.


Constructor & Destructor Documentation

KRecentFilesAction::KRecentFilesAction ( const QString &  text,
const KShortcut &  cut,
QObject *  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 944 of file kactionclasses.cpp.

KRecentFilesAction::KRecentFilesAction ( const QString &  text,
const KShortcut &  cut,
const QObject *  receiver,
const char *  slot,
QObject *  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 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 956 of file kactionclasses.cpp.

KRecentFilesAction::KRecentFilesAction ( const QString &  text,
const QIconSet &  pix,
const KShortcut &  cut,
QObject *  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 974 of file kactionclasses.cpp.

KRecentFilesAction::KRecentFilesAction ( const QString &  text,
const QString &  pix,
const KShortcut &  cut,
QObject *  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 987 of file kactionclasses.cpp.

KRecentFilesAction::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 
)

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 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 1000 of file kactionclasses.cpp.

KRecentFilesAction::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 
)

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 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 1019 of file kactionclasses.cpp.

KRecentFilesAction::KRecentFilesAction ( QObject *  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 1038 of file kactionclasses.cpp.

KRecentFilesAction::~KRecentFilesAction (  )  [virtual]

Destructor.

Definition at line 1060 of file kactionclasses.cpp.


Member Function Documentation

void KRecentFilesAction::addURL ( const KURL &  url,
const QString &  name 
) [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 1099 of file kactionclasses.cpp.

void KRecentFilesAction::addURL ( const KURL &  url  )  [slot]

Add URL to recent files list.

Parameters:
url The URL of the file

Definition at line 1094 of file kactionclasses.cpp.

void KRecentFilesAction::clearURLList (  )  [slot]

Removes all entries from the recent files list.

Definition at line 1157 of file kactionclasses.cpp.

QStringList 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 1341 of file kactionclasses.cpp.

QStringList KRecentFilesAction::items (  )  const [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 1327 of file kactionclasses.cpp.

void KRecentFilesAction::itemSelected ( const QString &  string  )  [protected, slot]

Definition at line 1238 of file kactionclasses.cpp.

void KRecentFilesAction::loadEntries ( KConfig *  config,
QString  groupname = QString::null 
) [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 1164 of file kactionclasses.cpp.

uint KRecentFilesAction::maxItems (  )  const

Returns the maximum of items in the recent files list.

void KRecentFilesAction::menuAboutToShow (  )  [protected, slot]

Definition at line 1255 of file kactionclasses.cpp.

void KRecentFilesAction::menuItemActivated ( int  id  )  [protected, slot]

Definition at line 1246 of file kactionclasses.cpp.

int KRecentFilesAction::plug ( QWidget *  widget,
int  index = -1 
) [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 1266 of file kactionclasses.cpp.

void KRecentFilesAction::removeURL ( const KURL &  url  )  [slot]

Remove an URL from the recent files list.

Parameters:
url The URL of the file

Definition at line 1137 of file kactionclasses.cpp.

void KRecentFilesAction::saveEntries ( KConfig *  config,
QString  groupname = QString::null 
) [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 1209 of file kactionclasses.cpp.

void KRecentFilesAction::setMaxItems ( uint  maxItems  )  [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 1071 of file kactionclasses.cpp.

void KRecentFilesAction::slotActivated (  )  [protected, virtual, slot]

Reimplemented from KSelectAction.

Definition at line 1320 of file kactionclasses.cpp.

void KRecentFilesAction::slotActivated ( const QString &  text  )  [protected, virtual, slot]

Reimplemented from KSelectAction.

Definition at line 1308 of file kactionclasses.cpp.

void KRecentFilesAction::slotActivated ( int  id  )  [protected, virtual, slot]

Reimplemented from KSelectAction.

Definition at line 1314 of file kactionclasses.cpp.

void KRecentFilesAction::slotClicked (  )  [protected, slot]

Definition at line 1303 of file kactionclasses.cpp.

void KRecentFilesAction::urlSelected ( const KURL &  url  )  [signal]

This signal gets emited when the user selects an URL.

Parameters:
url The URL thats the user selected.

void KRecentFilesAction::virtual_hook ( int  id,
void *  data 
) [protected, virtual]

Reimplemented from KListAction.

Definition at line 2368 of file kactionclasses.cpp.


Property Documentation

uint KRecentFilesAction::maxItems [read, write]

Definition at line 699 of file kactionclasses.h.


The documentation for this class was generated from the following files:
  • kactionclasses.h
  • kactionclasses.cpp

kdeui

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

API Reference

Skip menu "API Reference"
  • dcop
  • DNSSD
  • interfaces
  • Kate
  • kconf_update
  • KDECore
  • KDED
  • kdefx
  • KDEsu
  • kdeui
  • KDocTools
  • KHTML
  • KImgIO
  • KInit
  • kio
  • kioslave
  • KJS
  • KNewStuff
  • KParts
  • KUtils
Generated for API Reference by doxygen 1.5.9
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal