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

kdeui

KKeyDialog Class Reference

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

#include <kkeydialog.h>

Inheritance diagram for KKeyDialog:

Inheritance graph
[legend]

List of all members.


Public Member Functions

void commitChanges ()
bool configure (bool bSaveSettings=true)
bool insert (KActionCollection *, const QString &title)
bool insert (KActionCollection *)
 KKeyDialog (bool bAllowLetterShortcuts=true, QWidget *parent=0, const char *name=0)
virtual ~KKeyDialog ()

Static Public Member Functions

static int configure (KGlobalAccel *keys, bool bAllowLetterShortcuts, QWidget *parent=0, bool bSaveSettings=true)
static int configure (KAccel *keys, bool bAllowLetterShortcuts, QWidget *parent=0, bool bSaveSettings=true)
static int configure (KActionCollection *coll, bool bAllowLetterShortcuts, QWidget *parent=0, bool bSaveSettings=true)
static int configure (KGlobalAccel *keys, QWidget *parent=0, bool bSaveSettings=true)
static int configure (KAccel *keys, QWidget *parent=0, bool bSaveSettings=true)
static int configure (KActionCollection *coll, QWidget *parent=0, bool bSaveSettings=true)
static KDE_DEPRECATED int configureKeys (KActionCollection *coll, const QString &, bool save_settings=true, QWidget *parent=0)
static KDE_DEPRECATED int configureKeys (KGlobalAccel *keys, bool save_settings=true, QWidget *parent=0)
static KDE_DEPRECATED int configureKeys (KAccel *keys, bool save_settings=true, QWidget *parent=0)

Protected Member Functions

virtual void virtual_hook (int id, void *data)

Detailed Description

Dialog for configuration of KActionCollection, KAccel, and KGlobalAccel.

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.

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

 KKeyDialog::configure( actionCollection() );

Author:
Nicolas Hadacek <hadacek@via.ecp.fr>

Definition at line 274 of file kkeydialog.h.


Constructor & Destructor Documentation

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

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.

Definition at line 1102 of file kkeydialog.cpp.

KKeyDialog::~KKeyDialog (  )  [virtual]

Destructor.

Deletes all resources used by a KKeyDialog object.

Definition at line 1114 of file kkeydialog.cpp.


Member Function Documentation

void KKeyDialog::commitChanges (  ) 

Commit key setting changes so that changed settings actually become active.

This method is implicitly called from configure(bool) if bSaveSettings is true.

Definition at line 1142 of file kkeydialog.cpp.

int KKeyDialog::configure ( KGlobalAccel *  keys,
bool  bAllowLetterShortcuts,
QWidget *  parent = 0,
bool  bSaveSettings = true 
) [static]

This is an overloaded member function, provided for convenience.

It behaves essentially like the above function.

Definition at line 1172 of file kkeydialog.cpp.

int KKeyDialog::configure ( KAccel *  keys,
bool  bAllowLetterShortcuts,
QWidget *  parent = 0,
bool  bSaveSettings = true 
) [static]

This is an overloaded member function, provided for convenience.

It behaves essentially like the above function.

Definition at line 1162 of file kkeydialog.cpp.

int KKeyDialog::configure ( KActionCollection *  coll,
bool  bAllowLetterShortcuts,
QWidget *  parent = 0,
bool  bSaveSettings = true 
) [static]

This is an overloaded member function, provided for convenience.

It behaves essentially like the above function.

Parameters:
coll the KActionCollection to configure
bAllowLetterShortcuts Set to false if unmodified alphanumeric keys ('A', '1', etc.) are not permissible shortcuts.
parent the parent widget to attach to
bSaveSettings if true, the settings will also be saved back to the *uirc file which they were intially read from.

Definition at line 1182 of file kkeydialog.cpp.

int KKeyDialog::configure ( KGlobalAccel *  keys,
QWidget *  parent = 0,
bool  bSaveSettings = true 
) [static]

This is an overloaded member function, provided for convenience.

It behaves essentially like the above function.

Definition at line 1157 of file kkeydialog.cpp.

int KKeyDialog::configure ( KAccel *  keys,
QWidget *  parent = 0,
bool  bSaveSettings = true 
) [static]

This is an overloaded member function, provided for convenience.

It behaves essentially like the above function, except that settings are saved to a *.rc file using KConfig.

Definition at line 1152 of file kkeydialog.cpp.

int KKeyDialog::configure ( KActionCollection *  coll,
QWidget *  parent = 0,
bool  bSaveSettings = true 
) [static]

Pops up a modal dialog for configuring key settings.

The new shortcut settings will be active if the user presses OK. If bSaveSettings if true, the settings will also be saved back to the *uirc file which they were intially read from.

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

Definition at line 1147 of file kkeydialog.cpp.

bool KKeyDialog::configure ( bool  bSaveSettings = true  ) 

Run the dialog and call commitChanges() if bSaveSettings is true.

Definition at line 1130 of file kkeydialog.cpp.

static KDE_DEPRECATED int KKeyDialog::configureKeys ( KActionCollection *  coll,
const QString &  ,
bool  save_settings = true,
QWidget *  parent = 0 
) [inline, static]

Deprecated:
Obsolete. Please use KKeyDialog::configure instead

Definition at line 392 of file kkeydialog.h.

static KDE_DEPRECATED int KKeyDialog::configureKeys ( KGlobalAccel *  keys,
bool  save_settings = true,
QWidget *  parent = 0 
) [inline, static]

Deprecated:
Obsolete. Please use KKeyDialog::configure instead

Definition at line 386 of file kkeydialog.h.

static KDE_DEPRECATED int KKeyDialog::configureKeys ( KAccel *  keys,
bool  save_settings = true,
QWidget *  parent = 0 
) [inline, static]

Deprecated:
Obsolete. Please use KKeyDialog::configure instead

Definition at line 380 of file kkeydialog.h.

bool KKeyDialog::insert ( KActionCollection *  pColl,
const QString &  title 
)

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.

Parameters:
title the title associated with the collection (if null, the KAboutData::progName() of the collection's instance is used)
Returns:
true :)
Since:
3.1

Definition at line 1125 of file kkeydialog.cpp.

bool KKeyDialog::insert ( KActionCollection *  pColl  ) 

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

Definition at line 1120 of file kkeydialog.cpp.

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

Reimplemented from KDialogBase.

Definition at line 1206 of file kkeydialog.cpp.


The documentation for this class was generated from the following files:
  • kkeydialog.h
  • kkeydialog.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