KDEUI
KEditListBox Class Reference
#include <keditlistbox.h>

Detailed Description
An editable listbox.This class provides a editable listbox ;-), this means a listbox which is accompanied by a line edit to enter new items into the listbox and pushbuttons to add and remove items from the listbox and two buttons to move items up and down.

KDE Edit List Box Widget
Definition at line 45 of file keditlistbox.h.
Public Types | |
enum | Button { Add = 0x0001, Remove = 0x0002, UpDown = 0x0004, All = Add | Remove | UpDown } |
Signals | |
void | added (const QString &text) |
void | changed () |
void | removed (const QString &text) |
Public Member Functions | |
QPushButton * | addButton () const |
Buttons | buttons () const |
bool | checkAtEntering () |
void | clear () |
int | count () const |
int | currentItem () const |
QString | currentText () const |
QPushButton * | downButton () const |
bool | eventFilter (QObject *o, QEvent *e) |
void | insertItem (const QString &text, int index=-1) |
void | insertStringList (const QStringList &list, int index=-1) |
QStringList | items () const |
KEditListBox (const QString &title, const CustomEditor &customEditor, QWidget *parent=0, const char *name=0, bool checkAtEntering=false, Buttons buttons=All) | |
KEditListBox (const QString &title, QWidget *parent, const char *name, bool checkAtEntering=false, Buttons buttons=All) | |
KEditListBox (QWidget *parent, const char *name, bool checkAtEntering=false, Buttons buttons=All) | |
KEditListBox (const QString &title, QWidget *parent=0) | |
KEditListBox (QWidget *parent=0) | |
KLineEdit * | lineEdit () const |
QListView * | listView () const |
QPushButton * | removeButton () const |
void | setButtons (Buttons buttons) |
void | setCheckAtEntering (bool check) |
void | setCustomEditor (const CustomEditor &editor) |
void | setItems (const QStringList &items) |
QString | text (int index) const |
QPushButton * | upButton () const |
virtual | ~KEditListBox () |
Protected Slots | |
void | addItem () |
void | enableMoveButtons (const QModelIndex &, const QModelIndex &) |
void | moveItemDown () |
void | moveItemUp () |
void | removeItem () |
void | typedSomething (const QString &text) |
Properties | |
Buttons | buttons |
QStringList | items |
Classes | |
class | CustomEditor |
Custom editor class. More... |
Member Enumeration Documentation
enum KEditListBox::Button |
Enumeration of the buttons, the listbox offers.
Specify them in the constructor in the buttons parameter, or in setButtons.
Definition at line 86 of file keditlistbox.h.
Constructor & Destructor Documentation
KEditListBox::KEditListBox | ( | QWidget * | parent = 0 |
) | [explicit] |
Create an editable listbox.
The same as the other constructor, additionally it takes title
, which will be the title of the groupbox around the listbox.
Definition at line 239 of file keditlistbox.cpp.
KEditListBox::KEditListBox | ( | QWidget * | parent, | |
const char * | name, | |||
bool | checkAtEntering = false , |
|||
Buttons | buttons = All | |||
) | [explicit] |
Create an editable listbox.
If
checkAtEntering
is true, after every character you type in the line edit KEditListBox will enable or disable the Add-button, depending whether the current content of the line edit is already in the listbox. Maybe this can become a performance hit with large lists on slow machines. If checkAtEntering
is false, it will be checked if you press the Add-button. It is not possible to enter items twice into the listbox.
Definition at line 245 of file keditlistbox.cpp.
KEditListBox::KEditListBox | ( | const QString & | title, | |
QWidget * | parent, | |||
const char * | name, | |||
bool | checkAtEntering = false , |
|||
Buttons | buttons = All | |||
) | [explicit] |
Create an editable listbox.
The same as the other constructor, additionally it takes
title
, which will be the title of the frame around the listbox.
Definition at line 253 of file keditlistbox.cpp.
KEditListBox::KEditListBox | ( | const QString & | title, | |
const CustomEditor & | customEditor, | |||
QWidget * | parent = 0 , |
|||
const char * | name = 0 , |
|||
bool | checkAtEntering = false , |
|||
Buttons | buttons = All | |||
) |
Another constructor, which allows to use a custom editing widget instead of the standard KLineEdit widget.
E.g. you can use a KUrlRequester or a KComboBox as input widget. The custom editor must consist of a lineedit and optionally another widget that is used as representation. A KComboBox or a KUrlRequester have a KLineEdit as child-widget for example, so the KComboBox is used as the representation widget.
- See also:
- KUrlRequester::customEditor(), setCustomEditor
Definition at line 261 of file keditlistbox.cpp.
KEditListBox::~KEditListBox | ( | ) | [virtual] |
Definition at line 271 of file keditlistbox.cpp.
Member Function Documentation
QPushButton * KEditListBox::addButton | ( | ) | const |
void KEditListBox::added | ( | const QString & | text | ) | [signal] |
This signal is emitted when the user adds a new string to the list, the parameter is the added string.
void KEditListBox::addItem | ( | ) | [protected, slot] |
Definition at line 471 of file keditlistbox.cpp.
Buttons KEditListBox::buttons | ( | ) | const |
Returns which buttons are visible.
void KEditListBox::changed | ( | ) | [signal] |
bool KEditListBox::checkAtEntering | ( | ) |
void KEditListBox::clear | ( | ) |
int KEditListBox::count | ( | ) | const |
int KEditListBox::currentItem | ( | ) | const |
QString KEditListBox::currentText | ( | ) | const |
QPushButton * KEditListBox::downButton | ( | ) | const |
void KEditListBox::enableMoveButtons | ( | const QModelIndex & | newIndex, | |
const QModelIndex & | ||||
) | [protected, slot] |
Definition at line 556 of file keditlistbox.cpp.
Reimplented for interal reasons.
The API is not affected.
Definition at line 666 of file keditlistbox.cpp.
void KEditListBox::insertItem | ( | const QString & | text, | |
int | index = -1 | |||
) |
void KEditListBox::insertStringList | ( | const QStringList & | list, | |
int | index = -1 | |||
) |
QStringList KEditListBox::items | ( | ) | const |
- Returns:
- a stringlist of all items in the listbox
KLineEdit * KEditListBox::lineEdit | ( | ) | const |
QListView * KEditListBox::listView | ( | ) | const |
void KEditListBox::moveItemDown | ( | ) | [protected, slot] |
Definition at line 443 of file keditlistbox.cpp.
void KEditListBox::moveItemUp | ( | ) | [protected, slot] |
Definition at line 415 of file keditlistbox.cpp.
QPushButton * KEditListBox::removeButton | ( | ) | const |
void KEditListBox::removed | ( | const QString & | text | ) | [signal] |
This signal is emitted when the user removes a string from the list, the parameter is the removed string.
void KEditListBox::removeItem | ( | ) | [protected, slot] |
Definition at line 534 of file keditlistbox.cpp.
void KEditListBox::setButtons | ( | Buttons | buttons | ) |
void KEditListBox::setCheckAtEntering | ( | bool | check | ) |
If check
is true, after every character you type in the line edit KEditListBox will enable or disable the Add-button, depending whether the current content of the line edit is already in the listbox.
Maybe this can become a performance hit with large lists on slow machines. If check
is false, it will be checked if you press the Add-button. It is not possible to enter items twice into the listbox. Default is false.
Definition at line 367 of file keditlistbox.cpp.
void KEditListBox::setCustomEditor | ( | const CustomEditor & | editor | ) |
Allows to use a custom editing widget instead of the standard KLineEdit widget.
E.g. you can use a KUrlRequester or a KComboBox as input widget. The custom editor must consist of a lineedit and optionally another widget that is used as representation. A KComboBox or a KUrlRequester have a KLineEdit as child-widget for example, so the KComboBox is used as the representation widget.
- Since:
- 4.1
Definition at line 276 of file keditlistbox.cpp.
void KEditListBox::setItems | ( | const QStringList & | items | ) |
QString KEditListBox::text | ( | int | index | ) | const |
void KEditListBox::typedSomething | ( | const QString & | text | ) | [protected, slot] |
Definition at line 377 of file keditlistbox.cpp.
QPushButton * KEditListBox::upButton | ( | ) | const |
Property Documentation
KEditListBox::Buttons KEditListBox::buttons [read, write] |
Definition at line 50 of file keditlistbox.h.
QStringList KEditListBox::items [read, write] |
Definition at line 51 of file keditlistbox.h.
The documentation for this class was generated from the following files: