#include <kglobalaccel.h>

Inherits TQObject.

Public Member Functions
	TDEGlobalAccel (TQObject pParent, const char psName=0)

bool	isEnabled ()

void	setEnabled (bool bEnabled)

TDEAccelAction *	insert (const TQString &sAction, const TQString &sLabel, const TQString &sWhatsThis, const TDEShortcut &cutDef3, const TDEShortcut &cutDef4, const TQObject pObjSlot, const char psMethodSlot, bool bConfigurable=true, bool bEnabled=true)

bool	remove (const TQString &sAction)

TDEAccelAction *	insert (const TQString &sName, const TQString &sLabel)

bool	updateConnections ()

const TDEShortcut &	shortcut (const TQString &sAction) const

bool	setShortcut (const TQString &sAction, const TDEShortcut &shortcut)

bool	setSlot (const TQString &sAction, const TQObject pObjSlot, const char psMethodSlot)

bool	setActionEnabled (const TQString &sAction, bool bEnable)

TQString	label (const TQString &sAction) const

const TQString &	configGroup () const

void	setConfigGroup (const TQString &cg)

bool	readSettings (TDEConfigBase *pConfig=0)

bool	writeSettings (TDEConfigBase *pConfig=0) const

bool	writeSettings (TDEConfigBase *pConfig, bool bGlobal) const

void	disableBlocking (bool disable)

void	suspend (bool s)

Static Public Member Functions
static bool	useFourModifierKeys ()

static void	blockShortcuts (bool block)

Protected Member Functions
virtual void	virtual_hook (int id, void *data)

Friends
class	TDEGlobalAccelPrivate

class	TDEAccelShortcutList

Detailed Description

TDEGlobalAccel allows you to have global accelerators that are independent of the focused window.

Unlike TDEAccel it does not matter which window is currently active.

See also: TDEAccel; TDEAccelShortcutList; KKeyChooser; KKeyDialog

Configurable global shortcut support

Definition at line 45 of file kglobalaccel.h.

Constructor & Destructor Documentation

◆ TDEGlobalAccel()

TDEGlobalAccel::TDEGlobalAccel	(	TQObject *	pParent,
		const char *	psName = `0`
	)

Creates a new TDEGlobalAccel object with the given pParent and psName.

Parameters

pParent	the parent of the TQObject
psName	the name of the TQObject

Definition at line 39 of file kglobalaccel.cpp.

Member Function Documentation

◆ configGroup()

const TQString & TDEGlobalAccel::configGroup ( ) const

Returns the configuration group that is used to save the accelerators.

Returns: the configuration group

See also: TDEConfig

Definition at line 116 of file kglobalaccel.cpp.

◆ insert() [1/2]

TDEAccelAction * TDEGlobalAccel::insert	(	const TQString &	sAction,
		const TQString &	sLabel,
		const TQString &	sWhatsThis,
		const TDEShortcut &	cutDef3,
		const TDEShortcut &	cutDef4,
		const TQObject *	pObjSlot,
		const char *	psMethodSlot,
		bool	bConfigurable = `true`,
		bool	bEnabled = `true`
	)

Create an accelerator action.

Usage:

insert( "Do Something", i18n("Do Something"),
  i18n("This action allows you to do something really great with this program to "
       "the currently open document."),
  ALT+CTRL+Key_Q, KKey::QtWIN+CTRL+Key_Q, this, TQ_SLOT(slotDoSomething()) );

Parameters

sAction	The internal name of the action.
sLabel	An i18n'ized short description of the action displayed when using KKeyChooser to reconfigure the shortcuts.
sWhatsThis	An extended description of the action.
cutDef3	The default 3 modifier scheme shortcut.
cutDef4	The default 4 modifier scheme shortcut.
pObjSlot	Pointer to the slot object.
psMethodSlot	Pointer to the slot method.
bConfigurable	Allow the user to change this shortcut if set to 'true'.
bEnabled	The action will be activated by the shortcut if set to 'true'.

Definition at line 77 of file kglobalaccel.cpp.

◆ insert() [2/2]

TDEAccelAction * TDEGlobalAccel::insert	(	const TQString &	sName,
		const TQString &	sLabel
	)

Use this to insert a label into the action list.

This will be displayed when the user configures shortcuts.

Parameters

sName	of the of the action to insert
sLabel	a user-readable (i18n!) name for the action

Returns: the TDEAccelAction of the action

Definition at line 88 of file kglobalaccel.cpp.

◆ isEnabled()

bool TDEGlobalAccel::isEnabled ( )

Checks whether the accelerators are enabled.

Returns: true if the TDEGlobalAccel is enabled

Definition at line 62 of file kglobalaccel.cpp.

◆ label()

TQString TDEGlobalAccel::label ( const TQString & sAction ) const

