You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
240 lines
7.7 KiB
240 lines
7.7 KiB
/* 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 _KGLOBALACCEL_H_
|
|
#define _KGLOBALACCEL_H_
|
|
|
|
#include <tqobject.h>
|
|
#include <kshortcut.h>
|
|
|
|
class TQPopupMenu;
|
|
class TQWidget;
|
|
class KAccelAction;
|
|
class KAccelActions;
|
|
class KConfigBase;
|
|
|
|
class KGlobalAccelPrivate;
|
|
|
|
/**
|
|
* KGlobalAccel allows you to have global accelerators that are independent of
|
|
* the focused window. Unlike KAccel it does not matter which window is
|
|
* currently active.
|
|
*
|
|
* @see KAccel
|
|
* @see KAccelShortcutList
|
|
* @see KKeyChooser
|
|
* @see KKeyDialog
|
|
* @short Configurable global shortcut support
|
|
*/
|
|
class KDECORE_EXPORT KGlobalAccel : public QObject
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
/**
|
|
* Creates a new KGlobalAccel object with the given pParent and
|
|
* psName.
|
|
* @param pParent the parent of the QObject
|
|
* @param psName the name of the QObject
|
|
*/
|
|
KGlobalAccel( TQObject* pParent, const char* psName = 0 );
|
|
virtual ~KGlobalAccel();
|
|
|
|
/**
|
|
* Checks whether the accelerators are enabled.
|
|
* @return true if the KGlobalAccel is enabled
|
|
*/
|
|
bool isEnabled();
|
|
|
|
/**
|
|
* Enables or disables the KGlobalAccel
|
|
* @param bEnabled true if the KGlobalAccel 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, TQT_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'.
|
|
*/
|
|
KAccelAction* insert( const TQString& sAction, const TQString& sLabel, const TQString& sWhatsThis,
|
|
const KShortcut& cutDef3, const KShortcut& 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 KAccelAction of the action
|
|
*/
|
|
KAccelAction* 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 KShortcut& 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 KShortcut &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 KConfig
|
|
*/
|
|
const TQString& configGroup() const;
|
|
|
|
/**
|
|
* Sets the configuration group that is used to save the accelerators.
|
|
* @param cg the configuration group
|
|
* @see KConfig
|
|
*/
|
|
void setConfigGroup( const TQString &cg );
|
|
|
|
/**
|
|
* Read all shortcuts from @p pConfig, or (if @p pConfig
|
|
* is zero) from the application's configuration file
|
|
* KGlobal::config().
|
|
* @param pConfig the configuration file to read from, or 0 for the application
|
|
* configuration file
|
|
* @return true if successful, false otherwise
|
|
*/
|
|
bool readSettings( KConfigBase* 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( KConfigBase* 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( KConfigBase* pConfig, bool bGlobal ) const;
|
|
|
|
/**
|
|
* @internal -- this a wrapper function to
|
|
* KAccelActions::useFourModifierKeys().
|
|
*/
|
|
static bool useFourModifierKeys();
|
|
|
|
/**
|
|
* @internal
|
|
*/
|
|
static void blockShortcuts( bool block );
|
|
/**
|
|
* @internal
|
|
*/
|
|
void disableBlocking( bool disable );
|
|
|
|
/**
|
|
* @internal
|
|
*/
|
|
// like setEnabled(), but doesn't ungrab (see in KGlobalAccelPrivate)
|
|
void suspend( bool s );
|
|
|
|
private:
|
|
|
|
KAccelActions& actions();
|
|
const KAccelActions& actions() const;
|
|
|
|
friend class KGlobalAccelPrivate;
|
|
friend class KAccelShortcutList;
|
|
protected:
|
|
/** \internal */
|
|
virtual void virtual_hook( int id, void* data );
|
|
private:
|
|
class KGlobalAccelPrivate* d;
|
|
};
|
|
|
|
#endif // _KGLOBALACCEL_H_
|