\section{KEdit\-List\-Box Class Reference}
\label{classKEditListBox}\index{KEditListBox@{KEditListBox}}
An editable listbox.  


{\tt \#include $<$keditlistbox.h$>$}

Inheritance diagram for KEdit\-List\-Box:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=54pt]{classKEditListBox__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for KEdit\-List\-Box:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=199pt]{classKEditListBox__coll__graph}
\end{center}
\end{figure}
\subsection*{Public Types}
\begin{CompactItemize}
\item 
enum {\bf Button} \{ {\bf Add} =  1, 
{\bf Remove} =  2, 
{\bf Up\-Down} =  4
 \}
\item 
enum \{ {\bf All} =  Add$|$Remove$|$Up\-Down
 \}
\end{CompactItemize}
\subsection*{Signals}
\begin{CompactItemize}
\item 
void {\bf changed} ()\label{classKEditListBox_l0}

\item 
void {\bf added} (const {\bf QString} \&text)
\item 
void {\bf removed} (const {\bf QString} \&text)
\end{CompactItemize}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf KEdit\-List\-Box} ({\bf QWidget} $\ast$parent=0, const char $\ast$name=0, bool check\-At\-Entering=false, int buttons=All)
\item 
{\bf KEdit\-List\-Box} (const {\bf QString} \&{\bf title}, {\bf QWidget} $\ast$parent=0, const char $\ast$name=0, bool check\-At\-Entering=false, int buttons=All)
\item 
{\bf KEdit\-List\-Box} (const {\bf QString} \&{\bf title}, const {\bf Custom\-Editor} \&custom\-Editor, {\bf QWidget} $\ast$parent=0, const char $\ast$name=0, bool check\-At\-Entering=false, int buttons=All)
\item 
{\bf QList\-Box} $\ast$ {\bf list\-Box} () const 
\item 
{\bf KLine\-Edit} $\ast$ {\bf line\-Edit} () const 
\item 
{\bf QPush\-Button} $\ast$ {\bf add\-Button} () const 
\item 
{\bf QPush\-Button} $\ast$ {\bf remove\-Button} () const 
\item 
{\bf QPush\-Button} $\ast$ {\bf up\-Button} () const 
\item 
{\bf QPush\-Button} $\ast$ {\bf down\-Button} () const 
\item 
int {\bf count} () const 
\item 
void {\bf insert\-String\-List} (const {\bf QString\-List} \&list, int index=-1)
\item 
void {\bf insert\-Str\-List} (const {\bf QStr\-List} $\ast$list, int index=-1)
\item 
void {\bf insert\-Str\-List} (const {\bf QStr\-List} \&list, int index=-1)
\item 
void {\bf insert\-Str\-List} (const char $\ast$$\ast$list, int num\-Strings=-1, int index=-1)
\item 
void {\bf insert\-Item} (const {\bf QString} \&text, int index=-1)
\item 
void {\bf clear} ()
\item 
{\bf QString} {\bf text} (int index) const 
\item 
int {\bf current\-Item} () const 
\item 
{\bf QString} {\bf current\-Text} () const 
\item 
{\bf QString\-List} {\bf items} () const 
\item 
void {\bf set\-Items} (const {\bf QString\-List} \&items)
\item 
int {\bf buttons} () const 
\item 
void {\bf set\-Buttons} (uint buttons)
\end{CompactItemize}
\subsection*{Protected Slots}
\begin{CompactItemize}
\item 
void {\bf move\-Item\-Up} ()\label{classKEditListBox_j0}

\item 
void {\bf move\-Item\-Down} ()\label{classKEditListBox_j1}

\item 
void {\bf add\-Item} ()\label{classKEditListBox_j2}

\item 
void {\bf remove\-Item} ()\label{classKEditListBox_j3}

\item 
void {\bf enable\-Move\-Buttons} (int index)\label{classKEditListBox_j4}

\item 
void {\bf typed\-Something} (const {\bf QString} \&text)\label{classKEditListBox_j5}

\end{CompactItemize}
\subsection*{Protected Member Functions}
\begin{CompactItemize}
\item 
virtual void {\bf virtual\_\-hook} (int id, void $\ast$data)\label{classKEditListBox_b0}

\end{CompactItemize}
\subsection*{Properties}
\begin{CompactItemize}
\item 
{\bf Button} {\bf buttons}\label{classKEditListBox_00}

