\section{KList\-Box Class Reference}
\label{classKListBox}\index{KListBox@{KListBox}}
Extends the functionality of {\bf QList\-Box} to honor the system wide settings for Single Click/Double Click mode, Auto Selection and Change Cursor over Link. A variant of {\bf QList\-Box} that honors KDE's system-wide settings.  


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

Inheritance diagram for KList\-Box:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=126pt]{classKListBox__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for KList\-Box:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=176pt]{classKListBox__coll__graph}
\end{center}
\end{figure}
\subsection*{Signals}
\begin{CompactItemize}
\item 
void {\bf executed} ({\bf QList\-Box\-Item} $\ast${\bf item})
\begin{CompactList}\small\item\em Emitted whenever the user executes an listbox item. \item\end{CompactList}\item 
void {\bf executed} ({\bf QList\-Box\-Item} $\ast${\bf item}, const  {\bf QPoint} \&pos)
\begin{CompactList}\small\item\em Emitted whenever the user executes an listbox item. \item\end{CompactList}\item 
void {\bf double\-Clicked} ({\bf QList\-Box\-Item} $\ast${\bf item}, const  {\bf QPoint} \&pos)
\begin{CompactList}\small\item\em This signal gets emitted whenever the user double clicks into the listbox. \item\end{CompactList}\end{CompactItemize}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf KList\-Box} ({\bf QWidget} $\ast$parent=0, const  char $\ast$name=0, WFlags f=0)\label{classKListBox_a0}

\end{CompactItemize}
\subsection*{Protected Slots}
\begin{CompactItemize}
\item 
void {\bf slot\-On\-Item} ({\bf QList\-Box\-Item} $\ast${\bf item})\label{classKListBox_j0}

\item 
void {\bf slot\-On\-Viewport} ()\label{classKListBox_j1}

\item 
void {\bf slot\-Settings\-Changed} (int)\label{classKListBox_j2}

\item 
void {\bf slot\-Auto\-Select} ()
\begin{CompactList}\small\item\em Auto selection happend. \item\end{CompactList}\end{CompactItemize}
\subsection*{Protected Member Functions}
\begin{CompactItemize}
\item 
void {\bf emit\-Execute} ({\bf QList\-Box\-Item} $\ast${\bf item}, const  {\bf QPoint} \&pos)\label{classKListBox_b0}

\item 
virtual void {\bf key\-Press\-Event} ({\bf QKey\-Event} $\ast$e)\label{classKListBox_b1}

\item 
virtual void {\bf focus\-Out\-Event} ({\bf QFocus\-Event} $\ast$fe)\label{classKListBox_b2}

\item 
virtual void {\bf leave\-Event} ({\bf QEvent} $\ast$e)\label{classKListBox_b3}

\item 
virtual void {\bf contents\-Mouse\-Press\-Event} ({\bf QMouse\-Event} $\ast$e)\label{classKListBox_b4}

\item 
virtual void {\bf contents\-Mouse\-Double\-Click\-Event} ({\bf QMouse\-Event} $\ast$e)\label{classKListBox_b5}

\item 
virtual void {\bf virtual\_\-hook} (int id, void $\ast$data)\label{classKListBox_b6}

\end{CompactItemize}
\subsection*{Protected Attributes}
\begin{CompactItemize}
\item 
bool {\bf m\_\-b\-Use\-Single}\label{classKListBox_p0}

\item 
bool {\bf m\_\-b\-Change\-Cursor\-Over\-Item}\label{classKListBox_p1}

\item 
{\bf QList\-Box\-Item} $\ast$ {\bf m\_\-p\-Current\-Item}\label{classKListBox_p2}

\item 
{\bf QTimer} $\ast$ {\bf m\_\-p\-Auto\-Select}\label{classKListBox_p3}

\item 
int {\bf m\_\-auto\-Select\-Delay}\label{classKListBox_p4}

\end{CompactItemize}


