• Skip to content
  • Skip to link menu
Trinity API Reference
  • Trinity API Reference
  • tdeui
 

tdeui

Public Types | Public Slots | Signals | Public Member Functions | Static Public Member Functions | Protected Types | Protected Slots | Protected Member Functions | Protected Attributes | Friends | List of all members
KKeyChooser Class Reference

#include <kkeydialog.h>

Inherits TQWidget.

Public Types

enum  ActionType { Application, ApplicationGlobal, Standard, Global }
 

Public Slots

void allDefault ()
 
void setPreferFourModifierKeys (bool preferFourModifierKeys)
 
void listSync ()
 

Signals

void keyChange ()
 

Public Member Functions

 KKeyChooser (TQWidget *parent, ActionType type=Application, bool bAllowLetterShortcuts=true)
 
 KKeyChooser (TDEActionCollection *coll, TQWidget *parent, bool bAllowLetterShortcuts=true)
 
 KKeyChooser (TDEAccel *actions, TQWidget *parent, bool bAllowLetterShortcuts=true)
 
 KKeyChooser (TDEGlobalAccel *actions, TQWidget *parent)
 
 KKeyChooser (TDEShortcutList *, TQWidget *parent, ActionType type=Application, bool bAllowLetterShortcuts=true)
 
bool insert (TDEActionCollection *)
 
bool insert (TDEActionCollection *, const TQString &title)
 
void syncToConfig (const TQString &sConfigGroup, TDEConfigBase *pConfig, bool bClearUnset)
 
void commitChanges ()
 
void save ()
 
 KKeyChooser (TDEAccel *actions, TQWidget *parent, bool bCheckAgainstStdKeys, bool bAllowLetterShortcuts, bool bAllowWinKey=false)
 
 KKeyChooser (TDEGlobalAccel *actions, TQWidget *parent, bool bCheckAgainstStdKeys, bool bAllowLetterShortcuts, bool bAllowWinKey=false)
 

Static Public Member Functions

static bool checkGlobalShortcutsConflict (const TDEShortcut &cut, bool warnUser, TQWidget *parent)
 
static bool checkStandardShortcutsConflict (const TDEShortcut &cut, bool warnUser, TQWidget *parent)
 

Protected Types

enum  { NoKey = 1, DefaultKey, CustomKey }
 

Protected Slots

void slotNoKey ()
 
void slotDefaultKey ()
 
void slotCustomKey ()
 
void slotListItemSelected (TQListViewItem *item)
 
void capturedShortcut (const TDEShortcut &cut)
 
void slotSettingsChanged (int)
 
void slotListItemDoubleClicked (TQListViewItem *ipoQListViewItem, const TQPoint &ipoQPoint, int c)
 

Protected Member Functions

void initGUI (ActionType type, bool bAllowLetterShortcuts)
 
bool insert (TDEAccel *)
 
bool insert (TDEGlobalAccel *)
 
bool insert (TDEShortcutList *)
 
void buildListView (uint iList, const TQString &title=TQString::null)
 
void readGlobalKeys ()
 
void updateButtons ()
 
void fontChange (const TQFont &_font)
 
void setShortcut (const TDEShortcut &cut)
 
bool isKeyPresent (const TDEShortcut &cut, bool warnuser=true)
 
bool isKeyPresentLocally (const TDEShortcut &cut, KKeyChooserItem *ignoreItem, const TQString &warnText)
 
void _warning (const KKeySequence &seq, TQString sAction, TQString sTitle)
 
virtual void virtual_hook (int id, void *data)
 

Protected Attributes

ActionType m_type
 
bool m_bAllowLetterShortcuts
 
bool m_bAllowWinKey
 
bool m_bPreferFourModifierKeys
 
TQRadioButton * m_prbNone
 
TQRadioButton * m_prbDef
 
TQRadioButton * m_prbCustom
 

Friends

class KKeyDialog
 

Detailed Description

Widget for configuration of TDEAccel and TDEGlobalAccel.

Configure dictionaries of key/action associations for TDEAccel and TDEGlobalAccel.

The class takes care of all aspects of configuration, including handling key conflicts internally. Connect to the allDefault() slot if you want to set all configurable shortcuts to their default values.

See also
KKeyDialog
Author
Nicolas Hadacek hadac.nosp@m.ek@v.nosp@m.ia.ec.nosp@m.p.fr

Definition at line 58 of file kkeydialog.h.

Constructor & Destructor Documentation

KKeyChooser::KKeyChooser ( TQWidget *  parent,
ActionType  type = Application,
bool  bAllowLetterShortcuts = true 
)

Constructor.

Parameters
parentthe parent widget for this widget
typethe ActionType for this KKeyChooser
bAllowLetterShortcutsSet to false if unmodified alphanumeric keys ('A', '1', etc.) are not permissible shortcuts.

Definition at line 154 of file kkeydialog.cpp.

