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.
tdebase/kcontrol/keys/tdeaccelaction.h

206 lines
6.4 KiB

// THIS FILE IS A COPY OF tdelibs/tdecore/tdeaccelaction.h AND MUST BE KEPT
// IN SYNC WITH THAT FILE.
/* 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 _TDEACCELACTION_H
#define _TDEACCELACTION_H
#include <tqmap.h>
#include <tqptrvector.h>
#include <tqstring.h>
#include <tqvaluevector.h>
#include <tdeshortcut.h>
class TDEAccelBase;
class TQObject;
class TDEConfig;
class TDEConfigBase;
/*
TDEAccelAction holds information an a given action, such as "Run Command"
1) TDEAccelAction = "Run Command"
Default3 = "Alt+F2"
Default4 = "Meta+Enter;Alt+F2"
1) TDEShortcut = "Meta+Enter"
1) KKeySequence = "Meta+Enter"
1) KKey = "Meta+Enter"
1) Meta+Enter
2) Meta+Keypad_Enter
2) TDEShortcut = "Alt+F2"
1) KKeySequence = "Alt+F2"
1) Alt+F2
2) TDEAccelAction = "Something"
Default3 = ""
Default4 = ""
1) TDEShortcut = "Meta+X,Asterisk"
1) KKeySequence = "Meta+X,Asterisk"
1) KKey = "Meta+X"
1) Meta+X
2) KKey = "Asterisk"
1) Shift+8 (English layout)
2) Keypad_Asterisk
*/
//---------------------------------------------------------------------
// TDEAccelAction
//---------------------------------------------------------------------
class TDEAccelAction
{
public:
TDEAccelAction();
TDEAccelAction( const TDEAccelAction& );
TDEAccelAction( const TQString& sName, const TQString& sLabel, const TQString& sWhatsThis,
const TDEShortcut& cutDef3, const TDEShortcut& cutDef4,
const TQObject* pObjSlot, const char* psMethodSlot,
bool bConfigurable, bool bEnabled );
~TDEAccelAction();
void clear();
bool init( const TQString& sName, const TQString& sLabel, const TQString& sWhatsThis,
const TDEShortcut& cutDef3, const TDEShortcut& cutDef4,
const TQObject* pObjSlot, const char* psMethodSlot,
bool bConfigurable, bool bEnabled );
TDEAccelAction& operator=( const TDEAccelAction& );
const TQString& name() const { return m_sName; }
const TQString& label() const { return m_sLabel; }
const TQString& whatsThis() const { return m_sWhatsThis; }
const TDEShortcut& shortcut() const { return m_cut; }
const TDEShortcut& shortcutDefault() const;
const TDEShortcut& shortcutDefault3() const { return m_cutDefault3; }
const TDEShortcut& shortcutDefault4() const { return m_cutDefault4; }
const TQObject* objSlotPtr() const { return m_pObjSlot; }
const char* methodSlotPtr() const { return m_psMethodSlot; }
bool isConfigurable() const { return m_bConfigurable; }
bool isEnabled() const { return m_bEnabled; }
void setName( const TQString& );
void setLabel( const TQString& );
void setWhatsThis( const TQString& );
bool setShortcut( const TDEShortcut& rgCuts );
void setSlot( const TQObject* pObjSlot, const char* psMethodSlot );
void setConfigurable( bool );
void setEnabled( bool );
int getID() const { return m_nIDAccel; }
void setID( int n ) { m_nIDAccel = n; }
bool isConnected() const;
bool setKeySequence( uint i, const KKeySequence& );
void clearShortcut();
bool contains( const KKeySequence& );
TQString toString() const;
TQString toStringInternal() const;
static bool useFourModifierKeys();
static void useFourModifierKeys( bool );
protected:
TQString m_sName,
m_sLabel,
m_sWhatsThis;
TDEShortcut m_cut;
TDEShortcut m_cutDefault3, m_cutDefault4;
const TQObject* m_pObjSlot;
const char* m_psMethodSlot;
bool m_bConfigurable,
m_bEnabled;
int m_nIDAccel;
uint m_nConnections;
void incConnections();
void decConnections();
private:
static int g_bUseFourModifierKeys;
class TDEAccelActionPrivate* d;
friend class TDEAccelActions;
friend class TDEAccelBase;
};
//---------------------------------------------------------------------
// TDEAccelActions
//---------------------------------------------------------------------
class TDEAccelActions
{
public:
TDEAccelActions();
TDEAccelActions( const TDEAccelActions& );
virtual ~TDEAccelActions();
void clear();
bool init( const TDEAccelActions& );
bool init( TDEConfigBase& config, const TQString& sGroup );
void updateShortcuts( TDEAccelActions& );
int actionIndex( const TQString& sAction ) const;
TDEAccelAction* actionPtr( uint );
const TDEAccelAction* actionPtr( uint ) const;
TDEAccelAction* actionPtr( const TQString& sAction );
const TDEAccelAction* actionPtr( const TQString& sAction ) const;
TDEAccelAction* actionPtr( KKeySequence cut );
TDEAccelAction& operator []( uint );
const TDEAccelAction& operator []( uint ) const;
TDEAccelAction* insert( const TQString& sAction, const TQString& sLabel, const TQString& sWhatsThis,
const TDEShortcut& rgCutDefaults3, const TDEShortcut& rgCutDefaults4,
const TQObject* pObjSlot = 0, const char* psMethodSlot = 0,
bool bConfigurable = true, bool bEnabled = true );
TDEAccelAction* insert( const TQString& sName, const TQString& sLabel );
bool remove( const TQString& sAction );
bool readActions( const TQString& sConfigGroup = "Shortcuts", TDEConfigBase* pConfig = 0 );
bool writeActions( const TQString& sConfigGroup = "Shortcuts", TDEConfigBase* pConfig = 0,
bool bWriteAll = false, bool bGlobal = false ) const;
void emitKeycodeChanged();
uint count() const;
protected:
TDEAccelBase* m_pTDEAccelBase;
TDEAccelAction** m_prgActions;
uint m_nSizeAllocated, m_nSize;
void resize( uint );
void insertPtr( TDEAccelAction* );
private:
class TDEAccelActionsPrivate* d;
TDEAccelActions( TDEAccelBase* );
void initPrivate( TDEAccelBase* );
TDEAccelActions& operator =( TDEAccelActions& );
friend class TDEAccelBase;
};
#endif // _TDEACCELACTION_H