keditlistbox.cpp
/* This file is part of the KDE libraries
Copyright (C) 2000 David Faure <faure@kde.org>, Alexander Neundorf <neundorf@kde.org>
2000, 2002 Carsten Pfeiffer <pfeiffer@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.
*/
#include <qstringlist.h>
#include <qpushbutton.h>
#include <qlayout.h>
#include <qgroupbox.h>
#include <qlistbox.h>
#include <qwhatsthis.h>
#include <qlabel.h>
#include <kcombobox.h>
#include <kdebug.h>
#include <kdialog.h>
#include <klineedit.h>
#include <klocale.h>
#include <kapplication.h>
#include <knotifyclient.h>
#include "keditlistbox.h"
#include <assert.h>
class KEditListBoxPrivate
{
public:
bool m_checkAtEntering;
uint buttons;
};
KEditListBox::KEditListBox(QWidget *parent, const char *name,
bool checkAtEntering, int buttons )
:QGroupBox(parent, name ), d(new KEditListBoxPrivate)
{
init( checkAtEntering, buttons );
}
KEditListBox::KEditListBox(const QString& title, QWidget *parent,
const char *name, bool checkAtEntering, int buttons)
:QGroupBox(title, parent, name ), d(new KEditListBoxPrivate)
{
init( checkAtEntering, buttons );
}
KEditListBox::KEditListBox(const QString& title, const CustomEditor& custom,
QWidget *parent, const char *name,
bool checkAtEntering, int buttons)
:QGroupBox(title, parent, name ), d(new KEditListBoxPrivate)
{
m_lineEdit = custom.lineEdit();
init( checkAtEntering, buttons, custom.representationWidget() );
}
KEditListBox::~KEditListBox()
{
delete d;
}
void KEditListBox::init( bool checkAtEntering, int buttons,
QWidget *representationWidget )
{
d->m_checkAtEntering = checkAtEntering;
servNewButton = servRemoveButton = servUpButton = servDownButton = 0L;
setSizePolicy(QSizePolicy(QSizePolicy::MinimumExpanding,
QSizePolicy::MinimumExpanding));
QGridLayout * grid = new QGridLayout(this, 7, 2,
KDialog::marginHint(),
KDialog::spacingHint());
grid->addRowSpacing(0, fontMetrics().lineSpacing());
grid->setRowStretch( 6, 1 );
grid->setMargin(15);
if ( representationWidget )
representationWidget->reparent( this, QPoint(0,0) );
else
m_lineEdit=new KLineEdit(this);
m_listBox = new QListBox(this);
QWidget *editingWidget = representationWidget ?
representationWidget : m_lineEdit;
grid->addMultiCellWidget(editingWidget,1,1,0,1);
grid->addMultiCellWidget(m_listBox, 2, 6, 0, 0);
d->buttons = 0;
setButtons( buttons );
connect(m_lineEdit,SIGNAL(textChanged(const QString&)),this,SLOT(typedSomething(const QString&)));
m_lineEdit->setTrapReturnKey(true);
connect(m_lineEdit,SIGNAL(returnPressed()),this,SLOT(addItem()));
connect(m_listBox, SIGNAL(highlighted(int)), SLOT(enableMoveButtons(int)));
// maybe supplied lineedit has some text already
typedSomething( m_lineEdit->text() );
}
void KEditListBox::setButtons( uint buttons )
{
if ( d->buttons == buttons )
return;
QGridLayout* grid = static_cast<QGridLayout *>( layout() );
if ( ( buttons & Add ) && !servNewButton ) {
servNewButton = new QPushButton(i18n("&Add"), this);
servNewButton->setEnabled(false);
servNewButton->show();
connect(servNewButton, SIGNAL(clicked()), SLOT(addItem()));
grid->addWidget(servNewButton, 2, 1);
} else if ( ( buttons & Add ) == 0 && servNewButton ) {
delete servNewButton;
servNewButton = 0;
}
if ( ( buttons & Remove ) && !servRemoveButton ) {
servRemoveButton = new QPushButton(i18n("&Remove"), this);
servRemoveButton->setEnabled(false);
servRemoveButton->show();
connect(servRemoveButton, SIGNAL(clicked()), SLOT(removeItem()));
grid->addWidget(servRemoveButton, 3, 1);
} else if ( ( buttons & Remove ) == 0 && servRemoveButton ) {
delete servRemoveButton;
servRemoveButton = 0;
}
if ( ( buttons & UpDown ) && !servUpButton ) {
servUpButton = new QPushButton(i18n("Move &Up"), this);
servUpButton->setEnabled(false);
servUpButton->show();
connect(servUpButton, SIGNAL(clicked()), SLOT(moveItemUp()));
servDownButton = new QPushButton(i18n("Move &Down"), this);
servDownButton->setEnabled(false);
servDownButton->show();
connect(servDownButton, SIGNAL(clicked()), SLOT(moveItemDown()));
grid->addWidget(servUpButton, 4, 1);
grid->addWidget(servDownButton, 5, 1);
} else if ( ( buttons & UpDown ) == 0 && servUpButton ) {
delete servUpButton; servUpButton = 0;
delete servDownButton; servDownButton = 0;
}
d->buttons = buttons;
}
void KEditListBox::typedSomething(const QString& text)
{
if(currentItem() >= 0) {
if(currentText() != m_lineEdit->text())
{
// IMHO changeItem() shouldn't do anything with the value
// of currentItem() ... like changing it or emitting signals ...
// but TT disagree with me on this one (it's been that way since ages ... grrr)
bool block = m_listBox->signalsBlocked();
m_listBox->blockSignals( true );
m_listBox->changeItem(text, currentItem());
m_listBox->blockSignals( block );
emit changed();
}
}
if ( !servNewButton )
return;
if (!d->m_checkAtEntering)
servNewButton->setEnabled(!text.isEmpty());
else
{
if (text.isEmpty())
{
servNewButton->setEnabled(false);
}
else
{
StringComparisonMode mode = (StringComparisonMode) (ExactMatch | CaseSensitive );
bool enable = (!m_listBox->findItem( text, mode ));
servNewButton->setEnabled( enable );
}
}
}
void KEditListBox::moveItemUp()
{
if (!m_listBox->isEnabled())
{
KNotifyClient::beep();
return;
}
const unsigned int selIndex = m_listBox->currentItem();
if (selIndex == 0)
{
KNotifyClient::beep();
return;
}
QListBoxItem *selItem = m_listBox->item(selIndex);
m_listBox->takeItem(selItem);
m_listBox->insertItem(selItem, selIndex-1);
m_listBox->setCurrentItem(selIndex - 1);
emit changed();
}
void KEditListBox::moveItemDown()
{
if (!m_listBox->isEnabled())
{
KNotifyClient::beep();
return;
}
unsigned int selIndex = m_listBox->currentItem();
if (selIndex == m_listBox->count() - 1)
{
KNotifyClient::beep();
return;
}
QListBoxItem *selItem = m_listBox->item(selIndex);
m_listBox->takeItem(selItem);
m_listBox->insertItem(selItem, selIndex+1);
m_listBox->setCurrentItem(selIndex + 1);
emit changed();
}
void KEditListBox::addItem()
{
// when m_checkAtEntering is true, the add-button is disabled, but this
// slot can still be called through Key_Return/Key_Enter. So we guard
// against this.
if ( !servNewButton || !servNewButton->isEnabled() )
return;
const QString& currentTextLE=m_lineEdit->text();
bool alreadyInList(false);
//if we didn't check for dupes at the inserting we have to do it now
if (!d->m_checkAtEntering)
{
// first check current item instead of dumb iterating the entire list
if ( m_listBox->currentText() == currentTextLE )
alreadyInList = true;
else
{
StringComparisonMode mode = (StringComparisonMode) (ExactMatch | CaseSensitive );
alreadyInList =(m_listBox->findItem(currentTextLE, mode) );
}
}
if ( servNewButton )
servNewButton->setEnabled(false);
bool block = m_lineEdit->signalsBlocked();
m_lineEdit->blockSignals(true);
m_lineEdit->clear();
m_lineEdit->blockSignals(block);
m_listBox->setSelected(currentItem(), false);
if (!alreadyInList)
{
block = m_listBox->signalsBlocked();
m_listBox->blockSignals( true );
m_listBox->insertItem(currentTextLE);
m_listBox->blockSignals( block );
emit changed();
emit added( currentTextLE );
}
}
int KEditListBox::currentItem() const
{
int nr = m_listBox->currentItem();
if(nr >= 0 && !m_listBox->item(nr)->isSelected()) return -1;
return nr;
}
void KEditListBox::removeItem()
{
int selected = m_listBox->currentItem();
if ( selected >= 0 )
{
QString removedText = m_listBox->currentText();
m_listBox->removeItem( selected );
if ( count() > 0 )
m_listBox->setSelected( QMIN( selected, count() - 1 ), true );
emit changed();
emit removed( removedText );
}
if ( servRemoveButton && m_listBox->currentItem() == -1 )
servRemoveButton->setEnabled(false);
}
void KEditListBox::enableMoveButtons(int index)
{
// Update the lineEdit when we select a different line.
if(currentText() != m_lineEdit->text())
m_lineEdit->setText(currentText());
bool moveEnabled = servUpButton && servDownButton;
if (moveEnabled )
{
if (m_listBox->count() <= 1)
{
servUpButton->setEnabled(false);
servDownButton->setEnabled(false);
}
else if ((uint) index == (m_listBox->count() - 1))
{
servUpButton->setEnabled(true);
servDownButton->setEnabled(false);
}
else if (index == 0)
{
servUpButton->setEnabled(false);
servDownButton->setEnabled(true);
}
else
{
servUpButton->setEnabled(true);
servDownButton->setEnabled(true);
}
}
if ( servRemoveButton )
servRemoveButton->setEnabled(true);
}
void KEditListBox::clear()
{
m_lineEdit->clear();
m_listBox->clear();
emit changed();
}
void KEditListBox::insertStringList(const QStringList& list, int index)
{
m_listBox->insertStringList(list,index);
}
void KEditListBox::insertStrList(const QStrList* list, int index)
{
m_listBox->insertStrList(list,index);
}
void KEditListBox::insertStrList(const QStrList& list, int index)
{
m_listBox->insertStrList(list,index);
}
void KEditListBox::insertStrList(const char ** list, int numStrings, int index)
{
m_listBox->insertStrList(list,numStrings,index);
}
QStringList KEditListBox::items() const
{
QStringList list;
for (QListBoxItem const * i = m_listBox->firstItem(); i != 0; i = i->next() )
list.append( i->text());
return list;
}
void KEditListBox::setItems(const QStringList& items)
{
m_listBox->clear();
m_listBox->insertStringList(items, 0);
}
int KEditListBox::buttons() const
{
return d->buttons;
}
void KEditListBox::virtual_hook( int, void* )
{ /*BASE::virtual_hook( id, data );*/ }
KEditListBox::CustomEditor::CustomEditor( KComboBox *combo )
{
m_representationWidget = combo;
m_lineEdit = dynamic_cast<KLineEdit*>( combo->lineEdit() );
assert( m_lineEdit );
}
#include "keditlistbox.moc"
KDialog::marginHint
static int marginHint()
Return the number of pixels you shall use between a dialog edge and the outermost widget(s) according...
Definition: kdialog.cpp:97
KEditListBox::currentItem
int currentItem() const
See QListBox::currentItem()
Definition: keditlistbox.cpp:294
KNotifyClient::beep
void beep(const QString &reason=QString::null)
KEditListBox::added
void added(const QString &text)
This signal is emitted when the user adds a new string to the list, the parameter is the added string...
KEditListBox::currentText
QString currentText() const
See QListBox::currentText()
Definition: keditlistbox.h:205
klocale.h
KLineEdit::clear
virtual void clear()
Reimplemented to workaround a buggy QLineEdit::clear() (changing the clipboard to the text we just ha...
Definition: klineedit.cpp:1322
KEditListBox::CustomEditor
Custom editor class.
Definition: keditlistbox.h:59
KEditListBox::insertStringList
void insertStringList(const QStringList &list, int index=-1)
See QListBox::insertStringList()
Definition: keditlistbox.cpp:364
KDialog::spacingHint
static int spacingHint()
Return the number of pixels you shall use between widgets inside a dialog according to the KDE standa...
Definition: kdialog.cpp:103
KEditListBox::count
int count() const
See QListBox::count()
Definition: keditlistbox.h:169
KEditListBox::setButtons
void setButtons(uint buttons)
Specifies which buttons should be visible.
Definition: keditlistbox.cpp:117
KLineEdit::setTrapReturnKey
void setTrapReturnKey(bool trap)
By default, KLineEdit recognizes Key_Return and Key_Enter and emits the returnPressed() signals...
Definition: klineedit.cpp:1068
KEditListBox::KEditListBox
KEditListBox(QWidget *parent=0, const char *name=0, bool checkAtEntering=false, int buttons=All)
Create an editable listbox.
Definition: keditlistbox.cpp:48
KEditListBox::buttons
int buttons() const
Returns which buttons are visible.
KEditListBox::items
QStringList items() const
KLineEdit
An enhanced QLineEdit widget for inputting text.
Definition: klineedit.h:145
KEditListBox::clear
void clear()
Clears both the listbox and the line edit.
Definition: keditlistbox.cpp:357
KEditListBox::removed
void removed(const QString &text)
This signal is emitted when the user removes a string from the list, the parameter is the removed str...
KComboBox
An enhanced combo box.
Definition: kcombobox.h:144
KEditListBox::setItems
void setItems(const QStringList &items)
Clears the listbox and sets the contents to items.
Definition: keditlistbox.cpp:393
KEditListBox::insertStrList
void insertStrList(const QStrList *list, int index=-1)
See QListBox::insertStringList()
Definition: keditlistbox.cpp:369
KLineEdit::setText
virtual void setText(const QString &)
Re-implemented to enable text squeezing.
Definition: klineedit.cpp:310

KDE Home | KDE Accessibility Home | Description of Access Keys