class KKeyDialog

Dialog for configuration of KActioncollection, KAccel, and KGlobalAccel. More...

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

Public Methods

Public Static Methods

Protected Methods


Detailed Description

The KKeyDialog class is used for configuring dictionaries of key/action associations for KActionCollection, KAccel, and KGlobalAccel. It uses the KKeyChooser widget and offers buttons to set all keys to defaults and invoke on-line help.

Three static methods are supplied which provide the most convienient interface to the dialog. The most common and most encouraged use is with KActionCollection.


 KKeyDialog::configure( actionCollection() );

 KKeyDialog ( bool bAllowLetterShortcuts = true, QWidget* parent = 0, const char* name = 0 )

KKeyDialog

Constructs a KKeyDialog called name as a child of parent. Set bAllowLetterShortcuts to false if unmodified alphanumeric keys ('A', '1', etc.) are not permissible shortcuts.

 ~KKeyDialog ()

~KKeyDialog

[virtual]

Destructor. Deletes all resources used by a KKeyDialog object.

bool  insert ( KActionCollection* )

insert

Insert an action collection, i.e. add all its actions to the ones displayed by the dialog. This method can be useful in applications following the document/view design, with actions in both the document and the view. Simply call insert with the action collections of each one in turn.

Returns: true :)

bool  configure ( bool bSaveSettings = true )

configure

void  commitChanges ()

commitChanges

Commit key setting changes so that changed settings actually become active. This method is implicitly called from KKeyConfig::configure if bSaveSettings is true.

int  configure ( KAccel* keys, QWidget* parent = 0, bool bSaveSettings = true )

configure

[static]

Pops up a modal dialog for configuring key settings. The dialog is initialized from a KAccelBase object, and the modifications are written to that object when the dialog is closed.

Returns: Accept if the dialog was closed with OK, Reject otherwise.

int  configure ( KGlobalAccel* keys, QWidget* parent = 0, bool bSaveSettings = true )

configure

[static]

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

int  configure ( KActionCollection* coll, QWidget* parent = 0, bool bSaveSettings = true )

configure

[static]

This is an overloaded member function, provided for convenience. It behaves essentially like the above function. The dialog is initialized from an action collection (for XMLGUI based applications).

int  configureKeys ( KAccel* keys, bool save_settings = true, QWidget* parent = 0 )

configureKeys

[static]

Please use KKeyDialog::configure instead

int  configureKeys ( KGlobalAccel* keys, bool save_settings = true, QWidget* parent = 0 )

configureKeys

[static]

Please use KKeyDialog::configure instead

int  configureKeys ( KActionCollection* coll, const QString& , bool save_settings = true, QWidget* parent = 0 )

configureKeys

[static]

Please use KKeyDialog::configure instead

void  virtual_hook ( int id, void* data )

virtual_hook

[protected virtual]

Reimplemented from KDialogBase.