\section{KURLBar\-Item Class Reference}
\label{classKURLBarItem}\index{KURLBarItem@{KURLBarItem}}
An item to be used in {\bf KURLBar}{\rm (p.\,\pageref{classKURLBar})} / {\bf KURLBar\-List\-Box}{\rm (p.\,\pageref{classKURLBarListBox})}.  


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

Inheritance diagram for KURLBar\-Item:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=65pt]{classKURLBarItem__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for KURLBar\-Item:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=301pt]{classKURLBarItem__coll__graph}
\end{center}
\end{figure}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf KURLBar\-Item} ({\bf KURLBar} $\ast$parent, const  {\bf KURL} \&url, const  {\bf QString} \&description=QString::null, const  {\bf QString} \&icon=QString::null, {\bf KIcon::Group} group=KIcon::Panel)
\begin{CompactList}\small\item\em Creates a KURLBar\-Item to be used in the {\tt parent} {\bf KURLBar}{\rm (p.\,\pageref{classKURLBar})}. \item\end{CompactList}\item 
{\bf $\sim$KURLBar\-Item} ()
\begin{CompactList}\small\item\em Destroys the item. \item\end{CompactList}\item 
void {\bf set\-URL} (const  {\bf KURL} \&url)
\begin{CompactList}\small\item\em Sets {\tt url} for this item. \item\end{CompactList}\item 
void {\bf set\-Icon} (const  {\bf QString} \&icon, {\bf KIcon::Group} group=KIcon::Panel)
\begin{CompactList}\small\item\em {\tt sets} the icon for this item. \item\end{CompactList}\item 
void {\bf set\-Description} (const  {\bf QString} \&desc)
\begin{CompactList}\small\item\em Sets the description of this item that will be shown as item-text. \item\end{CompactList}\item 
void {\bf set\-Tool\-Tip} (const  {\bf QString} \&tip)
\begin{CompactList}\small\item\em Sets a tooltip to be used for this item. \item\end{CompactList}\item 
{\bf QSize} {\bf size\-Hint} () const 
\begin{CompactList}\small\item\em returns the preferred size of this item \begin{Desc}
\item[Since:]3.1 \end{Desc}
\item\end{CompactList}\item 
virtual int {\bf width} (const  {\bf QList\-Box} $\ast$) const 
\begin{CompactList}\small\item\em returns the width of this item. \item\end{CompactList}\item 
virtual int {\bf height} (const  {\bf QList\-Box} $\ast$) const 
\begin{CompactList}\small\item\em returns the height of this item. \item\end{CompactList}\item 
const  {\bf KURL} \& {\bf url} () const 
\begin{CompactList}\small\item\em returns the url of this item. \item\end{CompactList}\item 
const  {\bf QString} \& {\bf description} () const 
\begin{CompactList}\small\item\em returns the description of this item. \item\end{CompactList}\item 
const  {\bf QString} \& {\bf icon} () const 
\begin{CompactList}\small\item\em returns the icon of this item. \item\end{CompactList}\item 
{\bf QString} {\bf tool\-Tip} () const 
\begin{CompactList}\small\item\em returns the tooltip of this item. \item\end{CompactList}\item 
{\bf KIcon::Group} {\bf icon\-Group} () const 
\begin{CompactList}\small\item\em returns the icon-group of this item (determines icon-effects). \item\end{CompactList}\item 
virtual const  {\bf QPixmap} $\ast$ {\bf pixmap} () const 
\begin{CompactList}\small\item\em returns the pixmap of this item. \item\end{CompactList}\item 
void {\bf set\-Application\-Local} (bool local)
\begin{CompactList}\small\item\em Makes this item a local or global one. \item\end{CompactList}\item 
bool {\bf application\-Local} () const 
\begin{CompactList}\small\item\em returns whether this is a global item or a local one. \item\end{CompactList}\end{CompactItemize}
\subsection*{Protected Member Functions}
\begin{CompactItemize}
\item 
virtual void {\bf paint} ({\bf QPainter} $\ast$p)\label{classKURLBarItem_b0}

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

\end{CompactItemize}


\subsection{Detailed Description}
An item to be used in {\bf KURLBar}{\rm (p.\,\pageref{classKURLBar})} / {\bf KURLBar\-List\-Box}{\rm (p.\,\pageref{classKURLBarListBox})}. 

All the properties (url, icon, descroption, tooltip) can be changed dynamically.

\begin{Desc}
\item[Author:]Carsten Pfeiffer $<${\tt pfeiffer@kde.org}$>$ \end{Desc}
\begin{Desc}
\item[See also:]{\bf KURLBar}{\rm (p.\,\pageref{classKURLBar})} 

{\bf KURLBar\-List\-Box}{\rm (p.\,\pageref{classKURLBarListBox})} \end{Desc}




Definition at line 42 of file kurlbar.h.

\subsection{Constructor \& Destructor Documentation}
\index{KURLBarItem@{KURLBar\-Item}!KURLBarItem@{KURLBarItem}}
\index{KURLBarItem@{KURLBarItem}!KURLBarItem@{KURLBar\-Item}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KURLBar\-Item::KURLBar\-Item ({\bf KURLBar} $\ast$ {\em parent}, const {\bf KURL} \& {\em url}, const {\bf QString} \& {\em description} = QString::null, const {\bf QString} \& {\em icon} = QString::null, {\bf KIcon::Group} {\em group} = KIcon::Panel)}\label{classKURLBarItem_a0}


Creates a KURLBar\-Item to be used in the {\tt parent} {\bf KURLBar}{\rm (p.\,\pageref{classKURLBar})}. 

You need to insert the item into the listbox manually, if you don't use {\bf KURLBar::insert\-Item()}{\rm (p.\,\pageref{classKURLBar_a2})}.

If description is empty, it will try to use the filename/directory of {\tt url}, which will be shown as text of the item. {\tt url} will be used as tooltip, unless you set a different tip with {\bf set\-Tool\-Tip}{\rm (p.\,\pageref{classKURLBarItem_a5})}() 

Definition at line 74 of file kurlbar.cpp.

References KStd\-Accel::description(), set\-Description(), and set\-Icon().\index{KURLBarItem@{KURLBar\-Item}!~KURLBarItem@{$\sim$KURLBarItem}}
\index{~KURLBarItem@{$\sim$KURLBarItem}!KURLBarItem@{KURLBar\-Item}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KURLBar\-Item::$\sim${\bf KURLBar\-Item} ()}\label{classKURLBarItem_a1}


Destroys the item. 



Definition at line 88 of file kurlbar.cpp.

\subsection{Member Function Documentation}
\index{KURLBarItem@{KURLBar\-Item}!setURL@{setURL}}
\index{setURL@{setURL}!KURLBarItem@{KURLBar\-Item}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar\-Item::set\-URL (const {\bf KURL} \& {\em url})}\label{classKURLBarItem_a2}


Sets {\tt url} for this item. 

Also updates the visible text to the filename/directory of the url, if no description is set. \begin{Desc}
\item[See also:]{\bf url}{\rm (p.\,\pageref{classKURLBarItem_a9})} \end{Desc}


Definition at line 92 of file kurlbar.cpp.

References QString::is\-Empty().

Referenced by KURLBar::edit\-Item().\index{KURLBarItem@{KURLBar\-Item}!setIcon@{setIcon}}
\index{setIcon@{setIcon}!KURLBarItem@{KURLBar\-Item}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar\-Item::set\-Icon (const {\bf QString} \& {\em icon}, {\bf KIcon::Group} {\em group} = KIcon::Panel)}\label{classKURLBarItem_a3}


{\tt sets} the icon for this item. 

See {\bf KIcon\-Loader} for a description of the icon groups. \begin{Desc}
\item[See also:]{\bf icon}{\rm (p.\,\pageref{classKURLBarItem_a11})} \end{Desc}


Definition at line 99 of file kurlbar.cpp.

References KIcon::Default\-State, KGlobal::icon\-Loader(), KIcon\-Loader::load\-Icon(), and KMime\-Type::pixmap\-For\-URL().

Referenced by KURLBar::edit\-Item(), KURLBar\-Item(), and KURLBar::set\-Icon\-Size().\index{KURLBarItem@{KURLBar\-Item}!setDescription@{setDescription}}
\index{setDescription@{setDescription}!KURLBarItem@{KURLBar\-Item}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar\-Item::set\-Description (const {\bf QString} \& {\em desc})}\label{classKURLBarItem_a4}


Sets the description of this item that will be shown as item-text. 

\begin{Desc}
\item[See also:]{\bf description}{\rm (p.\,\pageref{classKURLBarItem_a10})} \end{Desc}


Definition at line 111 of file kurlbar.cpp.

References KURL::file\-Name().

Referenced by KURLBar::edit\-Item(), and KURLBar\-Item().\index{KURLBarItem@{KURLBar\-Item}!setToolTip@{setToolTip}}
\index{setToolTip@{setToolTip}!KURLBarItem@{KURLBar\-Item}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar\-Item::set\-Tool\-Tip (const {\bf QString} \& {\em tip})}\label{classKURLBarItem_a5}


Sets a tooltip to be used for this item. 

\begin{Desc}
\item[See also:]\#toool\-Tip \end{Desc}


Definition at line 117 of file kurlbar.cpp.\index{KURLBarItem@{KURLBar\-Item}!sizeHint@{sizeHint}}
\index{sizeHint@{sizeHint}!KURLBarItem@{KURLBar\-Item}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QSize} KURLBar\-Item::size\-Hint () const}\label{classKURLBarItem_a6}


returns the preferred size of this item \begin{Desc}
\item[Since:]3.1 \end{Desc}




Definition at line 185 of file kurlbar.cpp.

References QPixmap::height(), QList\-Box\-Pixmap::height(), KURLBar::icon\-Size(), KURLBar\-List\-Box::is\-Vertical(), pixmap(), KIcon::Size\-Medium, QPixmap::width(), and QList\-Box\-Pixmap::width().

Referenced by height(), KURLBar::size\-Hint(), and width().\index{KURLBarItem@{KURLBar\-Item}!width@{width}}
\index{width@{width}!KURLBarItem@{KURLBar\-Item}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KURLBar\-Item::width (const {\bf QList\-Box} $\ast$) const\hspace{0.3cm}{\tt  [virtual]}}\label{classKURLBarItem_a7}


returns the width of this item. 



Reimplemented from {\bf QList\-Box\-Pixmap}.

Definition at line 208 of file kurlbar.cpp.

References size\-Hint(), and QSize::width().\index{KURLBarItem@{KURLBar\-Item}!height@{height}}
\index{height@{height}!KURLBarItem@{KURLBar\-Item}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KURLBar\-Item::height (const {\bf QList\-Box} $\ast$) const\hspace{0.3cm}{\tt  [virtual]}}\label{classKURLBarItem_a8}


returns the height of this item. 



Reimplemented from {\bf QList\-Box\-Pixmap}.

Definition at line 216 of file kurlbar.cpp.

References QSize::height(), and size\-Hint().\index{KURLBarItem@{KURLBar\-Item}!url@{url}}
\index{url@{url}!KURLBarItem@{KURLBar\-Item}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf KURL}\& KURLBar\-Item::url () const\hspace{0.3cm}{\tt  [inline]}}\label{classKURLBarItem_a9}


returns the url of this item. 

\begin{Desc}
\item[See also:]{\bf set\-URL}{\rm (p.\,\pageref{classKURLBarItem_a2})} \end{Desc}


Definition at line 106 of file kurlbar.h.

Referenced by KURLBar::current\-URL(), KURLBar\-List\-Box::drag\-Object(), KURLBar::edit\-Item(), KURLBar::set\-Current\-Item(), KURLBar::slot\-Context\-Menu\-Requested(), KURLBar::slot\-Selected(), KFile\-Dialog::toggle\-Speedbar(), and KURLBar::write\-Item().\index{KURLBarItem@{KURLBar\-Item}!description@{description}}
\index{description@{description}!KURLBarItem@{KURLBar\-Item}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf QString}\& KURLBar\-Item::description () const\hspace{0.3cm}{\tt  [inline]}}\label{classKURLBarItem_a10}


returns the description of this item. 

\begin{Desc}
\item[See also:]{\bf set\-Description}{\rm (p.\,\pageref{classKURLBarItem_a4})} \end{Desc}


