Rename kglobalaccel* files to tdeglobalaccel*.
A dummy 'kglobalaccel.h' has been added to allow TDE to built till renaming is carried out across the whole code base. It will then be removed. Signed-off-by: Michele Calgaro <michele.calgaro@yahoo.it>pull/341/head
parent
a2e8812557
commit
fda0344c47
GPG Key ID:
2A75B7CA8ADED5CF
@ -1,239 +1 @@
|
|||||||
/* This file is part of the KDE libraries
|
#include <tdeglobalaccel.h>
|
||||||
Copyright (C) 2001,2002 Ellis Whitehead <ellis@kde.org>
|
|
||||||
|
|
||||||
This library is free software; you can redistribute it and/or
|
|
||||||
modify it under the terms of the GNU Library General Public
|
|
||||||
License as published by the Free Software Foundation; either
|
|
||||||
version 2 of the License, or (at your option) any later version.
|
|
||||||
|
|
||||||
This library is distributed in the hope that it will be useful,
|
|
||||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
||||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
||||||
Library General Public License for more details.
|
|
||||||
|
|
||||||
You should have received a copy of the GNU Library General Public License
|
|
||||||
along with this library; see the file COPYING.LIB. If not, write to
|
|
||||||
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
||||||
Boston, MA 02110-1301, USA.
|
|
||||||
*/
|
|
||||||
|
|
||||||
#ifndef _KGLOBALACCEL_H_
|
|
||||||
#define _KGLOBALACCEL_H_
|
|
||||||
|
|
||||||
#include <tqobject.h>
|
|
||||||
#include <tdeshortcut.h>
|
|
||||||
|
|
||||||
class TQPopupMenu;
|
|
||||||
class TQWidget;
|
|
||||||
class TDEAccelAction;
|
|
||||||
class TDEAccelActions;
|
|
||||||
class TDEConfigBase;
|
|
||||||
|
|
||||||
class TDEGlobalAccelPrivate;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 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 TDEAccel
|
|
||||||
* @see TDEAccelShortcutList
|
|
||||||
* @see KKeyChooser
|
|
||||||
* @see KKeyDialog
|
|
||||||
* @short Configurable global shortcut support
|
|
||||||
*/
|
|
||||||
class TDECORE_EXPORT TDEGlobalAccel : public TQObject
|
|
||||||
{
|
|
||||||
TQ_OBJECT
|
|
||||||
public:
|
|
||||||
/**
|
|
||||||
* Creates a new TDEGlobalAccel object with the given pParent and
|
|
||||||
* psName.
|
|
||||||
* @param pParent the parent of the TQObject
|
|
||||||
* @param psName the name of the TQObject
|
|
||||||
*/
|
|
||||||
TDEGlobalAccel( TQObject* pParent, const char* psName = 0 );
|
|
||||||
virtual ~TDEGlobalAccel();
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Checks whether the accelerators are enabled.
|
|
||||||
* @return true if the TDEGlobalAccel is enabled
|
|
||||||
*/
|
|
||||||
bool isEnabled();
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Enables or disables the TDEGlobalAccel
|
|
||||||
* @param bEnabled true if the TDEGlobalAccel should be enabled, false if it
|
|
||||||
* should be disabled.
|
|
||||||
*/
|
|
||||||
void setEnabled( bool bEnabled );
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create an accelerator action.
|
|
||||||
*
|
|
||||||
* Usage:
|
|
||||||
*\code
|
|
||||||
* 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()) );
|
|
||||||
*\endcode
|
|
||||||
*
|
|
||||||
* @param sAction The internal name of the action.
|
|
||||||
* @param sLabel An i18n'ized short description of the action displayed when
|
|
||||||
* using KKeyChooser to reconfigure the shortcuts.
|
|
||||||
* @param sWhatsThis An extended description of the action.
|
|
||||||
* @param cutDef3 The default 3 modifier scheme shortcut.
|
|
||||||
* @param cutDef4 The default 4 modifier scheme shortcut.
|
|
||||||
* @param pObjSlot Pointer to the slot object.
|
|
||||||
* @param psMethodSlot Pointer to the slot method.
|
|
||||||
* @param bConfigurable Allow the user to change this shortcut if set to 'true'.
|
|
||||||
* @param bEnabled The action will be activated by the shortcut if set to 'true'.
|
|
||||||
*/
|
|
||||||
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 );
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Removes the accelerator action identified by the name.
|
|
||||||
* Remember to also call updateConnections().
|
|
||||||
* @param sAction the name of the action to remove
|
|
||||||
* @since 3.1
|
|
||||||
*/
|
|
||||||
bool remove( const TQString& sAction );
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Use this to insert a label into the action list. This will be
|
|
||||||
* displayed when the user configures shortcuts.
|
|
||||||
* @param sName of the of the action to insert
|
|
||||||
* @param sLabel a user-readable (i18n!) name for the action
|
|
||||||
* @return the TDEAccelAction of the action
|
|
||||||
*/
|
|
||||||
TDEAccelAction* insert( const TQString& sName, const TQString& sLabel );
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Updates the connections of the accelerations after changing them.
|
|
||||||
* @return true if successful, false otherwise
|
|
||||||
*/
|
|
||||||
bool updateConnections();
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Return the shortcut associated with the action named by @p sAction.
|
|
||||||
* @param sAction the name of the action
|
|
||||||
* @return the shortcut. If the action does not exist a null shortcut will be returned.
|
|
||||||
*/
|
|
||||||
const TDEShortcut& shortcut( const TQString& sAction ) const;
|
|
||||||
/**
|
|
||||||
* Set the shortcut to be associated with the action named by @p sAction.
|
|
||||||
* @param sAction the name of the action
|
|
||||||
* @param shortcut the shortcut for the action
|
|
||||||
* @return true if successful, false otherwise
|
|
||||||
*/
|
|
||||||
bool setShortcut( const TQString& sAction, const TDEShortcut &shortcut );
|
|
||||||
/**
|
|
||||||
* Set the slot to be called when the shortcut of the action named
|
|
||||||
* by @p sAction is pressed.
|
|
||||||
* @param sAction the name of the action
|
|
||||||
* @param pObjSlot the receiver of the signal
|
|
||||||
* @param psMethodSlot the slot to receive the signal
|
|
||||||
* @return true if successful, false otherwise
|
|
||||||
*/
|
|
||||||
bool setSlot( const TQString& sAction, const TQObject* pObjSlot, const char* psMethodSlot );
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Enables or disables action @p sAction.
|
|
||||||
* @since 3.4
|
|
||||||
*/
|
|
||||||
bool setActionEnabled( const TQString& sAction, bool bEnable );
|
|
||||||
/**
|
|
||||||
* Return the label (i18n'ized short description) associated with the action named by @p sAction.
|
|
||||||
* @param sAction the name of the action
|
|
||||||
* @return the label
|
|
||||||
* @since 3.3
|
|
||||||
*/
|
|
||||||
TQString label( const TQString& sAction ) const;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Returns the configuration group that is used to save the accelerators.
|
|
||||||
* @return the configuration group
|
|
||||||
* @see TDEConfig
|
|
||||||
*/
|
|
||||||
const TQString& configGroup() const;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Sets the configuration group that is used to save the accelerators.
|
|
||||||
* @param cg the configuration group
|
|
||||||
* @see TDEConfig
|
|
||||||
*/
|
|
||||||
void setConfigGroup( const TQString &cg );
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Read all shortcuts from @p pConfig, or (if @p pConfig
|
|
||||||
* is zero) from the application's configuration file
|
|
||||||
* TDEGlobal::config().
|
|
||||||
* @param pConfig the configuration file to read from, or 0 for the application
|
|
||||||
* configuration file
|
|
||||||
* @return true if successful, false otherwise
|
|
||||||
*/
|
|
||||||
bool readSettings( TDEConfigBase* pConfig = 0 );
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Write the current shortcuts to @p pConfig,
|
|
||||||
* or (if @p pConfig is zero) to the application's
|
|
||||||
* configuration file.
|
|
||||||
* @param pConfig the configuration file to read from, or 0 for the application
|
|
||||||
* configuration file
|
|
||||||
* @return true if successful, false otherwise
|
|
||||||
* @since 3.1
|
|
||||||
*/
|
|
||||||
bool writeSettings( TDEConfigBase* pConfig = 0 ) const;
|
|
||||||
// BCI: merge these two writeSettings methods in KDE 4.0
|
|
||||||
/**
|
|
||||||
* Write the current shortcuts to @p pConfig,
|
|
||||||
* or (if @p pConfig is zero) to the application's
|
|
||||||
* configuration file. Alternatively, if bGlobal is true, then write
|
|
||||||
* to kdeglobals.
|
|
||||||
* @param pConfig the configuration file to read from, or 0 for the application
|
|
||||||
* configuration file
|
|
||||||
* @param bGlobal if true write the configuration to the kde global settings
|
|
||||||
* @return true if successful, false otherwise
|
|
||||||
*/
|
|
||||||
bool writeSettings( TDEConfigBase* pConfig, bool bGlobal ) const;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @internal -- this a wrapper function to
|
|
||||||
* TDEAccelActions::useFourModifierKeys().
|
|
||||||
*/
|
|
||||||
static bool useFourModifierKeys();
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @internal
|
|
||||||
*/
|
|
||||||
static void blockShortcuts( bool block );
|
|
||||||
/**
|
|
||||||
* @internal
|
|
||||||
*/
|
|
||||||
void disableBlocking( bool disable );
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @internal
|
|
||||||
*/
|
|
||||||
// like setEnabled(), but doesn't ungrab (see in TDEGlobalAccelPrivate)
|
|
||||||
void suspend( bool s );
|
|
||||||
|
|
||||||
private:
|
|
||||||
|
|
||||||
TDEAccelActions& actions();
|
|
||||||
const TDEAccelActions& actions() const;
|
|
||||||
|
|
||||||
friend class TDEGlobalAccelPrivate;
|
|
||||||
friend class TDEAccelShortcutList;
|
|
||||||
protected:
|
|
||||||
/** \internal */
|
|
||||||
virtual void virtual_hook( int id, void* data );
|
|
||||||
private:
|
|
||||||
class TDEGlobalAccelPrivate* d;
|
|
||||||
};
|
|
||||||
|
|
||||||
#endif // _KGLOBALACCEL_H_
|
|
||||||
|
|||||||
@ -0,0 +1,239 @@
|
|||||||
|
/* This file is part of the KDE libraries
|
||||||
|
Copyright (C) 2001,2002 Ellis Whitehead <ellis@kde.org>
|
||||||
|
|
||||||
|
This library is free software; you can redistribute it and/or
|
||||||
|
modify it under the terms of the GNU Library General Public
|
||||||
|
License as published by the Free Software Foundation; either
|
||||||
|
version 2 of the License, or (at your option) any later version.
|
||||||
|
|
||||||
|
This library is distributed in the hope that it will be useful,
|
||||||
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||||||
|
Library General Public License for more details.
|
||||||
|
|
||||||
|
You should have received a copy of the GNU Library General Public License
|
||||||
|
along with this library; see the file COPYING.LIB. If not, write to
|
||||||
|
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
||||||
|
Boston, MA 02110-1301, USA.
|
||||||
|
*/
|
||||||
|
|
||||||
|
#ifndef _TDEGLOBALACCEL_H_
|
||||||
|
#define _TDEGLOBALACCEL_H_
|
||||||
|
|
||||||
|
#include <tqobject.h>
|
||||||
|
#include <tdeshortcut.h>
|
||||||
|
|
||||||
|
class TQPopupMenu;
|
||||||
|
class TQWidget;
|
||||||
|
class TDEAccelAction;
|
||||||
|
class TDEAccelActions;
|
||||||
|
class TDEConfigBase;
|
||||||
|
|
||||||
|
class TDEGlobalAccelPrivate;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 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 TDEAccel
|
||||||
|
* @see TDEAccelShortcutList
|
||||||
|
* @see KKeyChooser
|
||||||
|
* @see KKeyDialog
|
||||||
|
* @short Configurable global shortcut support
|
||||||
|
*/
|
||||||
|
class TDECORE_EXPORT TDEGlobalAccel : public TQObject
|
||||||
|
{
|
||||||
|
TQ_OBJECT
|
||||||
|
public:
|
||||||
|
/**
|
||||||
|
* Creates a new TDEGlobalAccel object with the given pParent and
|
||||||
|
* psName.
|
||||||
|
* @param pParent the parent of the TQObject
|
||||||
|
* @param psName the name of the TQObject
|
||||||
|
*/
|
||||||
|
TDEGlobalAccel( TQObject* pParent, const char* psName = 0 );
|
||||||
|
virtual ~TDEGlobalAccel();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Checks whether the accelerators are enabled.
|
||||||
|
* @return true if the TDEGlobalAccel is enabled
|
||||||
|
*/
|
||||||
|
bool isEnabled();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Enables or disables the TDEGlobalAccel
|
||||||
|
* @param bEnabled true if the TDEGlobalAccel should be enabled, false if it
|
||||||
|
* should be disabled.
|
||||||
|
*/
|
||||||
|
void setEnabled( bool bEnabled );
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create an accelerator action.
|
||||||
|
*
|
||||||
|
* Usage:
|
||||||
|
*\code
|
||||||
|
* 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()) );
|
||||||
|
*\endcode
|
||||||
|
*
|
||||||
|
* @param sAction The internal name of the action.
|
||||||
|
* @param sLabel An i18n'ized short description of the action displayed when
|
||||||
|
* using KKeyChooser to reconfigure the shortcuts.
|
||||||
|
* @param sWhatsThis An extended description of the action.
|
||||||
|
* @param cutDef3 The default 3 modifier scheme shortcut.
|
||||||
|
* @param cutDef4 The default 4 modifier scheme shortcut.
|
||||||
|
* @param pObjSlot Pointer to the slot object.
|
||||||
|
* @param psMethodSlot Pointer to the slot method.
|
||||||
|
* @param bConfigurable Allow the user to change this shortcut if set to 'true'.
|
||||||
|
* @param bEnabled The action will be activated by the shortcut if set to 'true'.
|
||||||
|
*/
|
||||||
|
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 );
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Removes the accelerator action identified by the name.
|
||||||
|
* Remember to also call updateConnections().
|
||||||
|
* @param sAction the name of the action to remove
|
||||||
|
* @since 3.1
|
||||||
|
*/
|
||||||
|
bool remove( const TQString& sAction );
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Use this to insert a label into the action list. This will be
|
||||||
|
* displayed when the user configures shortcuts.
|
||||||
|
* @param sName of the of the action to insert
|
||||||
|
* @param sLabel a user-readable (i18n!) name for the action
|
||||||
|
* @return the TDEAccelAction of the action
|
||||||
|
*/
|
||||||
|
TDEAccelAction* insert( const TQString& sName, const TQString& sLabel );
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Updates the connections of the accelerations after changing them.
|
||||||
|
* @return true if successful, false otherwise
|
||||||
|
*/
|
||||||
|
bool updateConnections();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return the shortcut associated with the action named by @p sAction.
|
||||||
|
* @param sAction the name of the action
|
||||||
|
* @return the shortcut. If the action does not exist a null shortcut will be returned.
|
||||||
|
*/
|
||||||
|
const TDEShortcut& shortcut( const TQString& sAction ) const;
|
||||||
|
/**
|
||||||
|
* Set the shortcut to be associated with the action named by @p sAction.
|
||||||
|
* @param sAction the name of the action
|
||||||
|
* @param shortcut the shortcut for the action
|
||||||
|
* @return true if successful, false otherwise
|
||||||
|
*/
|
||||||
|
bool setShortcut( const TQString& sAction, const TDEShortcut &shortcut );
|
||||||
|
/**
|
||||||
|
* Set the slot to be called when the shortcut of the action named
|
||||||
|
* by @p sAction is pressed.
|
||||||
|
* @param sAction the name of the action
|
||||||
|
* @param pObjSlot the receiver of the signal
|
||||||
|
* @param psMethodSlot the slot to receive the signal
|
||||||
|
* @return true if successful, false otherwise
|
||||||
|
*/
|
||||||
|
bool setSlot( const TQString& sAction, const TQObject* pObjSlot, const char* psMethodSlot );
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Enables or disables action @p sAction.
|
||||||
|
* @since 3.4
|
||||||
|
*/
|
||||||
|
bool setActionEnabled( const TQString& sAction, bool bEnable );
|
||||||
|
/**
|
||||||
|
* Return the label (i18n'ized short description) associated with the action named by @p sAction.
|
||||||
|
* @param sAction the name of the action
|
||||||
|
* @return the label
|
||||||
|
* @since 3.3
|
||||||
|
*/
|
||||||
|
TQString label( const TQString& sAction ) const;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns the configuration group that is used to save the accelerators.
|
||||||
|
* @return the configuration group
|
||||||
|
* @see TDEConfig
|
||||||
|
*/
|
||||||
|
const TQString& configGroup() const;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Sets the configuration group that is used to save the accelerators.
|
||||||
|
* @param cg the configuration group
|
||||||
|
* @see TDEConfig
|
||||||
|
*/
|
||||||
|
void setConfigGroup( const TQString &cg );
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Read all shortcuts from @p pConfig, or (if @p pConfig
|
||||||
|
* is zero) from the application's configuration file
|
||||||
|
* TDEGlobal::config().
|
||||||
|
* @param pConfig the configuration file to read from, or 0 for the application
|
||||||
|
* configuration file
|
||||||
|
* @return true if successful, false otherwise
|
||||||
|
*/
|
||||||
|
bool readSettings( TDEConfigBase* pConfig = 0 );
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Write the current shortcuts to @p pConfig,
|
||||||
|
* or (if @p pConfig is zero) to the application's
|
||||||
|
* configuration file.
|
||||||
|
* @param pConfig the configuration file to read from, or 0 for the application
|
||||||
|
* configuration file
|
||||||
|
* @return true if successful, false otherwise
|
||||||
|
* @since 3.1
|
||||||
|
*/
|
||||||
|
bool writeSettings( TDEConfigBase* pConfig = 0 ) const;
|
||||||
|
// BCI: merge these two writeSettings methods in KDE 4.0
|
||||||
|
/**
|
||||||
|
* Write the current shortcuts to @p pConfig,
|
||||||
|
* or (if @p pConfig is zero) to the application's
|
||||||
|
* configuration file. Alternatively, if bGlobal is true, then write
|
||||||
|
* to kdeglobals.
|
||||||
|
* @param pConfig the configuration file to read from, or 0 for the application
|
||||||
|
* configuration file
|
||||||
|
* @param bGlobal if true write the configuration to the kde global settings
|
||||||
|
* @return true if successful, false otherwise
|
||||||
|
*/
|
||||||
|
bool writeSettings( TDEConfigBase* pConfig, bool bGlobal ) const;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @internal -- this a wrapper function to
|
||||||
|
* TDEAccelActions::useFourModifierKeys().
|
||||||
|
*/
|
||||||
|
static bool useFourModifierKeys();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @internal
|
||||||
|
*/
|
||||||
|
static void blockShortcuts( bool block );
|
||||||
|
/**
|
||||||
|
* @internal
|
||||||
|
*/
|
||||||
|
void disableBlocking( bool disable );
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @internal
|
||||||
|
*/
|
||||||
|
// like setEnabled(), but doesn't ungrab (see in TDEGlobalAccelPrivate)
|
||||||
|
void suspend( bool s );
|
||||||
|
|
||||||
|
private:
|
||||||
|
|
||||||
|
TDEAccelActions& actions();
|
||||||
|
const TDEAccelActions& actions() const;
|
||||||
|
|
||||||
|
friend class TDEGlobalAccelPrivate;
|
||||||
|
friend class TDEAccelShortcutList;
|
||||||
|
protected:
|
||||||
|
/** \internal */
|
||||||
|
virtual void virtual_hook( int id, void* data );
|
||||||
|
private:
|
||||||
|
class TDEGlobalAccelPrivate* d;
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // _TDEGLOBALACCEL_H_
|
||||||
Loading…
Reference in New Issue