\item 
{\bf QString\-List} {\bf items}\label{classKEditListBox_01}

\end{CompactItemize}
\subsection*{Classes}
\begin{CompactItemize}
\item 
class {\bf Custom\-Editor}
\begin{CompactList}\small\item\em Custom editor class. \item\end{CompactList}\end{CompactItemize}


\subsection{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 44 of file keditlistbox.h.

\subsection{Member Enumeration Documentation}
\index{KEditListBox@{KEdit\-List\-Box}!Button@{Button}}
\index{Button@{Button}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf enum} {\bf KEdit\-List\-Box::Button}}\label{classKEditListBox_w4}


Enumeration of the buttons, the listbox offers. 

Specify them in the constructor in the buttons parameter, or in set\-Buttons. 

Definition at line 94 of file keditlistbox.h.

\subsection{Constructor \& Destructor Documentation}
\index{KEditListBox@{KEdit\-List\-Box}!KEditListBox@{KEditListBox}}
\index{KEditListBox@{KEditListBox}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KEdit\-List\-Box::KEdit\-List\-Box ({\bf QWidget} $\ast$ {\em parent} = {\tt 0}, const char $\ast$ {\em name} = {\tt 0}, bool {\em check\-At\-Entering} = {\tt false}, int {\em buttons} = {\tt All})}\label{classKEditListBox_a0}


Create an editable listbox. 

If {\tt check\-At\-Entering} is true, after every character you type in the line edit KEdit\-List\-Box 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 {\tt check\-At\-Entering} 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 48 of file keditlistbox.cpp.\index{KEditListBox@{KEdit\-List\-Box}!KEditListBox@{KEditListBox}}
\index{KEditListBox@{KEditListBox}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KEdit\-List\-Box::KEdit\-List\-Box (const {\bf QString} \& {\em title}, {\bf QWidget} $\ast$ {\em parent} = {\tt 0}, const char $\ast$ {\em name} = {\tt 0}, bool {\em check\-At\-Entering} = {\tt false}, int {\em buttons} = {\tt All})}\label{classKEditListBox_a1}


Create an editable listbox. 

The same as the other constructor, additionally it takes {\tt title}, which will be the title of the frame around the listbox. 

Definition at line 55 of file keditlistbox.cpp.\index{KEditListBox@{KEdit\-List\-Box}!KEditListBox@{KEditListBox}}
\index{KEditListBox@{KEditListBox}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KEdit\-List\-Box::KEdit\-List\-Box (const {\bf QString} \& {\em title}, const {\bf Custom\-Editor} \& {\em custom\-Editor}, {\bf QWidget} $\ast$ {\em parent} = {\tt 0}, const char $\ast$ {\em name} = {\tt 0}, bool {\em check\-At\-Entering} = {\tt false}, int {\em buttons} = {\tt All})}\label{classKEditListBox_a2}


Another constructor, which allows to use a custom editing widget instead of the standard {\bf KLine\-Edit}{\rm (p.\,\pageref{classKLineEdit})} widget. 

E.g. you can use a {\bf KURLRequester} or a {\bf KCombo\-Box}{\rm (p.\,\pageref{classKComboBox})} as input widget. The custom editor must consist of a lineedit and optionally another widget that is used as representation. A {\bf KCombo\-Box}{\rm (p.\,\pageref{classKComboBox})} or a {\bf KURLRequester} have a {\bf KLine\-Edit}{\rm (p.\,\pageref{classKLineEdit})} as child-widget for example, so the {\bf KCombo\-Box}{\rm (p.\,\pageref{classKComboBox})} is used as the representation widget.

\begin{Desc}
\item[See also:]{\bf KURLRequester::custom\-Editor()} \end{Desc}
\begin{Desc}
\item[Since:]3.1 \end{Desc}


Definition at line 62 of file keditlistbox.cpp.

\subsection{Member Function Documentation}
\index{KEditListBox@{KEdit\-List\-Box}!listBox@{listBox}}
\index{listBox@{listBox}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QList\-Box}$\ast$ KEdit\-List\-Box::list\-Box () const\hspace{0.3cm}{\tt  [inline]}}\label{classKEditListBox_a4}


Return a pointer to the embedded {\bf QList\-Box}. 



