\section{KIcon\-View Class Reference}
\label{classKIconView}\index{KIconView@{KIconView}}
A variant of {\bf QIcon\-View} that honors KDE's system-wide settings.  


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

Inheritance diagram for KIcon\-View:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=103pt]{classKIconView__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for KIcon\-View:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=159pt]{classKIconView__coll__graph}
\end{center}
\end{figure}
\subsection*{Public Types}
\begin{CompactItemize}
\item 
enum {\bf Mode} \{ {\bf Execute}, 
{\bf Select}
 \}
\end{CompactItemize}
\subsection*{Signals}
\begin{CompactItemize}
\item 
void {\bf executed} ({\bf QIcon\-View\-Item} $\ast$item)
\item 
void {\bf executed} ({\bf QIcon\-View\-Item} $\ast$item, const {\bf QPoint} \&pos)
\item 
void {\bf held} ({\bf QIcon\-View\-Item} $\ast$item)
\item 
void {\bf double\-Clicked} ({\bf QIcon\-View\-Item} $\ast$item, const {\bf QPoint} \&pos)
\end{CompactItemize}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf KIcon\-View} ({\bf QWidget} $\ast$parent=0, const char $\ast$name=0, WFlags f=0)\label{classKIconView_a0}

\item 
void {\bf set\-Mode} ({\bf Mode} m)
\item 
{\bf Mode} {\bf mode} () const 
\item 
virtual void {\bf set\-Font} (const {\bf QFont} \&)
\item 
void {\bf set\-Icon\-Text\-Height} (int n)
\item 
int {\bf icon\-Text\-Height} () const 
\item 
virtual void {\bf take\-Item} ({\bf QIcon\-View\-Item} $\ast$item)
\end{CompactItemize}
\subsection*{Protected Slots}
\begin{CompactItemize}
\item 
void {\bf slot\-On\-Item} ({\bf QIcon\-View\-Item} $\ast$item)\label{classKIconView_j0}

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

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

\item 
void {\bf slot\-Auto\-Select} ()
\end{CompactItemize}
\subsection*{Protected Member Functions}
\begin{CompactItemize}
\item 
void {\bf emit\-Execute} ({\bf QIcon\-View\-Item} $\ast$item, const {\bf QPoint} \&pos)\label{classKIconView_b0}

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

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

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

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

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

\item 
virtual void {\bf contents\-Drag\-Enter\-Event} ({\bf QDrag\-Enter\-Event} $\ast$e)\label{classKIconView_b6}

\item 
virtual void {\bf contents\-Drag\-Move\-Event} ({\bf QDrag\-Move\-Event} $\ast$e)\label{classKIconView_b7}

\item 
virtual void {\bf contents\-Drop\-Event} ({\bf QDrop\-Event} $\ast$e)\label{classKIconView_b8}

\item 
virtual void {\bf wheel\-Event} ({\bf QWheel\-Event} $\ast$e)\label{classKIconView_b9}

\item 
void {\bf cancel\-Pending\-Held\-Signal} ()
\item 
virtual void {\bf virtual\_\-hook} (int id, void $\ast$data)\label{classKIconView_b11}

\end{CompactItemize}
\subsection*{Properties}
\begin{CompactItemize}
\item 
{\bf Mode} {\bf mode}\label{classKIconView_00}

\end{CompactItemize}
\subsection*{Friends}
\begin{CompactItemize}
\item 
class {\bf KIcon\-View\-Item}\label{classKIconView_n0}

\end{CompactItemize}


\subsection{Detailed Description}
A variant of {\bf QIcon\-View} that honors KDE's system-wide settings. 

This Widget extends the functionality of {\bf QIcon\-View} to honor the system wide settings for Single Click/Double Click mode, Auto Selection and Change Cursor over Link.

There is a new signal {\bf executed()}{\rm (p.\,\pageref{classKIconView_l0})}. It gets connected to either {\bf QIcon\-View::clicked()} or {\bf QIcon\-View::double\-Clicked()} depending on the {\bf KDE} wide Single Click/Double Click settings. It is strongly recommended 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 QIcon\-View::selection\-Changed()} signal. 



Definition at line 42 of file kiconview.h.

\subsection{Member Enumeration Documentation}
\index{KIconView@{KIcon\-View}!Mode@{Mode}}
\index{Mode@{Mode}!KIconView@{KIcon\-View}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf enum} {\bf KIcon\-View::Mode}}\label{classKIconView_w2}


KIcon\-View has two different operating modes. 

Execute mode is depending on the configuration of single-click or double-click where the signal {\bf executed()}{\rm (p.\,\pageref{classKIconView_l0})} will be emitted upon click/double-click. In Select mode, this signal will not be emitted.

Default is Execute mode. 

Definition at line 62 of file kiconview.h.

\subsection{Member Function Documentation}
\index{KIconView@{KIcon\-View}!setMode@{setMode}}
\index{setMode@{setMode}!KIconView@{KIcon\-View}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIcon\-View::set\-Mode ({\bf Mode} {\em m})}\label{classKIconView_a2}


Sets the mode to Execute or Select. 

\begin{itemize}
\item In Execute mode, the signal {\bf executed()}{\rm (p.\,\pageref{classKIconView_l0})} will be emitted when the user clicks/double-clicks an item. \item Select mode is the normal {\bf QIcon\-View} mode.\end{itemize}
Default is Execute. 

Definition at line 89 of file kiconview.cpp.\index{KIconView@{KIcon\-View}!mode@{mode}}
\index{mode@{mode}!KIconView@{KIcon\-View}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Mode} KIcon\-View::mode () const}\label{classKIconView_a3}


\begin{Desc}
\item[Returns:]the current Mode, either Execute or Select. \end{Desc}
\index{KIconView@{KIcon\-View}!setFont@{setFont}}
\index{setFont@{setFont}!KIconView@{KIcon\-View}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIcon\-View::set\-Font (const {\bf QFont} \&)\hspace{0.3cm}{\tt  [virtual]}}\label{classKIconView_a4}


Reimplemented for internal purposes. 



Definition at line 398 of file kiconview.cpp.

Referenced by set\-Icon\-Text\-Height().\index{KIconView@{KIcon\-View}!setIconTextHeight@{setIconTextHeight}}
\index{setIconTextHeight@{setIconTextHeight}!KIconView@{KIcon\-View}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIcon\-View::set\-Icon\-Text\-Height (int {\em n})}\label{classKIconView_a5}


Set the maximum number of lines that will be used to display icon text. 

Setting this value will enable word-wrap, too. \begin{Desc}
\item[Since:]3.3\end{Desc}
\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em n}]Number of lines \end{description}
\end{Desc}


Definition at line 429 of file kiconview.cpp.

References icon\-Text\-Height(), set\-Font(), and QIcon\-View::set\-Word\-Wrap\-Icon\-Text().\index{KIconView@{KIcon\-View}!iconTextHeight@{iconTextHeight}}
\index{iconTextHeight@{iconTextHeight}!KIconView@{KIcon\-View}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KIcon\-View::icon\-Text\-Height () const}\label{classKIconView_a6}


\begin{Desc}
\item[Returns:]The height of icon text in lines \end{Desc}
\begin{Desc}
\item[Since:]3.3 \end{Desc}


Definition at line 424 of file kiconview.cpp.

References QIcon\-View::word\-Wrap\-Icon\-Text().

Referenced by set\-Icon\-Text\-Height().\index{KIconView@{KIcon\-View}!takeItem@{takeItem}}
\index{takeItem@{takeItem}!KIconView@{KIcon\-View}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIcon\-View::take\-Item ({\bf QIcon\-View\-Item} $\ast$ {\em item})\hspace{0.3cm}{\tt  [virtual]}}\label{classKIconView_a7}


Reimplemented for {\bf held()}{\rm (p.\,\pageref{classKIconView_l2})} signal behavior internal purposes. 



Reimplemented from {\bf QIcon\-View}.

Definition at line 368 of file kiconview.cpp.

References QIcon\-View::take\-Item().\index{KIconView@{KIcon\-View}!executed@{executed}}
\index{executed@{executed}!KIconView@{KIcon\-View}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIcon\-View::executed ({\bf QIcon\-View\-Item} $\ast$ {\em item})\hspace{0.3cm}{\tt  [signal]}}\label{classKIconView_l0}


This signal is emitted whenever the user executes an iconview 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 iconview item.\end{description}
\end{Desc}
Note that you may not delete any {\bf QIcon\-View\-Item} objects in slots connected to this signal. \index{KIconView@{KIcon\-View}!executed@{executed}}
\index{executed@{executed}!KIconView@{KIcon\-View}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIcon\-View::executed ({\bf QIcon\-View\-Item} $\ast$ {\em item}, const {\bf QPoint} \& {\em pos})\hspace{0.3cm}{\tt  [signal]}}\label{classKIconView_l1}


This signal is emitted whenever the user executes an iconview 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 iconview item. \item[{\em pos}]is the position where the user has clicked\end{description}
\end{Desc}
Note that you may not delete any {\bf QIcon\-View\-Item} objects in slots connected to this signal. \index{KIconView@{KIcon\-View}!held@{held}}
\index{held@{held}!KIconView@{KIcon\-View}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIcon\-View::held ({\bf QIcon\-View\-Item} $\ast$ {\em item})\hspace{0.3cm}{\tt  [signal]}}\label{classKIconView_l2}


This signal is emitted whenever the user hold something on an iconview during a drag'n'drop. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em item}]is the pointer to the iconview item the hold event occur.\end{description}
\end{Desc}
Note that you may not delete any {\bf QIcon\-View\-Item} objects in slots connected to this signal. \index{KIconView@{KIcon\-View}!doubleClicked@{doubleClicked}}
\index{doubleClicked@{doubleClicked}!KIconView@{KIcon\-View}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIcon\-View::double\-Clicked ({\bf QIcon\-View\-Item} $\ast$ {\em item}, const {\bf QPoint} \& {\em pos})\hspace{0.3cm}{\tt  [signal]}}\label{classKIconView_l3}


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

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em item}]is the pointer to the clicked iconview item. \item[{\em pos}]is the position where the user has clicked, and\end{description}
\end{Desc}
Note that you may not delete any {\bf QIcon\-View\-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 it's better to use {\bf executed()}{\rm (p.\,\pageref{classKIconView_l0})} instead. \index{KIconView@{KIcon\-View}!slotAutoSelect@{slotAutoSelect}}
\index{slotAutoSelect@{slotAutoSelect}!KIconView@{KIcon\-View}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIcon\-View::slot\-Auto\-Select ()\hspace{0.3cm}{\tt  [protected, slot]}}\label{classKIconView_j3}


Auto selection happend. 



Definition at line 159 of file kiconview.cpp.

References QIcon\-View::clear\-Selection(), QIcon\-View::current\-Item(), endl(), QIcon\-View::first\-Item(), QIcon\-View\-Item::height(), QIcon\-View::index(), QIcon\-View\-Item::intersects(), QIcon\-View\-Item::is\-Selected(), kd\-Debug(), KApplication::keyboard\-Mouse\-State(), QIcon\-View\-Item::next\-Item(), QRect::normalize(), QIcon\-View\-Item::rect(), QIcon\-View::selection\-Changed(), QIcon\-View::selection\-Mode(), QIcon\-View::set\-Current\-Item(), QRect::set\-Height(), QIcon\-View::set\-Selected(), QRect::set\-Width(), QRect::unite(), QIcon\-View\-Item::width(), QIcon\-View\-Item::x(), and QIcon\-View\-Item::y().\index{KIconView@{KIcon\-View}!cancelPendingHeldSignal@{cancelPendingHeldSignal}}
\index{cancelPendingHeldSignal@{cancelPendingHeldSignal}!KIconView@{KIcon\-View}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIcon\-View::cancel\-Pending\-Held\-Signal ()\hspace{0.3cm}{\tt  [protected]}}\label{classKIconView_b10}


This method allows to handle correctly cases where a subclass needs the {\bf held()}{\rm (p.\,\pageref{classKIconView_l2})} signal to not be triggered without calling a KIcon\-View::contents\-Drag$\ast$Event() method (which have side effects because they forward to {\bf QIcon\-View}). 



Definition at line 379 of file kiconview.cpp.

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