Return the label (i18n'ized short description) associated with the action named by sAction.

Parameters

sAction the name of the action

Returns: the label

Since: 3.3

Definition at line 106 of file kglobalaccel.cpp.

◆ readSettings()

bool TDEGlobalAccel::readSettings ( TDEConfigBase * pConfig = 0 )

Read all shortcuts from pConfig, or (if pConfig is zero) from the application's configuration file TDEGlobal::config().

Parameters

pConfig the configuration file to read from, or 0 for the application configuration file

Returns: true if successful, false otherwise

Definition at line 122 of file kglobalaccel.cpp.

◆ remove()

bool TDEGlobalAccel::remove ( const TQString & sAction )

Removes the accelerator action identified by the name.

Remember to also call updateConnections().

Parameters

sAction the name of the action to remove

Since: 3.1

Definition at line 93 of file kglobalaccel.cpp.

◆ setActionEnabled()

bool TDEGlobalAccel::setActionEnabled	(	const TQString &	sAction,
		bool	bEnable
	)

Enables or disables action sAction.

Since: 3.4

Definition at line 111 of file kglobalaccel.cpp.

◆ setConfigGroup()

void TDEGlobalAccel::setConfigGroup ( const TQString & cg )

Sets the configuration group that is used to save the accelerators.

Parameters

cg	the configuration group

See also: TDEConfig

Definition at line 119 of file kglobalaccel.cpp.

◆ setEnabled()

void TDEGlobalAccel::setEnabled ( bool bEnabled )

Enables or disables the TDEGlobalAccel.

Parameters

bEnabled true if the TDEGlobalAccel should be enabled, false if it should be disabled.

Definition at line 65 of file kglobalaccel.cpp.

◆ setShortcut()

bool TDEGlobalAccel::setShortcut	(	const TQString &	sAction,
		const TDEShortcut &	shortcut
	)

Set the shortcut to be associated with the action named by sAction.

Parameters

sAction	the name of the action
shortcut	the shortcut for the action

Returns: true if successful, false otherwise

Definition at line 102 of file kglobalaccel.cpp.

◆ setSlot()

bool TDEGlobalAccel::setSlot	(	const TQString &	sAction,
		const TQObject *	pObjSlot,
		const char *	psMethodSlot
	)

Set the slot to be called when the shortcut of the action named by sAction is pressed.

Parameters

sAction	the name of the action
pObjSlot	the receiver of the signal
psMethodSlot	the slot to receive the signal

Returns: true if successful, false otherwise

Definition at line 104 of file kglobalaccel.cpp.

◆ shortcut()

const TDEShortcut & TDEGlobalAccel::shortcut ( const TQString & sAction ) const

Return the shortcut associated with the action named by sAction.

Parameters

sAction the name of the action

Returns: the shortcut. If the action does not exist a null shortcut will be returned.

Definition at line 96 of file kglobalaccel.cpp.

◆ updateConnections()

bool TDEGlobalAccel::updateConnections ( )

Updates the connections of the accelerations after changing them.

Returns: true if successful, false otherwise

Definition at line 90 of file kglobalaccel.cpp.

◆ writeSettings() [1/2]

bool TDEGlobalAccel::writeSettings	(	TDEConfigBase *	pConfig,
		bool	bGlobal
	)		const

Write the current shortcuts to pConfig, or (if pConfig is zero) to the application's configuration file.

Alternatively, if bGlobal is true, then write to kdeglobals.

Parameters

pConfig	the configuration file to read from, or 0 for the application configuration file
bGlobal	if true write the configuration to the kde global settings

Returns: true if successful, false otherwise

Definition at line 126 of file kglobalaccel.cpp.

◆ writeSettings() [2/2]

bool TDEGlobalAccel::writeSettings ( TDEConfigBase * pConfig = 0 ) const

Write the current shortcuts to pConfig, or (if pConfig is zero) to the application's configuration file.

Parameters

pConfig the configuration file to read from, or 0 for the application configuration file

Returns: true if successful, false otherwise

Since: 3.1

Definition at line 124 of file kglobalaccel.cpp.

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

tdecore

Public Member Functions

Static Public Member Functions

Protected Member Functions

Friends

Detailed Description

Constructor & Destructor Documentation

◆ TDEGlobalAccel()

Member Function Documentation

◆ configGroup()

◆ insert() [1/2]

◆ insert() [2/2]

◆ isEnabled()

◆ label()

◆ readSettings()

◆ remove()

◆ setActionEnabled()

◆ setConfigGroup()

◆ setEnabled()

◆ setShortcut()

◆ setSlot()

◆ shortcut()

◆ updateConnections()

◆ writeSettings() [1/2]

◆ writeSettings() [2/2]

tdecore

tdecore