Definition at line 143 of file keditlistbox.h.\index{KEditListBox@{KEdit\-List\-Box}!lineEdit@{lineEdit}}
\index{lineEdit@{lineEdit}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KLine\-Edit}$\ast$ KEdit\-List\-Box::line\-Edit () const\hspace{0.3cm}{\tt  [inline]}}\label{classKEditListBox_a5}


Return a pointer to the embedded {\bf QLine\-Edit}. 



Definition at line 147 of file keditlistbox.h.\index{KEditListBox@{KEdit\-List\-Box}!addButton@{addButton}}
\index{addButton@{addButton}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QPush\-Button}$\ast$ KEdit\-List\-Box::add\-Button () const\hspace{0.3cm}{\tt  [inline]}}\label{classKEditListBox_a6}


Return a pointer to the Add button. 



Definition at line 151 of file keditlistbox.h.\index{KEditListBox@{KEdit\-List\-Box}!removeButton@{removeButton}}
\index{removeButton@{removeButton}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QPush\-Button}$\ast$ KEdit\-List\-Box::remove\-Button () const\hspace{0.3cm}{\tt  [inline]}}\label{classKEditListBox_a7}


Return a pointer to the Remove button. 



Definition at line 155 of file keditlistbox.h.\index{KEditListBox@{KEdit\-List\-Box}!upButton@{upButton}}
\index{upButton@{upButton}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QPush\-Button}$\ast$ KEdit\-List\-Box::up\-Button () const\hspace{0.3cm}{\tt  [inline]}}\label{classKEditListBox_a8}


Return a pointer to the Up button. 



Definition at line 159 of file keditlistbox.h.\index{KEditListBox@{KEdit\-List\-Box}!downButton@{downButton}}
\index{downButton@{downButton}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QPush\-Button}$\ast$ KEdit\-List\-Box::down\-Button () const\hspace{0.3cm}{\tt  [inline]}}\label{classKEditListBox_a9}


Return a pointer to the Down button. 



Definition at line 163 of file keditlistbox.h.\index{KEditListBox@{KEdit\-List\-Box}!count@{count}}
\index{count@{count}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KEdit\-List\-Box::count () const\hspace{0.3cm}{\tt  [inline]}}\label{classKEditListBox_a10}


See {\bf QList\-Box::count()}. 



Definition at line 168 of file keditlistbox.h.\index{KEditListBox@{KEdit\-List\-Box}!insertStringList@{insertStringList}}
\index{insertStringList@{insertStringList}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KEdit\-List\-Box::insert\-String\-List (const {\bf QString\-List} \& {\em list}, int {\em index} = {\tt -1})}\label{classKEditListBox_a11}


See {\bf QList\-Box::insert\-String\-List()}. 



Definition at line 363 of file keditlistbox.cpp.

References QList\-Box::insert\-String\-List().\index{KEditListBox@{KEdit\-List\-Box}!insertStrList@{insertStrList}}
\index{insertStrList@{insertStrList}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KEdit\-List\-Box::insert\-Str\-List (const {\bf QStr\-List} $\ast$ {\em list}, int {\em index} = {\tt -1})}\label{classKEditListBox_a12}


See {\bf QList\-Box::insert\-String\-List()}. 



Definition at line 368 of file keditlistbox.cpp.

References QList\-Box::insert\-Str\-List().\index{KEditListBox@{KEdit\-List\-Box}!insertStrList@{insertStrList}}
\index{insertStrList@{insertStrList}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KEdit\-List\-Box::insert\-Str\-List (const {\bf QStr\-List} \& {\em list}, int {\em index} = {\tt -1})}\label{classKEditListBox_a13}


See {\bf QList\-Box::insert\-Str\-List()}. 



Definition at line 373 of file keditlistbox.cpp.

References QList\-Box::insert\-Str\-List().\index{KEditListBox@{KEdit\-List\-Box}!insertStrList@{insertStrList}}
\index{insertStrList@{insertStrList}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KEdit\-List\-Box::insert\-Str\-List (const char $\ast$$\ast$ {\em list}, int {\em num\-Strings} = {\tt -1}, int {\em index} = {\tt -1})}\label{classKEditListBox_a14}


See {\bf QList\-Box::insert\-Str\-List()}. 



Definition at line 378 of file keditlistbox.cpp.

