class KAccelMenu

Simplify the use of KAccel and KKeyDialog with menus. More...

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

Public Methods

Protected Methods

Protected Slots

Protected Members


Detailed Description

Simplify the use of KAccel and KKeyDialog with menus.

It also provides for the changing of menu item shortcuts by typing the key when the menu item is selected.

The exact method of setting shortcuts is the subject of some debate, currently the ' key will put up a message indicating the next key hit will change the shortcut. The Delete key removes the accelerator associated with the menu item.

Previously: The quote key was required only for keys that are used for menu accelerators.

Usage:


 keys = new KAccel(this);

 filemenu = new KAccelMenu(keys);
 filemenu->insItem(i18n("&Open"), "&Open", kp ,SLOT(fileOpen()),
                   KStdAccel::Open);
 filemenu->insItem(i18n("Open &URL"), "Open &URL", kp, SLOT(fileOpenUrl()),
                   "CTRL+X");

 keys->readSettings();

Calling the KKeyDialog:


 KKeyDialog::configureKeys( keys ); 

On exit you need:


 keys->writeSettings();

 KAccelMenu (KAccel *k, QWidget * parent=0, const char * name=0 )

KAccelMenu

KAccelMenu constructor.

Parameters:
kThe KAccel object associated with this menu

 ~KAccelMenu ()

~KAccelMenu

Destructor.

int  insItem (const QPixmap & pixmap, const char* text, const char * action, const QObject * receiver, const char * member, const char * accel = 0)

insItem

Insert a menu item with accelerator.

Parameters:
pixmapImage attached to menu item.
textThe interationalized version of the menu item text.
actionThe untranslated version of the menu item text.
receiverObject with action slot.
memberMenu item action slot.
accelThe accelerator in text format.

Returns: Id of the menu item.

int  insItem (const char* text, const char * action, const QObject * receiver, const char * member, const char * accel = 0)

insItem

Insert a menu item with accelerator.

Parameters:
textThe interationalized version of the menu item text.
actionThe untranslated version of the menu item text.
receiverObject with action slot.
memberMenu item action slot.
accelThe accelerator in text format.

Returns: Id of the menu item.

int  insItem ( const QPixmap & pixmap, const char * text, const char * action, const QObject * receiver, const char * member, KStdAccel::StdAccel accel )

insItem

Insert a menu item with a standard accelerator

Parameters:
pixmapImage attached to menu item.
textThe interationalized version of the menu item text.
actionThe untranslated version of the menu item text.
receiverObject with action slot.
memberMenu item action slot.
accelCode for a standard accelerator

Returns: Id of the menu item.

int  insItem ( const char * text, const char * action, const QObject * receiver, const char * member, KStdAccel::StdAccel accel )

insItem

Insert a menu item with a standard accelerator

Parameters:
textThe interationalized version of the menu item text.
actionThe untranslated version of the menu item text.
receiverObject with action slot.
memberMenu item action slot.
accelcode for a standard accelerator

Returns: Id of the menu item.

char * stripAnd (const char *str)

stripAnd

[protected]

void  keyPressEvent ( QKeyEvent * )

keyPressEvent

[protected]

Reimplemented from QPopupMenu.

void  popMsg ()

popMsg

[protected]

KAccel * keys

keys

[protected]

int cid

cid

[protected]

QIntDict actions

actions

[protected]

bool quote

quote

[protected]

void  highl (int)

highl

[protected slots slot]

void  aboutTS ()

aboutTS

[protected slots slot]


Generated by: dfaure on kde.faure.org on Thu Jan 17 22:16:05 2002, using kdoc 2.0a53.