KKeyChooser::KKeyChooser ( TDEActionCollection *  coll,
TQWidget *  parent,
bool  bAllowLetterShortcuts = true 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Parameters
parentparent widget
collthe TDEActionCollection to configure
bAllowLetterShortcutsSet to false if unmodified alphanumeric keys ('A', '1', etc.) are not permissible shortcuts.

Definition at line 160 of file kkeydialog.cpp.

KKeyChooser::KKeyChooser ( TDEAccel *  actions,
TQWidget *  parent,
bool  bCheckAgainstStdKeys,
bool  bAllowLetterShortcuts,
bool  bAllowWinKey = false 
)
Deprecated:

Definition at line 188 of file kkeydialog.cpp.

KKeyChooser::KKeyChooser ( TDEGlobalAccel *  actions,
TQWidget *  parent,
bool  bCheckAgainstStdKeys,
bool  bAllowLetterShortcuts,
bool  bAllowWinKey = false 
)
Deprecated:

Definition at line 204 of file kkeydialog.cpp.

Member Function Documentation

void KKeyChooser::allDefault ( )
slot

Set all keys to their default values (bindings).

Definition at line 615 of file kkeydialog.cpp.

void KKeyChooser::buildListView ( uint  iList,
const TQString &  title = TQString::null 
)
protected
Since
3.1

Definition at line 461 of file kkeydialog.cpp.

bool KKeyChooser::checkGlobalShortcutsConflict ( const TDEShortcut &  cut,
bool  warnUser,
TQWidget *  parent 
)
static

Checks whether the given shortcut conflicts with global keyboard shortcuts.

If yes, and the warnUser argument is true, warns the user and gives them a chance to reassign the shortcut from the global shortcut.

Returns
true if there was conflict (and the user didn't reassign the shortcut)
Parameters
cutthe shortcut that will be checked for conflicts
warnUserif true, the user will be warned about a conflict and given a chance to reassign the shortcut
parentparent widget for the warning dialog
Since
3.2

Definition at line 849 of file kkeydialog.cpp.

bool KKeyChooser::checkStandardShortcutsConflict ( const TDEShortcut &  cut,
bool  warnUser,
TQWidget *  parent 
)
static

Checks whether the given shortcut conflicts with standard keyboard shortcuts.

If yes, and the warnUser argument is true, warns the user and gives them a chance to reassign the shortcut from the standard shortcut.

Returns
true if there was conflict (and the user didn't reassign the shortcut)
Parameters
cutthe shortcut that will be checked for conflicts
warnUserif true, the user will be warned about a conflict and given a chance to reassign the shortcut
parentparent widget for the warning dialog
Since
3.2

Definition at line 831 of file kkeydialog.cpp.

void KKeyChooser::commitChanges ( )

This function writes any shortcut changes back to the original action set(s).

Definition at line 273 of file kkeydialog.cpp.

bool KKeyChooser::insert ( TDEActionCollection *  pColl)

Insert an action collection, i.e.

add all its actions to the ones already associated with the KKeyChooser object.

Definition at line 233 of file kkeydialog.cpp.

bool KKeyChooser::insert ( TDEActionCollection *  pColl,
const TQString &  title 
)

Insert an action collection, i.e.

add all its actions to the ones already associated with the KKeyChooser object.

Parameters
titlesubtree title of this collection of shortcut.
Since
3.1

Definition at line 238 of file kkeydialog.cpp.

void KKeyChooser::keyChange ( )
signal

Emitted when an action's shortcut has been changed.

void KKeyChooser::listSync ( )
slot

Rebuild list entries based on underlying map.

Use this if you changed the underlying map.

Definition at line 662 of file kkeydialog.cpp.

void KKeyChooser::save ( )

This commits and then saves the actions to disk.

Any TDEActionCollection objects with the xmlFile() value set will be written to an XML file. All other will be written to the application's rc file.

Definition at line 285 of file kkeydialog.cpp.

void KKeyChooser::setPreferFourModifierKeys ( bool  preferFourModifierKeys)
slot

Specifies whether to use the 3 or 4 modifier key scheme.

This determines which default is used when the 'Default' button is clicked.

Definition at line 647 of file kkeydialog.cpp.


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

tdeui

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

tdeui

Skip menu "tdeui"
  • arts
  • dcop
  • dnssd
  • interfaces
  •   kspeech
  •     interface
  •     library
  •   tdetexteditor
  • kate
  • kded
  • kdoctools
  • kimgio
  • kjs
  • libtdemid
  • libtdescreensaver
  •     tdecore
  • tdeabc
  • tdecmshell
  • tdecore
  • tdefx
  • tdehtml
  • tdeinit
  • tdeio
  •   bookmarks
  •   httpfilter
  •   kpasswdserver
  •   kssl
  • tdeioslave
  •   http
  •   tdefile
  •   tdeio
  •   tdeioexec
  • tdemdi
  •   tdemdi
  • tdenewstuff
  • tdeparts
  • tdeprint
  • tderandr
  • tderesources
  • tdespell2
  • tdesu
  • tdeui
  • tdeunittest
  • tdeutils
  • tdewallet
Generated for tdeui by doxygen 1.8.8
This website is maintained by Timothy Pearson.