00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020 #include "kactionselector.h"
00021
00022 #include <klocale.h>
00023 #include <kiconloader.h>
00024 #include <kdialog.h>
00025 #include <kdebug.h>
00026 #include <qapplication.h>
00027
00028 #include <qlistbox.h>
00029 #include <qtoolbutton.h>
00030 #include <qlabel.h>
00031 #include <qlayout.h>
00032 #include <qevent.h>
00033 #include <qwhatsthis.h>
00034
00035 class KActionSelectorPrivate {
00036 public:
00037 QListBox *availableListBox, *selectedListBox;
00038 QToolButton *btnAdd, *btnRemove, *btnUp, *btnDown;
00039 QLabel *lAvailable, *lSelected;
00040 bool moveOnDoubleClick, keyboardEnabled;
00041 KActionSelector::ButtonIconSize iconSize;
00042 QString addIcon, removeIcon, upIcon, downIcon;
00043 KActionSelector::InsertionPolicy availableInsertionPolicy, selectedInsertionPolicy;
00044 bool showUpDownButtons;
00045 };
00046
00047
00048
00049 KActionSelector::KActionSelector( QWidget *parent, const char *name )
00050 : QWidget( parent, name )
00051 {
00052 d = new KActionSelectorPrivate();
00053 d->moveOnDoubleClick = true;
00054 d->keyboardEnabled = true;
00055 d->iconSize = SmallIcon;
00056 d->addIcon = QApplication::reverseLayout() ? "back" : "forward";
00057 d->removeIcon = QApplication::reverseLayout() ? "forward" : "back";
00058 d->upIcon = "up";
00059 d->downIcon = "down";
00060 d->availableInsertionPolicy = Sorted;
00061 d->selectedInsertionPolicy = BelowCurrent;
00062 d->showUpDownButtons = true;
00063
00064
00065
00066 QHBoxLayout *lo = new QHBoxLayout( this );
00067 lo->setSpacing( KDialog::spacingHint() );
00068
00069 QVBoxLayout *loAv = new QVBoxLayout( lo );
00070 d->lAvailable = new QLabel( i18n("&Available:"), this );
00071 loAv->addWidget( d->lAvailable );
00072 d->availableListBox = new QListBox( this );
00073 loAv->addWidget( d->availableListBox );
00074 d->lAvailable->setBuddy( d->availableListBox );
00075
00076 QVBoxLayout *loHBtns = new QVBoxLayout( lo );
00077 loHBtns->addStretch( 1 );
00078 d->btnAdd = new QToolButton( this );
00079 loHBtns->addWidget( d->btnAdd );
00080 d->btnRemove = new QToolButton( this );
00081 loHBtns->addWidget( d->btnRemove );
00082 loHBtns->addStretch( 1 );
00083
00084 QVBoxLayout *loS = new QVBoxLayout( lo );
00085 d->lSelected = new QLabel( i18n("&Selected:"), this );
00086 loS->addWidget( d->lSelected );
00087 d->selectedListBox = new QListBox( this );
00088 loS->addWidget( d->selectedListBox );
00089 d->lSelected->setBuddy( d->selectedListBox );
00090
00091 QVBoxLayout *loVBtns = new QVBoxLayout( lo );
00092 loVBtns->addStretch( 1 );
00093 d->btnUp = new QToolButton( this );
00094 loVBtns->addWidget( d->btnUp );
00095 d->btnDown = new QToolButton( this );
00096 loVBtns->addWidget( d->btnDown );
00097 loVBtns->addStretch( 1 );
00098
00099 loadIcons();
00100
00101 connect( d->btnAdd, SIGNAL(clicked()), this, SLOT(buttonAddClicked()) );
00102 connect( d->btnRemove, SIGNAL(clicked()), this, SLOT(buttonRemoveClicked()) );
00103 connect( d->btnUp, SIGNAL(clicked()), this, SLOT(buttonUpClicked()) );
00104 connect( d->btnDown, SIGNAL(clicked()), this, SLOT(buttonDownClicked()) );
00105 connect( d->availableListBox, SIGNAL(doubleClicked(QListBoxItem*)),
00106 this, SLOT(itemDoubleClicked(QListBoxItem*)) );
00107 connect( d->selectedListBox, SIGNAL(doubleClicked(QListBoxItem*)),
00108 this, SLOT(itemDoubleClicked(QListBoxItem*)) );
00109 connect( d->availableListBox, SIGNAL(currentChanged(QListBoxItem*)),
00110 this, SLOT(slotCurrentChanged(QListBoxItem *)) );
00111 connect( d->selectedListBox, SIGNAL(currentChanged(QListBoxItem*)),
00112 this, SLOT(slotCurrentChanged(QListBoxItem *)) );
00113
00114 d->availableListBox->installEventFilter( this );
00115 d->selectedListBox->installEventFilter( this );
00116 }
00117
00118 KActionSelector::~KActionSelector()
00119 {
00120 delete d;
00121 }
00122
00123
00124
00125
00126
00127 QListBox *KActionSelector::availableListBox()
00128 {
00129 return d->availableListBox;
00130 }
00131
00132 QListBox *KActionSelector::selectedListBox()
00133 {
00134 return d->selectedListBox;
00135 }
00136
00137 void KActionSelector::setButtonIcon( const QString &icon, MoveButton button )
00138 {
00139 switch ( button )
00140 {
00141 case ButtonAdd:
00142 d->addIcon = icon;
00143 d->btnAdd->setIconSet( SmallIconSet( icon, d->iconSize ) );
00144 break;
00145 case ButtonRemove:
00146 d->removeIcon = icon;
00147 d->btnRemove->setIconSet( SmallIconSet( icon, d->iconSize ) );
00148 break;
00149 case ButtonUp:
00150 d->upIcon = icon;
00151 d->btnUp->setIconSet( SmallIconSet( icon, d->iconSize ) );
00152 break;
00153 case ButtonDown:
00154 d->downIcon = icon;
00155 d->btnDown->setIconSet( SmallIconSet( icon, d->iconSize ) );
00156 break;
00157 default:
00158 kdDebug()<<"KActionSelector::setButtonIcon: DAINBREAD!"<<endl;
00159 }
00160 }
00161
00162 void KActionSelector::setButtonIconSet( const QIconSet &iconset, MoveButton button )
00163 {
00164 switch ( button )
00165 {
00166 case ButtonAdd:
00167 d->btnAdd->setIconSet( iconset );
00168 break;
00169 case ButtonRemove:
00170 d->btnRemove->setIconSet( iconset );
00171 break;
00172 case ButtonUp:
00173 d->btnUp->setIconSet( iconset );
00174 break;
00175 case ButtonDown:
00176 d->btnDown->setIconSet( iconset );
00177 break;
00178 default:
00179 kdDebug()<<"KActionSelector::setButtonIconSet: DAINBREAD!"<<endl;
00180 }
00181 }
00182
00183 void KActionSelector::setButtonTooltip( const QString &tip, MoveButton button )
00184 {
00185 switch ( button )
00186 {
00187 case ButtonAdd:
00188 d->btnAdd->setTextLabel( tip );
00189 break;
00190 case ButtonRemove:
00191 d->btnRemove->setTextLabel( tip );
00192 break;
00193 case ButtonUp:
00194 d->btnUp->setTextLabel( tip );
00195 break;
00196 case ButtonDown:
00197 d->btnDown->setTextLabel( tip );
00198 break;
00199 default:
00200 kdDebug()<<"KActionSelector::setButtonToolTip: DAINBREAD!"<<endl;
00201 }
00202 }
00203
00204 void KActionSelector::setButtonWhatsThis( const QString &text, MoveButton button )
00205 {
00206 switch ( button )
00207 {
00208 case ButtonAdd:
00209 QWhatsThis::add( d->btnAdd, text );
00210 break;
00211 case ButtonRemove:
00212 QWhatsThis::add( d->btnRemove, text );
00213 break;
00214 case ButtonUp:
00215 QWhatsThis::add( d->btnUp, text );
00216 break;
00217 case ButtonDown:
00218 QWhatsThis::add( d->btnDown, text );
00219 break;
00220 default:
00221 kdDebug()<<"KActionSelector::setButtonWhatsThis: DAINBREAD!"<<endl;
00222 }
00223 }
00224
00225 void KActionSelector::setButtonsEnabled()
00226 {
00227 d->btnAdd->setEnabled( d->availableListBox->currentItem() > -1 );
00228 d->btnRemove->setEnabled( d->selectedListBox->currentItem() > -1 );
00229 d->btnUp->setEnabled( d->selectedListBox->currentItem() > 0 );
00230 d->btnDown->setEnabled( d->selectedListBox->currentItem() > -1 &&
00231 d->selectedListBox->currentItem() < (int)d->selectedListBox->count() - 1 );
00232 }
00233
00234
00235
00236
00237
00238 bool KActionSelector::moveOnDoubleClick() const
00239 {
00240 return d->moveOnDoubleClick;
00241 }
00242
00243 void KActionSelector::setMoveOnDoubleClick( bool b )
00244 {
00245 d->moveOnDoubleClick = b;
00246 }
00247
00248 bool KActionSelector::keyboardEnabled() const
00249 {
00250 return d->keyboardEnabled;
00251 }
00252
00253 void KActionSelector::setKeyboardEnabled( bool b )
00254 {
00255 d->keyboardEnabled = b;
00256 }
00257
00258 QString KActionSelector::availableLabel() const
00259 {
00260 return d->lAvailable->text();
00261 }
00262
00263 void KActionSelector::setAvailableLabel( const QString &text )
00264 {
00265 d->lAvailable->setText( text );
00266 }
00267
00268 QString KActionSelector::selectedLabel() const
00269 {
00270 return d->lSelected->text();
00271 }
00272
00273 void KActionSelector::setSelectedLabel( const QString &text )
00274 {
00275 d->lSelected->setText( text );
00276 }
00277
00278 KActionSelector::ButtonIconSize KActionSelector::buttonIconSize() const
00279 {
00280 return d->iconSize;
00281 }
00282
00283 void KActionSelector::setButtonIconSize( ButtonIconSize size )
00284 {
00285 d->iconSize = size;
00286
00287 loadIcons();
00288 }
00289
00290 KActionSelector::InsertionPolicy KActionSelector::availableInsertionPolicy()
00291 {
00292 return d->availableInsertionPolicy;
00293 }
00294
00295 void KActionSelector::setAvailableInsertionPolicy( InsertionPolicy p )
00296 {
00297 d->availableInsertionPolicy = p;
00298 }
00299
00300 KActionSelector::InsertionPolicy KActionSelector::selectedInsertionPolicy()
00301 {
00302 return d->selectedInsertionPolicy;
00303 }
00304
00305 void KActionSelector::setSelectedInsertionPolicy( InsertionPolicy p )
00306 {
00307 d->selectedInsertionPolicy = p;
00308 }
00309
00310 bool KActionSelector::showUpDownButtons()
00311 {
00312 return d->showUpDownButtons;
00313 }
00314
00315 void KActionSelector::setShowUpDownButtons( bool show )
00316 {
00317 d->showUpDownButtons = show;
00318 if ( show )
00319 {
00320 d->btnUp->show();
00321 d->btnDown->show();
00322 }
00323 else
00324 {
00325 d->btnUp->hide();
00326 d->btnDown->hide();
00327 }
00328 }
00329
00330
00331
00332
00333
00334 void KActionSelector::polish()
00335 {
00336 setButtonsEnabled();
00337 }
00338
00339
00340
00341
00342 void KActionSelector::keyPressEvent( QKeyEvent *e )
00343 {
00344 if ( ! d->keyboardEnabled ) return;
00345 if ( (e->state() & Qt::ControlButton) )
00346 {
00347 switch ( e->key() )
00348 {
00349 case Key_Right:
00350 buttonAddClicked();
00351 break;
00352 case Key_Left:
00353 buttonRemoveClicked();
00354 break;
00355 case Key_Up:
00356 buttonUpClicked();
00357 break;
00358 case Key_Down:
00359 buttonDownClicked();
00360 break;
00361 default:
00362 e->ignore();
00363 return;
00364 }
00365 }
00366 }
00367
00368 bool KActionSelector::eventFilter( QObject *o, QEvent *e )
00369 {
00370 if ( d->keyboardEnabled && e->type() == QEvent::KeyPress )
00371 {
00372 if ( (((QKeyEvent*)e)->state() & Qt::ControlButton) )
00373 {
00374 switch ( ((QKeyEvent*)e)->key() )
00375 {
00376 case Key_Right:
00377 buttonAddClicked();
00378 break;
00379 case Key_Left:
00380 buttonRemoveClicked();
00381 break;
00382 case Key_Up:
00383 buttonUpClicked();
00384 break;
00385 case Key_Down:
00386 buttonDownClicked();
00387 break;
00388 default:
00389 return QWidget::eventFilter( o, e );
00390 break;
00391 }
00392 return true;
00393 }
00394 else if ( o->inherits( "QListBox" ) )
00395 {
00396 switch ( ((QKeyEvent*)e)->key() )
00397 {
00398 case Key_Return:
00399 case Key_Enter:
00400 QListBox *lb = (QListBox*)o;
00401 int index = lb->currentItem();
00402 if ( index < 0 ) break;
00403 moveItem( lb->item( index ) );
00404 return true;
00405 }
00406 }
00407 }
00408 return QWidget::eventFilter( o, e );
00409 }
00410
00411
00412
00413
00414
00415 void KActionSelector::buttonAddClicked()
00416 {
00417
00418 QListBoxItem *item = d->availableListBox->firstItem();
00419 while ( item ) {
00420 if ( item->isSelected() ) {
00421 d->availableListBox->takeItem( item );
00422 d->selectedListBox->insertItem( item, insertionIndex( d->selectedListBox, d->selectedInsertionPolicy ) );
00423 d->selectedListBox->setCurrentItem( item );
00424 emit added( item );
00425 }
00426 item = item->next();
00427 }
00428 if ( d->selectedInsertionPolicy == Sorted )
00429 d->selectedListBox->sort();
00430 d->selectedListBox->setFocus();
00431 }
00432
00433 void KActionSelector::buttonRemoveClicked()
00434 {
00435
00436 QListBoxItem *item = d->selectedListBox->firstItem();
00437 while ( item ) {
00438 if ( item->isSelected() ) {
00439 d->selectedListBox->takeItem( item );
00440 d->availableListBox->insertItem( item, insertionIndex( d->availableListBox, d->availableInsertionPolicy ) );
00441 d->availableListBox->setCurrentItem( item );
00442 emit removed( item );
00443 }
00444 item = item->next();
00445 }
00446 if ( d->availableInsertionPolicy == Sorted )
00447 d->availableListBox->sort();
00448 d->availableListBox->setFocus();
00449 }
00450
00451 void KActionSelector::buttonUpClicked()
00452 {
00453 int c = d->selectedListBox->currentItem();
00454 if ( c < 0 ) return;
00455 QListBoxItem *item = d->selectedListBox->item( c );
00456 d->selectedListBox->takeItem( item );
00457 d->selectedListBox->insertItem( item, c-1 );
00458 d->selectedListBox->setCurrentItem( item );
00459 emit movedUp( item );
00460 }
00461
00462 void KActionSelector::buttonDownClicked()
00463 {
00464 int c = d->selectedListBox->currentItem();
00465 if ( c < 0 ) return;
00466 QListBoxItem *item = d->selectedListBox->item( c );
00467 d->selectedListBox->takeItem( item );
00468 d->selectedListBox->insertItem( item, c+1 );
00469 d->selectedListBox->setCurrentItem( item );
00470 emit movedDown( item );
00471 }
00472
00473 void KActionSelector::itemDoubleClicked( QListBoxItem *item )
00474 {
00475 if ( d->moveOnDoubleClick )
00476 moveItem( item );
00477 }
00478
00479
00480
00481
00482
00483 void KActionSelector::loadIcons()
00484 {
00485 d->btnAdd->setIconSet( SmallIconSet( d->addIcon, d->iconSize ) );
00486 d->btnRemove->setIconSet( SmallIconSet( d->removeIcon, d->iconSize ) );
00487 d->btnUp->setIconSet( SmallIconSet( d->upIcon, d->iconSize ) );
00488 d->btnDown->setIconSet( SmallIconSet( d->downIcon, d->iconSize ) );
00489 }
00490
00491 void KActionSelector::moveItem( QListBoxItem *item )
00492 {
00493 QListBox *lbFrom = item->listBox();
00494 QListBox *lbTo;
00495 if ( lbFrom == d->availableListBox )
00496 lbTo = d->selectedListBox;
00497 else if ( lbFrom == d->selectedListBox )
00498 lbTo = d->availableListBox;
00499 else
00500 return;
00501
00502 InsertionPolicy p = ( lbTo == d->availableListBox ) ?
00503 d->availableInsertionPolicy : d->selectedInsertionPolicy;
00504
00505 lbFrom->takeItem( item );
00506 lbTo->insertItem( item, insertionIndex( lbTo, p ) );
00507 lbTo->setFocus();
00508 lbTo->setCurrentItem( item );
00509
00510 if ( p == Sorted )
00511 lbTo->sort();
00512 if ( lbTo == d->selectedListBox )
00513 emit added( item );
00514 else
00515 emit removed( item );
00516 }
00517
00518 int KActionSelector::insertionIndex( QListBox *lb, InsertionPolicy policy )
00519 {
00520 int index;
00521 switch ( policy )
00522 {
00523 case BelowCurrent:
00524 index = lb->currentItem();
00525 if ( index > -1 ) index += 1;
00526 break;
00527 case AtTop:
00528 index = 0;
00529 break;
00530 default:
00531 index = -1;
00532 }
00533 return index;
00534 }
00535
00536
00537 #include "kactionselector.moc"