KDE PIM / Developers / API Docs / karm

KAccelMenuWatch Class Reference

Easy updating of menu accels when changing a KAccel object. More...

#include <kaccelmenuwatch.h>

Inherits QObject.

List of all members.

Public Slots

Public Member Functions


Detailed Description

Easy updating of menu accels when changing a KAccel object.

Since a KAccel object does not keep track of menu items to which it is connected, we normally have to manually call KAccel::changeMenuAccel() again for each update of the KAccel object.

With KAccelMenuWatch you provide the kaccel object and the menu items to which it connects, and if you update the kaccel you just have to call KAccelMenuWatch::updateMenus() and the menu items will be updated.

It is safe to delete menus that have connections handled by this class. On deletion of a menu, all associated accelerators will be deleted.

Note that you _have_ to call KAccelMenuWatch::updateMenus() after you connect the * accelerators, as they are not activated till then.

Author:
Sirtaj Singh Kang (taj@kde.org)


Constructor & Destructor Documentation

KAccelMenuWatch::KAccelMenuWatch KAccel *  accel,
QObject *  parent = 0
 

KAccelMenuWatch Constructor.

virtual KAccelMenuWatch::~KAccelMenuWatch  )  [inline, virtual]
 

KAccelMenuWatch Destructor.


Member Function Documentation

void KAccelMenuWatch::setMenu QPopupMenu *  menu  ) 
 

Set the menu on which connectAccel calls will operate.

All subsequent calls to connectAccel will be associated with this menu. You can call this function any number of times, so multiple menus can be handled.

QPopupMenu* KAccelMenuWatch::currentMenu  )  const [inline]
 

Return the last menu set with KAccelMenuWatch::setMenu(QPopupMenu*), or 0 if none has been set.

void KAccelMenuWatch::connectAccel int  itemId,
const char *  action
 

Connect the menu item identified to currentMenu()/id to the accelerator action.

void KAccelMenuWatch::connectAccel int  itemId,
KStdAccel::StdAccel 
 

Same as above, but connects to standard accelerators.

void KAccelMenuWatch::updateMenus  )  [slot]
 

Updates all menu accelerators.

Call this after all accelerators have been connected or the kaccel object has been updated.


The documentation for this class was generated from the following files: