Main Page   Modules   Namespace List   Class Hierarchy   Compound List   File List   Namespace Members   Compound Members   Related Pages  

KEditListBox Class Reference

#include <keditlistbox.h>

List of all members.

Public Types

enum  Button

Public Methods

 KEditListBox (QWidget *parent=0, const char *name=0, bool checkAtEntering=false, int buttons=All)
 KEditListBox (const QString &title, QWidget *parent=0, const char *name=0, bool checkAtEntering=false, int buttons=All)
 KEditListBox (const QString &title, const CustomEditor &customEditor, QWidget *parent=0, const char *name=0, bool checkAtEntering=false, int buttons=All)
QListBox * listBox () const
KLineEdit * lineEdit () const
QPushButton * addButton () const
QPushButton * removeButton () const
QPushButton * upButton () const
QPushButton * downButton () const
int count () const
void insertStringList (const QStringList &list, int index=-1)
void insertStrList (const QStrList *list, int index=-1)
void insertStrList (const QStrList &list, int index=-1)
void insertStrList (const char **list, int numStrings=-1, int index=-1)
void insertItem (const QString &text, int index=-1)
void clear ()
QString text (int index) const
int currentItem () const
QString currentText () const
QStringList items () const

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.

Definition at line 39 of file keditlistbox.h.

Member Enumeration Documentation

enum KEditListBox::Button
 

Enumeration of the buttons, the listbox offers. Specify them in the constructor in the buttons parameter.

Definition at line 81 of file keditlistbox.h.

Constructor & Destructor Documentation

KEditListBox::KEditListBox (  QWidget *    parent = 0,
const char *    name = 0,
bool    checkAtEntering = false,
int    buttons = All
) 
 

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.

KEditListBox::KEditListBox (  const QString &    title,
QWidget *    parent = 0,
const char *    name = 0,
bool    checkAtEntering = false,
int    buttons = All
) 
 

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.

KEditListBox::KEditListBox (  const QString &    title,
const CustomEditor &    customEditor,
QWidget *    parent = 0,
const char *    name = 0,
bool    checkAtEntering = false,
int    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()
Since:
3.1

Member Function Documentation

QPushButton* KEditListBox::addButton (    )  const [inline]
 

Return a pointer to the Add button

Definition at line 137 of file keditlistbox.h.

void KEditListBox::clear (    ) 
 

Clears both the listbox and the line edit.

int KEditListBox::count (    )  const [inline]
 

See QListBox::count()

Definition at line 154 of file keditlistbox.h.

int KEditListBox::currentItem (    ) 
 

See QListBox::currentItem()

QString KEditListBox::currentText (    )  const [inline]
 

See QListBox::currentText()

Definition at line 190 of file keditlistbox.h.

QPushButton* KEditListBox::downButton (    )  const [inline]
 

Return a pointer to the Down button

Definition at line 149 of file keditlistbox.h.

void KEditListBox::insertItem (  const QString &    text,
int    index = -1
)  [inline]
 

See QListBox::insertItem()

Definition at line 174 of file keditlistbox.h.

References text().

void KEditListBox::insertStringList (  const QStringList &    list,
int    index = -1
) 
 

See QListBox::insertStringList()

void KEditListBox::insertStrList (  const char **    list,
int    numStrings = -1,
int    index = -1
) 
 

See QListBox::insertStrList()

void KEditListBox::insertStrList (  const QStrList &    list,
int    index = -1
) 
 

See QListBox::insertStrList()

void KEditListBox::insertStrList (  const QStrList *    list,
int    index = -1
) 
 

See QListBox::insertStringList()

QStringList KEditListBox::items (    ) 
 

Returns:
a stringlist of all items in the listbox

KLineEdit* KEditListBox::lineEdit (    )  const [inline]
 

Return a pointer to the embedded QLineEdit.

Definition at line 133 of file keditlistbox.h.

QListBox* KEditListBox::listBox (    )  const [inline]
 

Return a pointer to the embedded QListBox.

Definition at line 129 of file keditlistbox.h.

QPushButton* KEditListBox::removeButton (    )  const [inline]
 

Return a pointer to the Remove button

Definition at line 141 of file keditlistbox.h.

QString KEditListBox::text (  int    index )  const [inline]
 

See QListBox::text()

Definition at line 182 of file keditlistbox.h.

Referenced by insertItem().

QPushButton* KEditListBox::upButton (    )  const [inline]
 

Return a pointer to the Up button

Definition at line 145 of file keditlistbox.h.

The documentation for this class was generated from the following file:
Generated on Wed Aug 13 23:30:11 2003 for kdelibs by doxygen1.2.18