Definition at line 111 of file kurlbar.h.

Referenced by KURLBar::edit\-Item(), and KURLBar::write\-Item().\index{KURLBarItem@{KURLBar\-Item}!icon@{icon}}
\index{icon@{icon}!KURLBarItem@{KURLBar\-Item}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf QString}\& KURLBar\-Item::icon () const\hspace{0.3cm}{\tt  [inline]}}\label{classKURLBarItem_a11}


returns the icon of this item. 

\begin{Desc}
\item[See also:]{\bf set\-Icon}{\rm (p.\,\pageref{classKURLBarItem_a3})} \end{Desc}


Definition at line 116 of file kurlbar.h.

Referenced by KURLBar::edit\-Item(), KURLBar::set\-Icon\-Size(), and KURLBar::write\-Item().\index{KURLBarItem@{KURLBar\-Item}!toolTip@{toolTip}}
\index{toolTip@{toolTip}!KURLBarItem@{KURLBar\-Item}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KURLBar\-Item::tool\-Tip () const}\label{classKURLBarItem_a12}


returns the tooltip of this item. 

\begin{Desc}
\item[See also:]{\bf set\-Tool\-Tip}{\rm (p.\,\pageref{classKURLBarItem_a5})} \end{Desc}


Definition at line 122 of file kurlbar.cpp.

References QString::is\-Empty(), and KURL::pretty\-URL().\index{KURLBarItem@{KURLBar\-Item}!iconGroup@{iconGroup}}
\index{iconGroup@{iconGroup}!KURLBarItem@{KURLBar\-Item}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KIcon::Group} KURLBar\-Item::icon\-Group () const\hspace{0.3cm}{\tt  [inline]}}\label{classKURLBarItem_a13}


returns the icon-group of this item (determines icon-effects). 

\begin{Desc}
\item[See also:]{\bf set\-Icon}{\rm (p.\,\pageref{classKURLBarItem_a3})} \end{Desc}


Definition at line 126 of file kurlbar.h.

References KIcon::Group.

Referenced by KURLBar::set\-Icon\-Size(), and KURLBar::write\-Item().\index{KURLBarItem@{KURLBar\-Item}!pixmap@{pixmap}}
\index{pixmap@{pixmap}!KURLBarItem@{KURLBar\-Item}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}virtual const {\bf QPixmap}$\ast$ KURLBar\-Item::pixmap () const\hspace{0.3cm}{\tt  [inline, virtual]}}\label{classKURLBarItem_a14}


returns the pixmap of this item. 



Reimplemented from {\bf QList\-Box\-Pixmap}.

Definition at line 130 of file kurlbar.h.

Referenced by size\-Hint().\index{KURLBarItem@{KURLBar\-Item}!setApplicationLocal@{setApplicationLocal}}
\index{setApplicationLocal@{setApplicationLocal}!KURLBarItem@{KURLBar\-Item}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar\-Item::set\-Application\-Local (bool {\em local})\hspace{0.3cm}{\tt  [inline]}}\label{classKURLBarItem_a15}


Makes this item a local or global one. 

\begin{Desc}
\item[See also:]{\bf application\-Local}{\rm (p.\,\pageref{classKURLBarItem_a16})} \end{Desc}


Definition at line 136 of file kurlbar.h.

Referenced by KURLBar::edit\-Item(), and KURLBar::insert\-Item().\index{KURLBarItem@{KURLBar\-Item}!applicationLocal@{applicationLocal}}
\index{applicationLocal@{applicationLocal}!KURLBarItem@{KURLBar\-Item}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KURLBar\-Item::application\-Local () const\hspace{0.3cm}{\tt  [inline]}}\label{classKURLBarItem_a16}


returns whether this is a global item or a local one. 

{\bf KURLBar}{\rm (p.\,\pageref{classKURLBar})} can differentiate between global and local items (only for the current application) for easy extensiblity. \begin{Desc}
\item[See also:]{\bf set\-Application\-Local}{\rm (p.\,\pageref{classKURLBarItem_a15})} \end{Desc}


Definition at line 143 of file kurlbar.h.

Referenced by KURLBar::edit\-Item(), and KURLBar::write\-Config().

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