summaryrefslogtreecommitdiff
Side-by-side diff
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--libopie2/opieui/okeyconfigwidget.cpp311
-rw-r--r--libopie2/opieui/okeyconfigwidget.h10
2 files changed, 311 insertions, 10 deletions
diff --git a/libopie2/opieui/okeyconfigwidget.cpp b/libopie2/opieui/okeyconfigwidget.cpp
index d52a55f..4482754 100644
--- a/libopie2/opieui/okeyconfigwidget.cpp
+++ b/libopie2/opieui/okeyconfigwidget.cpp
@@ -25,74 +25,74 @@ OKeyPair::OKeyPair( int key, int mod )
* The destructor
*/
OKeyPair::~OKeyPair() {}
/**
* Is this OKeyPair empty/valid?
*/
bool OKeyPair::isEmpty()const {
return ( ( m_key == -1 )&& ( m_mod == -1 ) );
}
/**
* get the keycode for this OKeyPair. The Key relates to Qt::Key.
*
* @see Qt::Key
* @see setKey
*/
int OKeyPair::keycode()const {
return m_key;
}
/**
* get the modifier key for this OKeyPair. The Modifier State relates
- * to the Qt::Modifier
+ * to the Qt::ButtonState
*
- * @see Qt::Modifier
+ * @see Qt::ButtonState
* @see setModifier
*/
int OKeyPair::modifier()const {
return m_mod;
}
/**
* Set the keycode
* @param key The Keycode to set
*
* @see keycode()
* @see Qt::Key
*/
void OKeyPair::setKeycode( int key ) {
}
/**
* Set the modifier key
*
* @param the Modifier key
- * @see Qt::Modifier
+ * @see Qt::ButtonState
* @see modifier()
*/
void OKeyPair::setModifier( int mod ) {
}
/**
* Return an OKeyPair for the Return Key without any modifier.
*/
OKeyPair OKeyPair::returnKey() {
return OKeyPair( Qt::Key_Return, 0 );
}
/**
* Return an OKeyPair for the Left Arrow Key
* without any modifier Key
*/
OKeyPair OKeyPair::leftArrowKey() {
return OKeyPair( Qt::Key_Left, 0 );
}
/**
* Return an OKeyPair for the Right Arrow Key
* without any modifier Key
@@ -124,48 +124,67 @@ OKeyPair OKeyPair::emptyKey() {
return OKeyPair;
}
/**
* This functions uses the Opie::Core::ODevice::buttons
* for OKeyPairList
*
* @see Opie::Core::ODevice
* @see Opie::Core::ODeviceButton
* @see Opie::Core::ODevice::button
*/
OKeyPairList OKeyPair::hardwareKeys() {
const QValueList<Opie::Core::ODeviceButton> but = Opie::Core::ODevice::inst()->buttons();
OKeyPairList lst;
for ( QValueList<Opie::Core::ODeviceButton>::Iterator it = but.begin();
it != but.end(); ++it )
lst.append( OKeyPair( (*it).keycode(), 0 ) );
return lst;
}
/**
+ * Equals operator. Check if two OKeyPairs have the same key and modifier
+ * @see operator!=
+ */
+bool OKeyPair::operator==( const OKeyPair& pair) {
+ if ( m_key != pair.m_key ) return false;
+ if ( m_mod != pair.m_mod ) return false;
+
+ return true;
+}
+
+/**
+ * Not equal operator. calls the equal operator internally
+ */
+bool OKeyPair::operator!=( const OKeyPair& pair) {
+ return !(*this == pair);
+}
+
+
+/**
* The normal Constructor to create a OKeyConfigItem
*
* You can set the the key paramater of this item but if
* you use this item with the OKeyConfigManager your setting
* will be overwritten.
*
* @param text The text exposed to the user
* @param config_key The key used in the config
* @param pix A Pixmap associated with this Item
* @param key The OKeyPair used
* @param def The OKeyPair used as default
*
*/
OKeyConfigItem::OKeyConfigItem( const QString& text, const QCString& config_key,
const QPixmap& pix, int id, const OKeyPair& def,
const OKeyPair& key)
: m_text( text ), m_config( config_key ), m_pix( pix ),
m_id( id ), m_def( def ), m_key( key ) {}
/**
* A special Constructor for converting from an Opie::Core::ODeviceButton
* delivered by Opie::Core::ODevice::buttons()
* There is no Config Key set and both default key and key are set
* to Opie::Core::ODeviceButton::keycode() and 0 to modifier
@@ -288,48 +307,70 @@ void OKeyConfigItem::setConfigKey( const QCString& str) {
m_config.detach();
}
/**
* @internal
*/
void OKeyConfigItem::setId( int id ) {
m_id = id;
}
/**
* If the item is not configured isEmpty() will return true
* It is empty if no text is present and no default
* and no configured key
*/
bool OKeyConfigItem::isEmpty()const {
if ( !m_def.isEmpty() ) return false;
if ( !m_key.isEmpty() ) return false;
if ( !m_text.isEmpty() ) return false;
return true;
}
/**
+ * Check if the KeyPairs are the same
+ */
+bool OKeyConfigItem::operator==( const OKeyConfigItem& conf ) {
+ if ( isEmpty() == conf.isEmpty() ) return true;
+ else if ( isEmpty() != conf.isEmpty() ) return false;
+ else if ( !isEmpty()!= conf.isEmpty() ) return false;
+
+ if ( m_id != conf.m_id ) return false;
+ if ( m_text != conf.m_text ) return false;
+ if ( m_pix != conf.m_pix ) return false;
+ if ( m_key != conf.m_key ) return false;
+ if ( m_def != conf.m_def ) return false;
+
+ return true;
+
+}
+
+bool OKeyConfigItem::operator!=( const OKeyConfigItem& conf ) {
+ return !( *this == conf );
+}
+
+/**
* \brief c'tor
* The Constructor for a OKeyConfigManager
*
* You can use this manager in multiple ways. Either make it handle
* QKeyEvents
*
* \code
* Opie::Core::Config conf = oApp->config();
* Opie::Ui::OKeyPairList blackList;
* blackList.append(Opie::Ui::OKeyPair::leftArrowKey());
* blackList.append(Opie::Ui::OKeyPair::rightArrowKey());
* Opie::Ui::OKeyConfigManager *manager = new Opie::Ui::OKeyConfigManager(conf,"key_actions",blackList,
* false);
* QListView *view = new QListView();
* manager->handleWidget(view);
* manager->addKeyConfig( Opie::Ui::OKeyPair::returnKey());
* manager->load();
*
* connect(manager,SIGNAL(actionActivated(QWidget*,QKeyEvent*,const Opie::Ui::OKeyConfigItem&)),
* this,SLOT(slotHandleKey(QWidget*,QKeyEvent*,const Opie::Ui::OKeyConfigItem&)));
*
* ....
*
* void update(){
@@ -348,61 +389,317 @@ bool OKeyConfigItem::isEmpty()const {
* Opie::Ui::OKeyConfigItem item = manager->handleKeyEvent(e);
* if(!item.isEmpty() ){
* switch(item.id()){
* case My_Delete_Key:
* break;
* }
* }
* }
*
* \endcode
*
* @param conf The Config where the KeySetting should be stored
* @param group The group where the KeySetting will be stored
* @param black Which keys shouldn't be allowed to handle
* @param grabkeyboard Calls QPEApplication::grabKeyboard to allow handling of DeviceButtons
* @param par The parent/owner of this manager
* @param name The name of this object
*/
OKeyConfigManager::OKeyConfigManager( Opie::Core::OConfig* conf,
const QString& group,
OKeyPairList black,
bool grabkeyboard, QObject* par,
const char* name)
: QObject( par, name ), m_conf( conf ), m_group( group ),
- m_blackKeys( black ), m_grab( grabkeyboard )
+ m_blackKeys( black ), m_grab( grabkeyboard ), m_map( 0 )
{}
/**
* Destructor
*/
-OKeyConfigWidget::~OKeyConfigWidget() {}
+OKeyConfigManager::~OKeyConfigManager() {}
/**
* Load the Configuration from the OConfig
* If a Key is restricted but was in the config we will
- * make the empty
+ * make it be the empty key paur
* We will change the group of the OConfig Item!
+ *
+ * @see OKeyPair::emptyKey
*/
void OKeyConfigWidget::load() {
m_conf->setGroup( m_group );
/*
* Read each item
*/
int key, mod;
for( OKeyConfigItemList::Iterator it = m_keys.begin();
it != m_keys.end(); ++it ) {
key = m_conf->readNumEntry( (*it).configKey()+"key", (*it).defaultKeyPair().keycode() );
mod = m_conf->readNumEntry( (*it).configKey()+"mod", (*it).defaultKeyPair().modifier() );
- (*it).setKeyPair( OKeyPair(key, mod) );
+ OKeyPair okey( key, mod );
+ if ( !m_blackKeys.contains( okey ) && key != -1 && mod != -1 )
+ (*it).setKeyPair( OKeyPair(key, mod) );
+ else
+ (*it).setKeyPair( OKeyPair::emptyKey() );
}
+ delete m_map; m_map = 0;
}
/**
* We will save the current configuration
* to the OConfig. We will change the group.
*/
void OKeyConfigWidget::save() {
+ m_conf->setGroup( m_group );
+ /*
+ * Write each item
+ */
+ int key, mod;
+ for( OKeyConfigItemList::Iterator it = m_keys.begin();
+ it != m_keys.end(); ++it ) {
+ if ( (*it).isEmpty() )
+ continue;
+ OKeyPair pair = (*it).keyPair();
+ m_conf->writeEntry(pair.configKey()+"key", pair.keycode() );
+ m_conf->writeEntry(pair.configKey()+"mod", pair.modifier() );
+ }
}
+
+/**
+ * This is function uses a QMap internally but you can have the same keycode
+ * with different modifier key. The behaviour is undefined if you add a OKeyConfigItem
+ * with same keycode and modifier key. The GUI takes care that a user can't
+ * cofigure two keys.
+ *
+ * Make sure you call e->ignore if you don't want to handle this event
+ */
+OKeyConfigItem OKeyConfigManager::handleKeyEvent( QKeyEvent* e ) {
+ OKeyConfigItemList keyList = keyList( e->key() );
+ if ( keyList.isEmpty() )
+ return OKeyConfigItem();
+
+ OKeyConfigItem item;
+ for ( OKeyConfigItemList::Iterator it = keyList.begin(); it != keyList.end();
+ ++it ) {
+ if ( (*it).keyPair().modifier() == e->state() ) {
+ item = *it;
+ break;
+ }
+
+ }
+
+ return item;
+}
+
+/**
+ * Return the associated id of the item or -1 if no item
+ * matched the key
+ *
+ * @see handleKeyEvent
+ */
+int OKeyConfigManager::handleKeyEventId( QKeyEvent* ev) {
+ return handleKeyEvent( ev ).id();
+}
+
+/**
+ * Add Key Config to the List of items
+ */
+void OKeyConfigManager::addKeyConfig( const OKeyConfigItem& item ) {
+ m_keys.append( item );
+ delete m_map; m_map = 0;
+}
+
+/**
+ * Remove the Key from the Config. Internal lists will be destroyed
+ * and rebuild on demand later
+ */
+void OKeyConfigManager::removeKeyConfig( const OKeyConfigItem& item ) {
+ m_keys.remove( item );
+ delete m_map; m_map = 0;
+}
+
+/**
+ * Clears the complete list
+ */
+void OKeyConfigManager::clearKeyConfig() {
+ m_keys.clear();
+ delete m_map; m_map = 0;
+}
+
+
+/**
+ * Add this OKeyPair to the blackList.
+ * Internal lists will be destroyed
+ */
+void OKeyConfigManager::addToBlackList( const OKeyPair& key) {
+ m_blackKeys.append( key );
+ delete m_map; m_map = 0;
+}
+
+
+/**
+ * Remove this OKeyPair from the black List
+ * Internal lists will be destroyed
+ */
+void OKeyConfigManager::removeFromBlackList( const OKeyPair& key ) {
+ m_blackKeys.remove( key );
+ delete m_map; m_map = 0;
+}
+
+
+/**
+ * Clear the blackList
+ */
+void OKeyConfigManager::clearBlackList() {
+ m_blackKeys.clear();
+ delete m_map; m_map = 0;
+}
+
+
+/**
+ * Return a copy of the blackList
+ */
+OKeyPairList OKeyConfigManager::blackList()const {
+ return m_blackKeys;
+}
+
+
+/**
+ * Ask the Manager to handle KeyEvents for you.
+ * All handled keys will emit a QSignal and return true
+ * that it handled the keyevent
+ */
+void OKeyConfigManager::handleWidget( QWidget* wid ) {
+ wid->installEventFilter( this );
+}
+
+/**
+ * @internal
+ */
+bool OKeyConfigManager::eventFilter( QObject* obj, QEvent* ev) {
+ if ( !obj->isWidgetType() )
+ return false;
+
+ if ( ev->type() != QEvent::KeyPress && ev->type() != QEvent::KeyRelease )
+ return false;
+
+ QKeyEvent *key = static_cast<QKeyEvent*>( ev );
+ OKeyConfigItem item = handleKeyEvent( key );
+
+ if ( item.isEmpty() )
+ return false;
+
+ emit actionActivated( static_cast<QWidget*>( obj ), key, item );
+ return true;
+}
+
+/**
+ * @internal
+ */
+OKeyConfigItemList OKeyConfigManager::keyList( int keycode) {
+ if ( !m_map ) {
+ m_map = new OKeyMapConfigPrivate;
+ /* for every key */
+ for ( OKeyConfigItemList::Iterator it = m_keys.begin();
+ it!= m_keys.end(); ++it ) {
+ bool add = true;
+ /* see if this key is blocked */
+ for ( OKeyPairList::Iterator pairIt = m_blackKeys.begin();
+ pairIt != m_blackKeys.end(); ++pairIt ) {
+ if ( (*pairIt).keycode() == (*it).keycode() &&
+ (*pairIt).modifier() == (*it).modifier() ) {
+ add = false;
+ break;
+ }
+ }
+ /* check if we added it */
+ if ( add ) {
+ if ( m_map->contains( (*it).keycode() ) )
+ (m_map[(*it).keycode()]).append( *it );
+ else
+ m_map.insert( (*it).keycode(), OKeyConfigItemList( *it ) );
+ }
+ }
+ }
+ return m_map[keycode];
+}
+
+
+
+/////////////////////////
+//////// Widget Starts Here
+namespace Opie {
+namespace Ui {
+namespace Private {
+ static QString keyToString( const OKeyPair& );
+ class OItemBox : public QHBox {
+ Q_OBJECT
+ public:
+ OItemBox( const OKeyConfigItem& item, QWidget* parent = 0, const char* name = 0, WFlags fl = 0);
+ ~OItemBox();
+
+ OKeyConfigItem item()const;
+ void setItem( const OKeyConfigItem& item );
+ private slots:
+ void slotClicked();
+ signals:
+ void configureBox( OItemBox* );
+ private:
+ QLabel *m_pix;
+ QLabel *m_text;
+ QPushButton *m_btn;
+ OKeyConfigItem m_item;
+ };
+
+ OItemBox::OItemBox( const OKeyConfigItem& item, QWidget* parent,
+ const char* name, WFlags fl )
+ : QHBox( parent, name, fl ), {
+ m_pix = new QLabel( this );
+ m_text = new QLabel( this );
+ m_btn = new QPushButton( this );
+
+ connect(m_btn, SIGNAL(clicked()),
+ this, SLOT(slotClicked()));
+
+ setItem( item );
+ }
+
+ OItemBox::~OItemBox() {}
+ OKeyConfigItem OItemBox::item()const{
+ return m_item;
+ }
+ void OKeyConfigItem::setItem( const OKeyConfigItem& item ) {
+ m_item = item;
+ m_pix ->setPixmap( item.pixmap() );
+ m_text->setText( item.text() );
+ m_btn->setText( keyToString( item.keyPair() ) );
+ }
+ void OKeyConfigItem::slotClicked() {
+ emit configureBox( this );
+ }
+
+ QString keyToString( const OKeyPair& pair ) {
+ QStringList mod;
+ if ( ( pair.modifier() & Qt::ShiftButton )== Qt::ShiftButton )
+ mod.append( QObject::tr( "Shift", "The Keyboard key" ) );
+ if ( ( pair.modifier() & Qt::ControlButton )== Qt::ControlButton )
+ mod.append( QObject::tr( "Ctrl", "The Ctrl key" ) );
+ if ( ( pair.modifier() & Qt::AltButton ) )== Qt::AltButton )
+ mod.append( QObject::tr( "Alt", "The keyboard Alt Key" ) );
+
+
+ }
+}
+}
+}
+
+
+
+////////////////////////
+
+
+
+#include "okeyconfigwidget.moc"
diff --git a/libopie2/opieui/okeyconfigwidget.h b/libopie2/opieui/okeyconfigwidget.h
index 0d5d26f..414ee7e 100644
--- a/libopie2/opieui/okeyconfigwidget.h
+++ b/libopie2/opieui/okeyconfigwidget.h
@@ -115,84 +115,88 @@ private:
OKeyPair m_def;
class Private;
Private *d;
};
/**
* \brief A manager to load and save Key Actions and get notified
* This is the Manager for KeyActions.
* You can say from which config and group to read data, to grab the
* keyboard to handle hardware keys, you can supply a blacklist of
* keys which should not be used by allowed to be used.
* You can even pass this manager to a Widget to do the configuration for you.
* You need to add OKeyConfigItem for your keys and then issue a load() to
* read the Key information.
* You can either handle the QKeyEvent yourself and ask this class if it is
* handled by your action and let give you the action. Or you can install
* the event filter and get a signal.
*
* @since 1.1.2
*/
class OKeyConfigManager : public QObject {
Q_OBJECT
+ typedef QMap<it, OKeyConfigItemList> OKeyMapConfigPrivate;
public:
OKeyConfigManager(Opie::Core::OConfig *conf = 0,
const QString& group = QString::null,
OKeyPairList &block = OKeyPairList(),
bool grabkeyboard = false, QObject *= 0,
const char* name = 0 );
~OKeyConfigManager();
void load();
void save();
OKeyConfigItem handleKeyEvent( QKeyEvent* );
- QString handleKeyEventString( QKeyEvent* );
+ int handleKeyEventId( QKeyEvent* );
void addKeyConfig( const OKeyConfigItem& );
void removeKeyConfig( const OKeyConfigItem& );
+ void clearKeyConfig();
- void addBlackList( const OKeyPair& );
- void removeBlackList( const OKeyPair& );
+ void addToBlackList( const OKeyPair& );
+ void removeFromBlackList( const OKeyPair& );
void clearBlackList();
OKeyPairList blackList()const;
void handleWidget( QWidget* );
bool eventFilter( QObject*, QEvent* );
signals:
void keyConfigChanged( Opie::Ui::OKeyConfigManager* );
void actionActivated( QWidget*, QKeyEvent*, const Opie::Ui::OKeyConfigItem& );
private:
+ OKeyConfigItemList keyList( int );
OKeyPairList m_blackKeys;
OKeyConfigItemList m_keys;
QValueList<QWidget*> m_widgets;
Opie::Core::OConfig *m_conf;
QString m_group;
bool m_grab : 1;
+ OKeyMapConfigPrivate *m_map;
class Private;
Private *d;
};
class OKeyConfigWidget : public QHBox {
Q_OBJECT
public:
enum ChangeMode { Imediate, Queu };
OKeyConfigWidget( QWidget* parent = 0, const char* name = 0, WFlags fl = 0 );
OKeyConfigWidget( OKeyConfigManager *, QWidget* parent = 0, const char* = 0, WFlags = 0 );
~OKeyConfigWidget();
void setChangeMode( enum ChangeMode );
ChangeMode changeMode()const;
void setKeyConfig( OKeyConfigManager* );
void reload();
void save();
private:
OKeyConfigManager* m_manager;
class Private;
Private *d;