summaryrefslogtreecommitdiff
authorzecke <zecke>2004-03-26 00:12:39 (UTC)
committer zecke <zecke>2004-03-26 00:12:39 (UTC)
commitbb64860402d6b088168927162813735eaf68e09c (patch) (unidiff)
tree849397a417bbf54ea06ea5c68065314f9cd17b08
parent98721c16aa480c4a160d3492462cb8f0de783268 (diff)
downloadopie-bb64860402d6b088168927162813735eaf68e09c.zip
opie-bb64860402d6b088168927162813735eaf68e09c.tar.gz
opie-bb64860402d6b088168927162813735eaf68e09c.tar.bz2
Some more Implementation.
Basicly all of the non GUI part is done
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
@@ -1,408 +1,705 @@
1#include "okeyconfigwidget.h" 1#include "okeyconfigwidget.h"
2 2
3 3
4 4
5 5
6using namespace Opie::Ui; 6using namespace Opie::Ui;
7 7
8 8
9/** 9/**
10 * The default Constructor of a OKeyPair. 10 * The default Constructor of a OKeyPair.
11 * A Key and a Modifier ( Alt/Shift/Ctrl ) 11 * A Key and a Modifier ( Alt/Shift/Ctrl )
12 * needs to be supplied. 12 * needs to be supplied.
13 * Use Qt::Key for the information. 13 * Use Qt::Key for the information.
14 * The default arguments create an Empty OKeyPair. If you 14 * The default arguments create an Empty OKeyPair. If you
15 * want to get an empty OKeyPair use the static method for getting 15 * want to get an empty OKeyPair use the static method for getting
16 * the emptyKey() 16 * the emptyKey()
17 * 17 *
18 * @see OKeyPair OKeyPair::emptyKey() 18 * @see OKeyPair OKeyPair::emptyKey()
19 */ 19 */
20OKeyPair::OKeyPair( int key, int mod ) 20OKeyPair::OKeyPair( int key, int mod )
21 : m_key( key ), m_mod( mod ) 21 : m_key( key ), m_mod( mod )
22{} 22{}
23 23
24/** 24/**
25 * The destructor 25 * The destructor
26 */ 26 */
27OKeyPair::~OKeyPair() {} 27OKeyPair::~OKeyPair() {}
28 28
29 29
30/** 30/**
31 * Is this OKeyPair empty/valid? 31 * Is this OKeyPair empty/valid?
32 */ 32 */
33bool OKeyPair::isEmpty()const { 33bool OKeyPair::isEmpty()const {
34 return ( ( m_key == -1 )&& ( m_mod == -1 ) ); 34 return ( ( m_key == -1 )&& ( m_mod == -1 ) );
35} 35}
36 36
37/** 37/**
38 * get the keycode for this OKeyPair. The Key relates to Qt::Key. 38 * get the keycode for this OKeyPair. The Key relates to Qt::Key.
39 * 39 *
40 * @see Qt::Key 40 * @see Qt::Key
41 * @see setKey 41 * @see setKey
42 */ 42 */
43int OKeyPair::keycode()const { 43int OKeyPair::keycode()const {
44 return m_key; 44 return m_key;
45} 45}
46 46
47/** 47/**
48 * get the modifier key for this OKeyPair. The Modifier State relates 48 * get the modifier key for this OKeyPair. The Modifier State relates
49 * to the Qt::Modifier 49 * to the Qt::ButtonState
50 * 50 *
51 * @see Qt::Modifier 51 * @see Qt::ButtonState
52 * @see setModifier 52 * @see setModifier
53 */ 53 */
54int OKeyPair::modifier()const { 54int OKeyPair::modifier()const {
55 return m_mod; 55 return m_mod;
56} 56}
57 57
58 58
59/** 59/**
60 * Set the keycode 60 * Set the keycode
61 * @param key The Keycode to set 61 * @param key The Keycode to set
62 * 62 *
63 * @see keycode() 63 * @see keycode()
64 * @see Qt::Key 64 * @see Qt::Key
65 */ 65 */
66void OKeyPair::setKeycode( int key ) { 66void OKeyPair::setKeycode( int key ) {
67 67
68} 68}
69 69
70/** 70/**
71 * Set the modifier key 71 * Set the modifier key
72 * 72 *
73 * @param the Modifier key 73 * @param the Modifier key
74 * @see Qt::Modifier 74 * @see Qt::ButtonState
75 * @see modifier() 75 * @see modifier()
76 */ 76 */
77void OKeyPair::setModifier( int mod ) { 77void OKeyPair::setModifier( int mod ) {
78 78
79} 79}
80 80
81/** 81/**
82 * Return an OKeyPair for the Return Key without any modifier. 82 * Return an OKeyPair for the Return Key without any modifier.
83 */ 83 */
84OKeyPair OKeyPair::returnKey() { 84OKeyPair OKeyPair::returnKey() {
85 return OKeyPair( Qt::Key_Return, 0 ); 85 return OKeyPair( Qt::Key_Return, 0 );
86} 86}
87 87
88/** 88/**
89 * Return an OKeyPair for the Left Arrow Key 89 * Return an OKeyPair for the Left Arrow Key
90 * without any modifier Key 90 * without any modifier Key
91 */ 91 */
92OKeyPair OKeyPair::leftArrowKey() { 92OKeyPair OKeyPair::leftArrowKey() {
93 return OKeyPair( Qt::Key_Left, 0 ); 93 return OKeyPair( Qt::Key_Left, 0 );
94} 94}
95 95
96/** 96/**
97 * Return an OKeyPair for the Right Arrow Key 97 * Return an OKeyPair for the Right Arrow Key
98 * without any modifier Key 98 * without any modifier Key
99 */ 99 */
100OKeyPair OKeyPair::rightArrowKey() { 100OKeyPair OKeyPair::rightArrowKey() {
101 return OKeyPair( Qt::Key_Right, 0 ); 101 return OKeyPair( Qt::Key_Right, 0 );
102} 102}
103 103
104/** 104/**
105 * Return an OKeyPair for the Up Arrow Key 105 * Return an OKeyPair for the Up Arrow Key
106 * without any modifier Key 106 * without any modifier Key
107 */ 107 */
108OKeyPair OKeyPair::upArrowKey() { 108OKeyPair OKeyPair::upArrowKey() {
109 return OKeyPair( Qt::Key_Up, 0 ); 109 return OKeyPair( Qt::Key_Up, 0 );
110} 110}
111 111
112/** 112/**
113 * Return an OKeyPair for the Down Arrow Key 113 * Return an OKeyPair for the Down Arrow Key
114 * without any modifier Key 114 * without any modifier Key
115 */ 115 */
116OKeyPair OKeyPair::downArrowKey() { 116OKeyPair OKeyPair::downArrowKey() {
117 return OKeyPair( Qt::Key_Down, 0 ); 117 return OKeyPair( Qt::Key_Down, 0 );
118} 118}
119 119
120/** 120/**
121 * Return an Empty OKeyPair 121 * Return an Empty OKeyPair
122 */ 122 */
123OKeyPair OKeyPair::emptyKey() { 123OKeyPair OKeyPair::emptyKey() {
124 return OKeyPair; 124 return OKeyPair;
125} 125}
126 126
127/** 127/**
128 * This functions uses the Opie::Core::ODevice::buttons 128 * This functions uses the Opie::Core::ODevice::buttons
129 * for OKeyPairList 129 * for OKeyPairList
130 * 130 *
131 * @see Opie::Core::ODevice 131 * @see Opie::Core::ODevice
132 * @see Opie::Core::ODeviceButton 132 * @see Opie::Core::ODeviceButton
133 * @see Opie::Core::ODevice::button 133 * @see Opie::Core::ODevice::button
134 */ 134 */
135OKeyPairList OKeyPair::hardwareKeys() { 135OKeyPairList OKeyPair::hardwareKeys() {
136 const QValueList<Opie::Core::ODeviceButton> but = Opie::Core::ODevice::inst()->buttons(); 136 const QValueList<Opie::Core::ODeviceButton> but = Opie::Core::ODevice::inst()->buttons();
137 OKeyPairList lst; 137 OKeyPairList lst;
138 138
139 for ( QValueList<Opie::Core::ODeviceButton>::Iterator it = but.begin(); 139 for ( QValueList<Opie::Core::ODeviceButton>::Iterator it = but.begin();
140 it != but.end(); ++it ) 140 it != but.end(); ++it )
141 lst.append( OKeyPair( (*it).keycode(), 0 ) ); 141 lst.append( OKeyPair( (*it).keycode(), 0 ) );
142 142
143 143
144 return lst; 144 return lst;
145} 145}
146 146
147/** 147/**
148 * Equals operator. Check if two OKeyPairs have the same key and modifier
149 * @see operator!=
150 */
151bool OKeyPair::operator==( const OKeyPair& pair) {
152 if ( m_key != pair.m_key ) return false;
153 if ( m_mod != pair.m_mod ) return false;
154
155 return true;
156}
157
158/**
159 * Not equal operator. calls the equal operator internally
160 */
161bool OKeyPair::operator!=( const OKeyPair& pair) {
162 return !(*this == pair);
163}
164
165
166/**
148 * The normal Constructor to create a OKeyConfigItem 167 * The normal Constructor to create a OKeyConfigItem
149 * 168 *
150 * You can set the the key paramater of this item but if 169 * You can set the the key paramater of this item but if
151 * you use this item with the OKeyConfigManager your setting 170 * you use this item with the OKeyConfigManager your setting
152 * will be overwritten. 171 * will be overwritten.
153 * 172 *
154 * @param text The text exposed to the user 173 * @param text The text exposed to the user
155 * @param config_key The key used in the config 174 * @param config_key The key used in the config
156 * @param pix A Pixmap associated with this Item 175 * @param pix A Pixmap associated with this Item
157 * @param key The OKeyPair used 176 * @param key The OKeyPair used
158 * @param def The OKeyPair used as default 177 * @param def The OKeyPair used as default
159 * 178 *
160 */ 179 */
161OKeyConfigItem::OKeyConfigItem( const QString& text, const QCString& config_key, 180OKeyConfigItem::OKeyConfigItem( const QString& text, const QCString& config_key,
162 const QPixmap& pix, int id, const OKeyPair& def, 181 const QPixmap& pix, int id, const OKeyPair& def,
163 const OKeyPair& key) 182 const OKeyPair& key)
164 : m_text( text ), m_config( config_key ), m_pix( pix ), 183 : m_text( text ), m_config( config_key ), m_pix( pix ),
165 m_id( id ), m_def( def ), m_key( key ) {} 184 m_id( id ), m_def( def ), m_key( key ) {}
166 185
167/** 186/**
168 * A special Constructor for converting from an Opie::Core::ODeviceButton 187 * A special Constructor for converting from an Opie::Core::ODeviceButton
169 * delivered by Opie::Core::ODevice::buttons() 188 * delivered by Opie::Core::ODevice::buttons()
170 * There is no Config Key set and both default key and key are set 189 * There is no Config Key set and both default key and key are set
171 * to Opie::Core::ODeviceButton::keycode() and 0 to modifier 190 * to Opie::Core::ODeviceButton::keycode() and 0 to modifier
172 * 191 *
173 * @see Opie::Core::ODevice 192 * @see Opie::Core::ODevice
174 * @see Opie::Core::ODeviceButton 193 * @see Opie::Core::ODeviceButton
175 * @see Opie::Core::ODevice::buttons() 194 * @see Opie::Core::ODevice::buttons()
176 */ 195 */
177OKeyConfigItem::OKeyConfigItem( Opie::Core::ODeviceButton& b ) 196OKeyConfigItem::OKeyConfigItem( Opie::Core::ODeviceButton& b )
178 : m_text( b.userText() ), m_pix( b.pixmap() ), m_id( -1 ) 197 : m_text( b.userText() ), m_pix( b.pixmap() ), m_id( -1 )
179 m_def( OKeyPair( b.keycode(), 0 ) ), m_key( OKeyPair( b.keycode(), 0 ) ) 198 m_def( OKeyPair( b.keycode(), 0 ) ), m_key( OKeyPair( b.keycode(), 0 ) )
180{} 199{}
181 200
182 201
183/** 202/**
184 * Destructor 203 * Destructor
185 */ 204 */
186OKeyConfigItem::~OKeyConfigItem() {} 205OKeyConfigItem::~OKeyConfigItem() {}
187 206
188 207
189/** 208/**
190 * The text exposed to the user 209 * The text exposed to the user
191 * 210 *
192 * @see setText 211 * @see setText
193 */ 212 */
194QString OKeyConfigItem::text()const { 213QString OKeyConfigItem::text()const {
195 return m_text; 214 return m_text;
196} 215}
197 216
198/** 217/**
199 * The pixmap shown to the user for your action/key 218 * The pixmap shown to the user for your action/key
200 * 219 *
201 * @see setPixmap 220 * @see setPixmap
202 */ 221 */
203QPixmap OKeyConfigItem::pixmap()const { 222QPixmap OKeyConfigItem::pixmap()const {
204 return m_pix; 223 return m_pix;
205} 224}
206 225
207/** 226/**
208 * Return the OKeyPair this OKeyConfigItem is configured for. 227 * Return the OKeyPair this OKeyConfigItem is configured for.
209 * 228 *
210 * @see setKeyPair 229 * @see setKeyPair
211 */ 230 */
212OKeyPair OKeyConfigItem::keyPair()const { 231OKeyPair OKeyConfigItem::keyPair()const {
213 return m_key; 232 return m_key;
214} 233}
215 234
216/** 235/**
217 * Return the default OKeyPair 236 * Return the default OKeyPair
218 * @see setDefaultKeyPair 237 * @see setDefaultKeyPair
219 */ 238 */
220OKeyPair OKeyConfigItem::defaultKeyPair()const { 239OKeyPair OKeyConfigItem::defaultKeyPair()const {
221 return m_def; 240 return m_def;
222} 241}
223 242
224 243
225/** 244/**
226 * Return the Id you assigned to this item. 245 * Return the Id you assigned to this item.
227 * setting is only possible by the constructor 246 * setting is only possible by the constructor
228 */ 247 */
229int OKeyConfigItem::id()const{ 248int OKeyConfigItem::id()const{
230 return m_id; 249 return m_id;
231} 250}
232 251
233/** 252/**
234 * reutrn the Config Key. Setting it is only possible 253 * reutrn the Config Key. Setting it is only possible
235 * by the constructor 254 * by the constructor
236 */ 255 */
237QCString OKeyConfigItem::configKey()const { 256QCString OKeyConfigItem::configKey()const {
238 return m_config; 257 return m_config;
239} 258}
240 259
241/** 260/**
242 * Set the text 261 * Set the text
243 * 262 *
244 * @param text Set the Text of this Action to text 263 * @param text Set the Text of this Action to text
245 * @see text() 264 * @see text()
246 */ 265 */
247void OKeyConfigItem::setText( const QString& text ) { 266void OKeyConfigItem::setText( const QString& text ) {
248 m_text = text; 267 m_text = text;
249} 268}
250 269
251/** 270/**
252 * Set the pixmap of this action 271 * Set the pixmap of this action
253 * 272 *
254 * @param pix The Pixmap to set 273 * @param pix The Pixmap to set
255 * @see pixmap() 274 * @see pixmap()
256 */ 275 */
257void OKeyConfigItem::setPixmap( const QPixmap& pix ) { 276void OKeyConfigItem::setPixmap( const QPixmap& pix ) {
258 m_pix = pix; 277 m_pix = pix;
259} 278}
260 279
261/** 280/**
262 * Set the KeyPair the OKeyConfigItem uses. 281 * Set the KeyPair the OKeyConfigItem uses.
263 * Your set Key could get overwritten if you use 282 * Your set Key could get overwritten if you use
264 * the manager or GUI to configure the key 283 * the manager or GUI to configure the key
265 * 284 *
266 * @param key Set the OKeyPair used 285 * @param key Set the OKeyPair used
267 * @see keyPair() 286 * @see keyPair()
268 */ 287 */
269void OKeyConfigItem::setKeyPair( const OKeyPair& key) { 288void OKeyConfigItem::setKeyPair( const OKeyPair& key) {
270 m_key = key; 289 m_key = key;
271} 290}
272 291
273/** 292/**
274 * Set the default KeyPair. 293 * Set the default KeyPair.
275 * 294 *
276 * @param key The default keypair 295 * @param key The default keypair
277 * @see defaultKeyPair() 296 * @see defaultKeyPair()
278 */ 297 */
279void OKeyConfigItem::setDefaultKeyPair( const OKeyPair& key ) { 298void OKeyConfigItem::setDefaultKeyPair( const OKeyPair& key ) {
280 m_def = key; 299 m_def = key;
281} 300}
282 301
283/** 302/**
284 * @internal 303 * @internal
285 */ 304 */
286void OKeyConfigItem::setConfigKey( const QCString& str) { 305void OKeyConfigItem::setConfigKey( const QCString& str) {
287 m_config = str; 306 m_config = str;
288 m_config.detach(); 307 m_config.detach();
289} 308}
290 309
291/** 310/**
292 * @internal 311 * @internal
293 */ 312 */
294void OKeyConfigItem::setId( int id ) { 313void OKeyConfigItem::setId( int id ) {
295 m_id = id; 314 m_id = id;
296} 315}
297 316
298/** 317/**
299 * If the item is not configured isEmpty() will return true 318 * If the item is not configured isEmpty() will return true
300 * It is empty if no text is present and no default 319 * It is empty if no text is present and no default
301 * and no configured key 320 * and no configured key
302 */ 321 */
303bool OKeyConfigItem::isEmpty()const { 322bool OKeyConfigItem::isEmpty()const {
304 if ( !m_def.isEmpty() ) return false; 323 if ( !m_def.isEmpty() ) return false;
305 if ( !m_key.isEmpty() ) return false; 324 if ( !m_key.isEmpty() ) return false;
306 if ( !m_text.isEmpty() ) return false; 325 if ( !m_text.isEmpty() ) return false;
307 326
308 return true; 327 return true;
309} 328}
310 329
311/** 330/**
331 * Check if the KeyPairs are the same
332 */
333bool OKeyConfigItem::operator==( const OKeyConfigItem& conf ) {
334 if ( isEmpty() == conf.isEmpty() ) return true;
335 else if ( isEmpty() != conf.isEmpty() ) return false;
336 else if ( !isEmpty()!= conf.isEmpty() ) return false;
337
338 if ( m_id != conf.m_id ) return false;
339 if ( m_text != conf.m_text ) return false;
340 if ( m_pix != conf.m_pix ) return false;
341 if ( m_key != conf.m_key ) return false;
342 if ( m_def != conf.m_def ) return false;
343
344 return true;
345
346}
347
348bool OKeyConfigItem::operator!=( const OKeyConfigItem& conf ) {
349 return !( *this == conf );
350}
351
352/**
312 * \brief c'tor 353 * \brief c'tor
313 * The Constructor for a OKeyConfigManager 354 * The Constructor for a OKeyConfigManager
314 * 355 *
315 * You can use this manager in multiple ways. Either make it handle 356 * You can use this manager in multiple ways. Either make it handle
316 * QKeyEvents 357 * QKeyEvents
317 * 358 *
318 * \code 359 * \code
319 * Opie::Core::Config conf = oApp->config(); 360 * Opie::Core::Config conf = oApp->config();
320 * Opie::Ui::OKeyPairList blackList; 361 * Opie::Ui::OKeyPairList blackList;
321 * blackList.append(Opie::Ui::OKeyPair::leftArrowKey()); 362 * blackList.append(Opie::Ui::OKeyPair::leftArrowKey());
322 * blackList.append(Opie::Ui::OKeyPair::rightArrowKey()); 363 * blackList.append(Opie::Ui::OKeyPair::rightArrowKey());
323 * Opie::Ui::OKeyConfigManager *manager = new Opie::Ui::OKeyConfigManager(conf,"key_actions",blackList, 364 * Opie::Ui::OKeyConfigManager *manager = new Opie::Ui::OKeyConfigManager(conf,"key_actions",blackList,
324 * false); 365 * false);
325 * QListView *view = new QListView(); 366 * QListView *view = new QListView();
326 * manager->handleWidget(view); 367 * manager->handleWidget(view);
327 * manager->addKeyConfig( Opie::Ui::OKeyPair::returnKey()); 368 * manager->addKeyConfig( Opie::Ui::OKeyPair::returnKey());
328 * manager->load(); 369 * manager->load();
329 * 370 *
330 * connect(manager,SIGNAL(actionActivated(QWidget*,QKeyEvent*,const Opie::Ui::OKeyConfigItem&)), 371 * connect(manager,SIGNAL(actionActivated(QWidget*,QKeyEvent*,const Opie::Ui::OKeyConfigItem&)),
331 * this,SLOT(slotHandleKey(QWidget*,QKeyEvent*,const Opie::Ui::OKeyConfigItem&))); 372 * this,SLOT(slotHandleKey(QWidget*,QKeyEvent*,const Opie::Ui::OKeyConfigItem&)));
332 * 373 *
333 * .... 374 * ....
334 * 375 *
335 * void update(){ 376 * void update(){
336 * QDialog diag(true); 377 * QDialog diag(true);
337 * QHBoxLayout *lay = new QHBoxLayout(&diag); 378 * QHBoxLayout *lay = new QHBoxLayout(&diag);
338 * Opie::Ui::OKeyConfigWidget *wid = new Opie::Ui::OKeyConfigWidget(manager,&diag); 379 * Opie::Ui::OKeyConfigWidget *wid = new Opie::Ui::OKeyConfigWidget(manager,&diag);
339 * wid->setChangeMode(Opie::Ui::OKeyConfigWidget::Queu); 380 * wid->setChangeMode(Opie::Ui::OKeyConfigWidget::Queu);
340 * lay->addWidget(wid); 381 * lay->addWidget(wid);
341 * if(QPEApplication::execDialog( &diag)== QDialog::Accept){ 382 * if(QPEApplication::execDialog( &diag)== QDialog::Accept){
342 * wid->save(); 383 * wid->save();
343 * } 384 * }
344 * } 385 * }
345 * 386 *
346 * .... 387 * ....
347 * MyListView::keyPressEvent( QKeyEvent* e ){ 388 * MyListView::keyPressEvent( QKeyEvent* e ){
348 * Opie::Ui::OKeyConfigItem item = manager->handleKeyEvent(e); 389 * Opie::Ui::OKeyConfigItem item = manager->handleKeyEvent(e);
349 * if(!item.isEmpty() ){ 390 * if(!item.isEmpty() ){
350 * switch(item.id()){ 391 * switch(item.id()){
351 * case My_Delete_Key: 392 * case My_Delete_Key:
352 * break; 393 * break;
353 * } 394 * }
354 * } 395 * }
355 * } 396 * }
356 * 397 *
357 * \endcode 398 * \endcode
358 * 399 *
359 * @param conf The Config where the KeySetting should be stored 400 * @param conf The Config where the KeySetting should be stored
360 * @param group The group where the KeySetting will be stored 401 * @param group The group where the KeySetting will be stored
361 * @param black Which keys shouldn't be allowed to handle 402 * @param black Which keys shouldn't be allowed to handle
362 * @param grabkeyboard Calls QPEApplication::grabKeyboard to allow handling of DeviceButtons 403 * @param grabkeyboard Calls QPEApplication::grabKeyboard to allow handling of DeviceButtons
363 * @param par The parent/owner of this manager 404 * @param par The parent/owner of this manager
364 * @param name The name of this object 405 * @param name The name of this object
365 */ 406 */
366OKeyConfigManager::OKeyConfigManager( Opie::Core::OConfig* conf, 407OKeyConfigManager::OKeyConfigManager( Opie::Core::OConfig* conf,
367 const QString& group, 408 const QString& group,
368 OKeyPairList black, 409 OKeyPairList black,
369 bool grabkeyboard, QObject* par, 410 bool grabkeyboard, QObject* par,
370 const char* name) 411 const char* name)
371 : QObject( par, name ), m_conf( conf ), m_group( group ), 412 : QObject( par, name ), m_conf( conf ), m_group( group ),
372 m_blackKeys( black ), m_grab( grabkeyboard ) 413 m_blackKeys( black ), m_grab( grabkeyboard ), m_map( 0 )
373{} 414{}
374 415
375 416
376/** 417/**
377 * Destructor 418 * Destructor
378 */ 419 */
379OKeyConfigWidget::~OKeyConfigWidget() {} 420OKeyConfigManager::~OKeyConfigManager() {}
380 421
381/** 422/**
382 * Load the Configuration from the OConfig 423 * Load the Configuration from the OConfig
383 * If a Key is restricted but was in the config we will 424 * If a Key is restricted but was in the config we will
384 * make the empty 425 * make it be the empty key paur
385 * We will change the group of the OConfig Item! 426 * We will change the group of the OConfig Item!
427 *
428 * @see OKeyPair::emptyKey
386 */ 429 */
387void OKeyConfigWidget::load() { 430void OKeyConfigWidget::load() {
388 m_conf->setGroup( m_group ); 431 m_conf->setGroup( m_group );
389 432
390 /* 433 /*
391 * Read each item 434 * Read each item
392 */ 435 */
393 int key, mod; 436 int key, mod;
394 for( OKeyConfigItemList::Iterator it = m_keys.begin(); 437 for( OKeyConfigItemList::Iterator it = m_keys.begin();
395 it != m_keys.end(); ++it ) { 438 it != m_keys.end(); ++it ) {
396 key = m_conf->readNumEntry( (*it).configKey()+"key", (*it).defaultKeyPair().keycode() ); 439 key = m_conf->readNumEntry( (*it).configKey()+"key", (*it).defaultKeyPair().keycode() );
397 mod = m_conf->readNumEntry( (*it).configKey()+"mod", (*it).defaultKeyPair().modifier() ); 440 mod = m_conf->readNumEntry( (*it).configKey()+"mod", (*it).defaultKeyPair().modifier() );
398 (*it).setKeyPair( OKeyPair(key, mod) ); 441 OKeyPair okey( key, mod );
442 if ( !m_blackKeys.contains( okey ) && key != -1 && mod != -1 )
443 (*it).setKeyPair( OKeyPair(key, mod) );
444 else
445 (*it).setKeyPair( OKeyPair::emptyKey() );
399 } 446 }
447 delete m_map; m_map = 0;
400} 448}
401 449
402/** 450/**
403 * We will save the current configuration 451 * We will save the current configuration
404 * to the OConfig. We will change the group. 452 * to the OConfig. We will change the group.
405 */ 453 */
406void OKeyConfigWidget::save() { 454void OKeyConfigWidget::save() {
455 m_conf->setGroup( m_group );
407 456
457 /*
458 * Write each item
459 */
460 int key, mod;
461 for( OKeyConfigItemList::Iterator it = m_keys.begin();
462 it != m_keys.end(); ++it ) {
463 if ( (*it).isEmpty() )
464 continue;
465 OKeyPair pair = (*it).keyPair();
466 m_conf->writeEntry(pair.configKey()+"key", pair.keycode() );
467 m_conf->writeEntry(pair.configKey()+"mod", pair.modifier() );
468 }
408} 469}
470
471/**
472 * This is function uses a QMap internally but you can have the same keycode
473 * with different modifier key. The behaviour is undefined if you add a OKeyConfigItem
474 * with same keycode and modifier key. The GUI takes care that a user can't
475 * cofigure two keys.
476 *
477 * Make sure you call e->ignore if you don't want to handle this event
478 */
479OKeyConfigItem OKeyConfigManager::handleKeyEvent( QKeyEvent* e ) {
480 OKeyConfigItemList keyList = keyList( e->key() );
481 if ( keyList.isEmpty() )
482 return OKeyConfigItem();
483
484 OKeyConfigItem item;
485 for ( OKeyConfigItemList::Iterator it = keyList.begin(); it != keyList.end();
486 ++it ) {
487 if ( (*it).keyPair().modifier() == e->state() ) {
488 item = *it;
489 break;
490 }
491
492 }
493
494 return item;
495}
496
497/**
498 * Return the associated id of the item or -1 if no item
499 * matched the key
500 *
501 * @see handleKeyEvent
502 */
503int OKeyConfigManager::handleKeyEventId( QKeyEvent* ev) {
504 return handleKeyEvent( ev ).id();
505}
506
507/**
508 * Add Key Config to the List of items
509 */
510void OKeyConfigManager::addKeyConfig( const OKeyConfigItem& item ) {
511 m_keys.append( item );
512 delete m_map; m_map = 0;
513}
514
515/**
516 * Remove the Key from the Config. Internal lists will be destroyed
517 * and rebuild on demand later
518 */
519void OKeyConfigManager::removeKeyConfig( const OKeyConfigItem& item ) {
520 m_keys.remove( item );
521 delete m_map; m_map = 0;
522}
523
524/**
525 * Clears the complete list
526 */
527void OKeyConfigManager::clearKeyConfig() {
528 m_keys.clear();
529 delete m_map; m_map = 0;
530}
531
532
533/**
534 * Add this OKeyPair to the blackList.
535 * Internal lists will be destroyed
536 */
537void OKeyConfigManager::addToBlackList( const OKeyPair& key) {
538 m_blackKeys.append( key );
539 delete m_map; m_map = 0;
540}
541
542
543/**
544 * Remove this OKeyPair from the black List
545 * Internal lists will be destroyed
546 */
547void OKeyConfigManager::removeFromBlackList( const OKeyPair& key ) {
548 m_blackKeys.remove( key );
549 delete m_map; m_map = 0;
550}
551
552
553/**
554 * Clear the blackList
555 */
556void OKeyConfigManager::clearBlackList() {
557 m_blackKeys.clear();
558 delete m_map; m_map = 0;
559}
560
561
562/**
563 * Return a copy of the blackList
564 */
565OKeyPairList OKeyConfigManager::blackList()const {
566 return m_blackKeys;
567}
568
569
570/**
571 * Ask the Manager to handle KeyEvents for you.
572 * All handled keys will emit a QSignal and return true
573 * that it handled the keyevent
574 */
575void OKeyConfigManager::handleWidget( QWidget* wid ) {
576 wid->installEventFilter( this );
577}
578
579/**
580 * @internal
581 */
582bool OKeyConfigManager::eventFilter( QObject* obj, QEvent* ev) {
583 if ( !obj->isWidgetType() )
584 return false;
585
586 if ( ev->type() != QEvent::KeyPress && ev->type() != QEvent::KeyRelease )
587 return false;
588
589 QKeyEvent *key = static_cast<QKeyEvent*>( ev );
590 OKeyConfigItem item = handleKeyEvent( key );
591
592 if ( item.isEmpty() )
593 return false;
594
595 emit actionActivated( static_cast<QWidget*>( obj ), key, item );
596 return true;
597}
598
599/**
600 * @internal
601 */
602OKeyConfigItemList OKeyConfigManager::keyList( int keycode) {
603 if ( !m_map ) {
604 m_map = new OKeyMapConfigPrivate;
605 /* for every key */
606 for ( OKeyConfigItemList::Iterator it = m_keys.begin();
607 it!= m_keys.end(); ++it ) {
608 bool add = true;
609 /* see if this key is blocked */
610 for ( OKeyPairList::Iterator pairIt = m_blackKeys.begin();
611 pairIt != m_blackKeys.end(); ++pairIt ) {
612 if ( (*pairIt).keycode() == (*it).keycode() &&
613 (*pairIt).modifier() == (*it).modifier() ) {
614 add = false;
615 break;
616 }
617 }
618 /* check if we added it */
619 if ( add ) {
620 if ( m_map->contains( (*it).keycode() ) )
621 (m_map[(*it).keycode()]).append( *it );
622 else
623 m_map.insert( (*it).keycode(), OKeyConfigItemList( *it ) );
624 }
625 }
626 }
627 return m_map[keycode];
628}
629
630
631
632/////////////////////////
633//////// Widget Starts Here
634namespace Opie {
635namespace Ui {
636namespace Private {
637 static QString keyToString( const OKeyPair& );
638 class OItemBox : public QHBox {
639 Q_OBJECT
640 public:
641 OItemBox( const OKeyConfigItem& item, QWidget* parent = 0, const char* name = 0, WFlags fl = 0);
642 ~OItemBox();
643
644 OKeyConfigItem item()const;
645 void setItem( const OKeyConfigItem& item );
646 private slots:
647 void slotClicked();
648 signals:
649 void configureBox( OItemBox* );
650 private:
651 QLabel *m_pix;
652 QLabel *m_text;
653 QPushButton *m_btn;
654 OKeyConfigItem m_item;
655 };
656
657 OItemBox::OItemBox( const OKeyConfigItem& item, QWidget* parent,
658 const char* name, WFlags fl )
659 : QHBox( parent, name, fl ), {
660 m_pix = new QLabel( this );
661 m_text = new QLabel( this );
662 m_btn = new QPushButton( this );
663
664 connect(m_btn, SIGNAL(clicked()),
665 this, SLOT(slotClicked()));
666
667 setItem( item );
668 }
669
670 OItemBox::~OItemBox() {}
671 OKeyConfigItem OItemBox::item()const{
672 return m_item;
673 }
674 void OKeyConfigItem::setItem( const OKeyConfigItem& item ) {
675 m_item = item;
676 m_pix ->setPixmap( item.pixmap() );
677 m_text->setText( item.text() );
678 m_btn->setText( keyToString( item.keyPair() ) );
679 }
680 void OKeyConfigItem::slotClicked() {
681 emit configureBox( this );
682 }
683
684 QString keyToString( const OKeyPair& pair ) {
685 QStringList mod;
686 if ( ( pair.modifier() & Qt::ShiftButton )== Qt::ShiftButton )
687 mod.append( QObject::tr( "Shift", "The Keyboard key" ) );
688 if ( ( pair.modifier() & Qt::ControlButton )== Qt::ControlButton )
689 mod.append( QObject::tr( "Ctrl", "The Ctrl key" ) );
690 if ( ( pair.modifier() & Qt::AltButton ) )== Qt::AltButton )
691 mod.append( QObject::tr( "Alt", "The keyboard Alt Key" ) );
692
693
694 }
695}
696}
697}
698
699
700
701////////////////////////
702
703
704
705#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
@@ -1,205 +1,209 @@
1/* 1/*
2 * Copyright (C) 2004 2 * Copyright (C) 2004
3 * LGPL v2 zecke@handhelds.org 3 * LGPL v2 zecke@handhelds.org
4 */ 4 */
5 5
6 6
7#ifndef ODP_KEY_CONFIG_WIDGET_H 7#ifndef ODP_KEY_CONFIG_WIDGET_H
8#define ODP_KEY_CONFIG_WIDGET_H 8#define ODP_KEY_CONFIG_WIDGET_H
9 9
10#include <opie2/oconfig.h> 10#include <opie2/oconfig.h>
11#include <opie2/odevice.h> 11#include <opie2/odevice.h>
12 12
13#include <qstring.h> 13#include <qstring.h>
14#include <qpixmap.h> 14#include <qpixmap.h>
15#include <qbytearray.h> 15#include <qbytearray.h>
16#include <qhbox.h> 16#include <qhbox.h>
17#include <qvaluelist.h> 17#include <qvaluelist.h>
18 18
19class QKeyEvent; 19class QKeyEvent;
20 20
21namespace Opie { 21namespace Opie {
22namespace Ui { 22namespace Ui {
23 23
24 24
25/** 25/**
26 * \brief small class representing a Key with possible modifiers 26 * \brief small class representing a Key with possible modifiers
27 * This class holds information about key code and possible 27 * This class holds information about key code and possible
28 * modifier state. That is the lowest level of the key input 28 * modifier state. That is the lowest level of the key input
29 * functions. 29 * functions.
30 * There are also static methods to get special keys. 30 * There are also static methods to get special keys.
31 * OKeyPair will be used with \see OKeyConfigItem 31 * OKeyPair will be used with \see OKeyConfigItem
32 * 32 *
33 * @since 1.2 33 * @since 1.2
34 */ 34 */
35class OKeyPair { 35class OKeyPair {
36public: 36public:
37 typedef QValueList<OKeyPair> OKeyPairList; 37 typedef QValueList<OKeyPair> OKeyPairList;
38 OKeyPair( int key = -1, int modifier = -1); 38 OKeyPair( int key = -1, int modifier = -1);
39 ~OKeyPair(); 39 ~OKeyPair();
40 40
41 bool operator==( const OKeyPair& ); 41 bool operator==( const OKeyPair& );
42 bool operator!=( const OKeyPair& ); 42 bool operator!=( const OKeyPair& );
43 43
44 bool isEmpty()const; 44 bool isEmpty()const;
45 45
46 int keycode()const; 46 int keycode()const;
47 int modifier()const; 47 int modifier()const;
48 48
49 void setKeycode( int ); 49 void setKeycode( int );
50 void setModifier( int ); 50 void setModifier( int );
51 51
52 static OKeyPair returnKey(); 52 static OKeyPair returnKey();
53 static OKeyPair leftArrowKey(); 53 static OKeyPair leftArrowKey();
54 static OKeyPair rightArrowKey(); 54 static OKeyPair rightArrowKey();
55 static OKeyPair upArrowKey(); 55 static OKeyPair upArrowKey();
56 static OKeyPair downArrowKey(); 56 static OKeyPair downArrowKey();
57 static OKeyPair emptyKey(); 57 static OKeyPair emptyKey();
58 static OKeyPairList hardwareKeys(); 58 static OKeyPairList hardwareKeys();
59 59
60private: 60private:
61 int m_key = -1; 61 int m_key = -1;
62 int m_mod = -1; 62 int m_mod = -1;
63 class Private; 63 class Private;
64 Private* d; 64 Private* d;
65}; 65};
66 66
67/** 67/**
68 * A class to represent an OKeyPair. 68 * A class to represent an OKeyPair.
69 * It consists out of a Text exposed to the user, Config Key Item, 69 * It consists out of a Text exposed to the user, Config Key Item,
70 * Pixmap, A default OKeyPair and the set OKeyPair. 70 * Pixmap, A default OKeyPair and the set OKeyPair.
71 * You can also pass an id to it 71 * You can also pass an id to it
72 * 72 *
73 * @since 1.1.2 73 * @since 1.1.2
74 */ 74 */
75class OKeyConfigItem { 75class OKeyConfigItem {
76 friend class OKeyConfigManager; 76 friend class OKeyConfigManager;
77public: 77public:
78 typedef QValueList<OKeyConfigItem> OKeyConfigItemList; 78 typedef QValueList<OKeyConfigItem> OKeyConfigItemList;
79 OKeyConfigItem( const QString& text = QString::null , const QCString& config_key = QCString(), 79 OKeyConfigItem( const QString& text = QString::null , const QCString& config_key = QCString(),
80 const QPixmap& symbol = QPixmap(), 80 const QPixmap& symbol = QPixmap(),
81 int id = -1, 81 int id = -1,
82 const OKeyPair& set = OKeyPair::emptyKey(), 82 const OKeyPair& set = OKeyPair::emptyKey(),
83 const OKeyPair& def = OKeyPair::emptyKey() ); 83 const OKeyPair& def = OKeyPair::emptyKey() );
84 OKeyConfigItem( const Opie::Core::ODeviceButton& ); 84 OKeyConfigItem( const Opie::Core::ODeviceButton& );
85 ~OKeyConfigItem(); 85 ~OKeyConfigItem();
86 86
87 bool operator==( const OKeyConfigItem& ); 87 bool operator==( const OKeyConfigItem& );
88 bool operator!=( const OKeyConfigItem& ); 88 bool operator!=( const OKeyConfigItem& );
89 89
90 QString text()const; 90 QString text()const;
91 QPixmap pixmap()const; 91 QPixmap pixmap()const;
92 int id()const; 92 int id()const;
93 93
94 OKeyPair keyPair()const; 94 OKeyPair keyPair()const;
95 OKeyPair defaultKeyPair()const; 95 OKeyPair defaultKeyPair()const;
96 QCString configKey()const; 96 QCString configKey()const;
97 97
98 void setText( const QString& text ); 98 void setText( const QString& text );
99 void setPixmap( const QPixmap& ); 99 void setPixmap( const QPixmap& );
100 void setKeyPair( const OKeyPair& ); 100 void setKeyPair( const OKeyPair& );
101 void setDefaultKeyPair( const OKeyPair& ); 101 void setDefaultKeyPair( const OKeyPair& );
102 102
103 bool isEmpty()const; 103 bool isEmpty()const;
104 104
105protected: 105protected:
106 void setId( int id ); 106 void setId( int id );
107 void setConfigKey( const QCString& ); 107 void setConfigKey( const QCString& );
108 108
109private: 109private:
110 int m_id; 110 int m_id;
111 QString m_text; 111 QString m_text;
112 QCString m_config; 112 QCString m_config;
113 QPixmap m_pix; 113 QPixmap m_pix;
114 OKeyPair m_key; 114 OKeyPair m_key;
115 OKeyPair m_def; 115 OKeyPair m_def;
116 class Private; 116 class Private;
117 Private *d; 117 Private *d;
118}; 118};
119 119
120 120
121 121
122/** 122/**
123 * \brief A manager to load and save Key Actions and get notified 123 * \brief A manager to load and save Key Actions and get notified
124 * This is the Manager for KeyActions. 124 * This is the Manager for KeyActions.
125 * You can say from which config and group to read data, to grab the 125 * You can say from which config and group to read data, to grab the
126 * keyboard to handle hardware keys, you can supply a blacklist of 126 * keyboard to handle hardware keys, you can supply a blacklist of
127 * keys which should not be used by allowed to be used. 127 * keys which should not be used by allowed to be used.
128 * You can even pass this manager to a Widget to do the configuration for you. 128 * You can even pass this manager to a Widget to do the configuration for you.
129 * You need to add OKeyConfigItem for your keys and then issue a load() to 129 * You need to add OKeyConfigItem for your keys and then issue a load() to
130 * read the Key information. 130 * read the Key information.
131 * You can either handle the QKeyEvent yourself and ask this class if it is 131 * You can either handle the QKeyEvent yourself and ask this class if it is
132 * handled by your action and let give you the action. Or you can install 132 * handled by your action and let give you the action. Or you can install
133 * the event filter and get a signal. 133 * the event filter and get a signal.
134 * 134 *
135 * @since 1.1.2 135 * @since 1.1.2
136 */ 136 */
137class OKeyConfigManager : public QObject { 137class OKeyConfigManager : public QObject {
138 Q_OBJECT 138 Q_OBJECT
139 typedef QMap<it, OKeyConfigItemList> OKeyMapConfigPrivate;
139public: 140public:
140 OKeyConfigManager(Opie::Core::OConfig *conf = 0, 141 OKeyConfigManager(Opie::Core::OConfig *conf = 0,
141 const QString& group = QString::null, 142 const QString& group = QString::null,
142 OKeyPairList &block = OKeyPairList(), 143 OKeyPairList &block = OKeyPairList(),
143 bool grabkeyboard = false, QObject *= 0, 144 bool grabkeyboard = false, QObject *= 0,
144 const char* name = 0 ); 145 const char* name = 0 );
145 ~OKeyConfigManager(); 146 ~OKeyConfigManager();
146 147
147 void load(); 148 void load();
148 void save(); 149 void save();
149 150
150 OKeyConfigItem handleKeyEvent( QKeyEvent* ); 151 OKeyConfigItem handleKeyEvent( QKeyEvent* );
151 QString handleKeyEventString( QKeyEvent* ); 152 int handleKeyEventId( QKeyEvent* );
152 153
153 void addKeyConfig( const OKeyConfigItem& ); 154 void addKeyConfig( const OKeyConfigItem& );
154 void removeKeyConfig( const OKeyConfigItem& ); 155 void removeKeyConfig( const OKeyConfigItem& );
156 void clearKeyConfig();
155 157
156 void addBlackList( const OKeyPair& ); 158 void addToBlackList( const OKeyPair& );
157 void removeBlackList( const OKeyPair& ); 159 void removeFromBlackList( const OKeyPair& );
158 void clearBlackList(); 160 void clearBlackList();
159 OKeyPairList blackList()const; 161 OKeyPairList blackList()const;
160 162
161 void handleWidget( QWidget* ); 163 void handleWidget( QWidget* );
162 164
163 bool eventFilter( QObject*, QEvent* ); 165 bool eventFilter( QObject*, QEvent* );
164signals: 166signals:
165 void keyConfigChanged( Opie::Ui::OKeyConfigManager* ); 167 void keyConfigChanged( Opie::Ui::OKeyConfigManager* );
166 void actionActivated( QWidget*, QKeyEvent*, const Opie::Ui::OKeyConfigItem& ); 168 void actionActivated( QWidget*, QKeyEvent*, const Opie::Ui::OKeyConfigItem& );
167 169
168private: 170private:
171 OKeyConfigItemList keyList( int );
169 OKeyPairList m_blackKeys; 172 OKeyPairList m_blackKeys;
170 OKeyConfigItemList m_keys; 173 OKeyConfigItemList m_keys;
171 QValueList<QWidget*> m_widgets; 174 QValueList<QWidget*> m_widgets;
172 Opie::Core::OConfig *m_conf; 175 Opie::Core::OConfig *m_conf;
173 QString m_group; 176 QString m_group;
174 bool m_grab : 1; 177 bool m_grab : 1;
178 OKeyMapConfigPrivate *m_map;
175 class Private; 179 class Private;
176 Private *d; 180 Private *d;
177}; 181};
178 182
179 183
180class OKeyConfigWidget : public QHBox { 184class OKeyConfigWidget : public QHBox {
181 Q_OBJECT 185 Q_OBJECT
182public: 186public:
183 enum ChangeMode { Imediate, Queu }; 187 enum ChangeMode { Imediate, Queu };
184 OKeyConfigWidget( QWidget* parent = 0, const char* name = 0, WFlags fl = 0 ); 188 OKeyConfigWidget( QWidget* parent = 0, const char* name = 0, WFlags fl = 0 );
185 OKeyConfigWidget( OKeyConfigManager *, QWidget* parent = 0, const char* = 0, WFlags = 0 ); 189 OKeyConfigWidget( OKeyConfigManager *, QWidget* parent = 0, const char* = 0, WFlags = 0 );
186 ~OKeyConfigWidget(); 190 ~OKeyConfigWidget();
187 191
188 void setChangeMode( enum ChangeMode ); 192 void setChangeMode( enum ChangeMode );
189 ChangeMode changeMode()const; 193 ChangeMode changeMode()const;
190 194
191 void setKeyConfig( OKeyConfigManager* ); 195 void setKeyConfig( OKeyConfigManager* );
192 196
193 void reload(); 197 void reload();
194 void save(); 198 void save();
195private: 199private:
196 OKeyConfigManager* m_manager; 200 OKeyConfigManager* m_manager;
197 class Private; 201 class Private;
198 Private *d; 202 Private *d;
199}; 203};
200 204
201} 205}
202} 206}
203 207
204 208
205#endif 209#endif