\subsection{Detailed Description}
Extends the functionality of {\bf QList\-Box} to honor the system wide settings for Single Click/Double Click mode, Auto Selection and Change Cursor over Link. A variant of {\bf QList\-Box} that honors KDE's system-wide settings. 

There is a new signal {\bf executed}{\rm (p.\,\pageref{classKListBox_l0})}(). It gets connected to either {\bf QList\-Box::clicked}() or {\bf QList\-Box::double\-Clicked}() depending on the {\bf KDE} wide Single Click/Double Click settings. It is strongly recomended that you use this signal instead of the above mentioned. This way you don180t need to care about the current settings. If you want to get informed when the user selects something connect to the {\bf QList\-Box::selection\-Changed}() signal.



Definition at line 38 of file klistbox.h.

\subsection{Member Function Documentation}
\index{KListBox@{KList\-Box}!executed@{executed}}
\index{executed@{executed}!KListBox@{KList\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KList\-Box::executed ({\bf QList\-Box\-Item} $\ast$ {\em item})\hspace{0.3cm}{\tt  [signal]}}\label{classKListBox_l0}


Emitted whenever the user executes an listbox item. 

That means depending on the {\bf KDE} wide Single Click/Double Click setting the user clicked or double clicked on that item. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em item}]is the pointer to the executed listbox item.\end{description}
\end{Desc}
Note that you may not delete any {\bf QList\-Box\-Item} objects in slots connected to this signal. \index{KListBox@{KList\-Box}!executed@{executed}}
\index{executed@{executed}!KListBox@{KList\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KList\-Box::executed ({\bf QList\-Box\-Item} $\ast$ {\em item}, const {\bf QPoint} \& {\em pos})\hspace{0.3cm}{\tt  [signal]}}\label{classKListBox_l1}


Emitted whenever the user executes an listbox item. 

That means depending on the {\bf KDE} wide Single Click/Double Click setting the user clicked or double clicked on that item. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em item}]is the pointer to the executed listbox item. \item[{\em pos}]is the position where the user has clicked\end{description}
\end{Desc}
Note that you may not delete any {\bf QList\-Box\-Item} objects in slots connected to this signal. \index{KListBox@{KList\-Box}!doubleClicked@{doubleClicked}}
\index{doubleClicked@{doubleClicked}!KListBox@{KList\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KList\-Box::double\-Clicked ({\bf QList\-Box\-Item} $\ast$ {\em item}, const {\bf QPoint} \& {\em pos})\hspace{0.3cm}{\tt  [signal]}}\label{classKListBox_l2}


This signal gets emitted whenever the user double clicks into the listbox. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em item}]The pointer to the clicked listbox item. \item[{\em pos}]The position where the user has clicked.\end{description}
\end{Desc}
Note that you may not delete any {\bf QList\-Box\-Item} objects in slots connected to this signal.

This signal is more or less here for the sake of completeness. You should normally not need to use this. In most cases it180s better to use {\bf executed}{\rm (p.\,\pageref{classKListBox_l0})}() instead. 

Referenced by KCompletion\-Box::KCompletion\-Box().\index{KListBox@{KList\-Box}!slotAutoSelect@{slotAutoSelect}}
\index{slotAutoSelect@{slotAutoSelect}!KListBox@{KList\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KList\-Box::slot\-Auto\-Select ()\hspace{0.3cm}{\tt  [protected, slot]}}\label{classKListBox_j3}


Auto selection happend. 



Definition at line 111 of file klistbox.cpp.

References QList\-Box::clear\-Selection(), QList\-Box::current\-Item(), QList\-Box::index(), QList\-Box\-Item::is\-Selected(), QList\-Box::item(), QList\-Box\-Item::next(), QList\-Box::selection\-Changed(), QList\-Box::selection\-Mode(), QList\-Box::set\-Current\-Item(), QList\-Box::set\-Selected(), and QList\-Box::trigger\-Update().

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