References QList\-Box::insert\-Str\-List().\index{KEditListBox@{KEdit\-List\-Box}!insertItem@{insertItem}}
\index{insertItem@{insertItem}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KEdit\-List\-Box::insert\-Item (const {\bf QString} \& {\em text}, int {\em index} = {\tt -1})\hspace{0.3cm}{\tt  [inline]}}\label{classKEditListBox_a15}


See {\bf QList\-Box::insert\-Item()}. 



Definition at line 188 of file keditlistbox.h.\index{KEditListBox@{KEdit\-List\-Box}!clear@{clear}}
\index{clear@{clear}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KEdit\-List\-Box::clear ()}\label{classKEditListBox_a16}


Clears both the listbox and the line edit. 



Definition at line 356 of file keditlistbox.cpp.

References QList\-Box::clear(), and KLine\-Edit::clear().\index{KEditListBox@{KEdit\-List\-Box}!text@{text}}
\index{text@{text}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KEdit\-List\-Box::text (int {\em index}) const\hspace{0.3cm}{\tt  [inline]}}\label{classKEditListBox_a17}


See {\bf QList\-Box::text()}. 



Definition at line 196 of file keditlistbox.h.

References KAction::text.\index{KEditListBox@{KEdit\-List\-Box}!currentItem@{currentItem}}
\index{currentItem@{currentItem}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KEdit\-List\-Box::current\-Item () const}\label{classKEditListBox_a18}


See {\bf QList\-Box::current\-Item()}. 



Definition at line 293 of file keditlistbox.cpp.

References QList\-Box::current\-Item(), QList\-Box::is\-Selected(), and QList\-Box::item().\index{KEditListBox@{KEdit\-List\-Box}!currentText@{currentText}}
\index{currentText@{currentText}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KEdit\-List\-Box::current\-Text () const\hspace{0.3cm}{\tt  [inline]}}\label{classKEditListBox_a19}


See {\bf QList\-Box::current\-Text()}. 



Definition at line 204 of file keditlistbox.h.\index{KEditListBox@{KEdit\-List\-Box}!items@{items}}
\index{items@{items}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString\-List} KEdit\-List\-Box::items () const}\label{classKEditListBox_a20}


\begin{Desc}
\item[Returns:]a stringlist of all items in the listbox \end{Desc}
\index{KEditListBox@{KEdit\-List\-Box}!setItems@{setItems}}
\index{setItems@{setItems}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KEdit\-List\-Box::set\-Items (const {\bf QString\-List} \& {\em items})}\label{classKEditListBox_a21}


Clears the listbox and sets the contents to {\tt items}. 

\begin{Desc}
\item[Since:]3.4 \end{Desc}


Definition at line 392 of file keditlistbox.cpp.

References QList\-Box::clear(), and QList\-Box::insert\-String\-List().\index{KEditListBox@{KEdit\-List\-Box}!buttons@{buttons}}
\index{buttons@{buttons}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KEdit\-List\-Box::buttons () const}\label{classKEditListBox_a22}


Returns which buttons are visible. 

\index{KEditListBox@{KEdit\-List\-Box}!setButtons@{setButtons}}
\index{setButtons@{setButtons}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KEdit\-List\-Box::set\-Buttons (uint {\em buttons})}\label{classKEditListBox_a23}


Specifies which buttons should be visible. 



Definition at line 116 of file keditlistbox.cpp.

References QGrid\-Layout::add\-Widget().\index{KEditListBox@{KEdit\-List\-Box}!added@{added}}
\index{added@{added}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KEdit\-List\-Box::added (const {\bf QString} \& {\em text})\hspace{0.3cm}{\tt  [signal]}}\label{classKEditListBox_l1}


This signal is emitted when the user adds a new string to the list, the parameter is the added string. 

\begin{Desc}
\item[Since:]3.2 \end{Desc}
\index{KEditListBox@{KEdit\-List\-Box}!removed@{removed}}
\index{removed@{removed}!KEditListBox@{KEdit\-List\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KEdit\-List\-Box::removed (const {\bf QString} \& {\em text})\hspace{0.3cm}{\tt  [signal]}}\label{classKEditListBox_l2}


This signal is emitted when the user removes a string from the list, the parameter is the removed string. 

\begin{Desc}
\item[Since:]3.2 \end{Desc}


The documentation for this class was generated from the following files:\begin{CompactItemize}
\item 
keditlistbox.h\item 
keditlistbox.cpp\end{CompactItemize}
