\section{KURLBar Class Reference}
\label{classKURLBar}\index{KURLBar@{KURLBar}}
KURLBar is a widget that displays icons together with a description. A URL-bar widget, as used in the {\bf KFile\-Dialog}{\rm (p.\,\pageref{classKFileDialog})}.  


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

Inheritance diagram for KURLBar:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=47pt]{classKURLBar__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for KURLBar:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=274pt]{classKURLBar__coll__graph}
\end{center}
\end{figure}
\subsection*{Public Slots}
\begin{CompactItemize}
\item 
virtual void {\bf set\-Current\-Item} (const {\bf KURL} \&url)
\end{CompactItemize}
\subsection*{Signals}
\begin{CompactItemize}
\item 
void {\bf activated} (const {\bf KURL} \&url)
\end{CompactItemize}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf KURLBar} (bool use\-Global\-Items, {\bf QWidget} $\ast$parent=0, const char $\ast$name=0, WFlags f=0)
\item 
{\bf $\sim$KURLBar} ()
\item 
virtual {\bf KURLBar\-Item} $\ast$ {\bf insert\-Item} (const {\bf KURL} \&url, const {\bf QString} \&description, bool application\-Local=true, const {\bf QString} \&icon=QString::null, {\bf KIcon::Group} group={\bf KIcon::Panel})
\item 
virtual {\bf KURLBar\-Item} $\ast$ {\bf insert\-Dynamic\-Item} (const {\bf KURL} \&url, const {\bf QString} \&description, const {\bf QString} \&icon=QString::null, {\bf KIcon::Group} group={\bf KIcon::Panel})
\item 
virtual void {\bf set\-Orientation} (Qt::Orientation orient)
\item 
Orientation {\bf orientation} () const 
\item 
virtual void {\bf set\-List\-Box} ({\bf KURLBar\-List\-Box} $\ast$)
\item 
{\bf KURLBar\-List\-Box} $\ast$ {\bf list\-Box} () const 
\item 
virtual void {\bf set\-Icon\-Size} (int size)
\item 
int {\bf icon\-Size} () const 
\item 
virtual void {\bf clear} ()
\item 
virtual {\bf QSize} {\bf size\-Hint} () const 
\item 
virtual {\bf QSize} {\bf minimum\-Size\-Hint} () const 
\item 
virtual void {\bf read\-Config} ({\bf KConfig} $\ast$config, const {\bf QString} \&item\-Group)
\item 
virtual void {\bf write\-Config} ({\bf KConfig} $\ast$config, const {\bf QString} \&item\-Group)
\item 
virtual void {\bf read\-Item} (int i, {\bf KConfig} $\ast$config, bool application\-Local)
\item 
virtual void {\bf write\-Item} ({\bf KURLBar\-Item} $\ast$item, int i, {\bf KConfig} $\ast$, bool global)
\item 
{\bf KURLBar\-Item} $\ast$ {\bf current\-Item} () const 
\item 
{\bf KURL} {\bf current\-URL} () const 
\item 
bool {\bf is\-Modified} () const 
\item 
bool {\bf is\-Immutable} () const 
\item 
bool {\bf is\-Vertical} () const 
\end{CompactItemize}
\subsection*{Protected Slots}
\begin{CompactItemize}
\item 
virtual void {\bf slot\-Context\-Menu\-Requested} ({\bf QList\-Box\-Item} $\ast$, const {\bf QPoint} \&pos)
\item 
virtual void {\bf slot\-Selected} ({\bf QList\-Box\-Item} $\ast$)
\item 
virtual void {\bf slot\-Dropped} ({\bf QDrop\-Event} $\ast$)
\end{CompactItemize}
\subsection*{Protected Member Functions}
\begin{CompactItemize}
\item 
virtual bool {\bf add\-New\-Item} ()
\item 
virtual bool {\bf edit\-Item} ({\bf KURLBar\-Item} $\ast$item)
\item 
virtual void {\bf resize\-Event} ({\bf QResize\-Event} $\ast$)\label{classKURLBar_b2}

\item 
virtual void {\bf palette\-Change} (const {\bf QPalette} \&)\label{classKURLBar_b3}

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

\end{CompactItemize}
\subsection*{Protected Attributes}
\begin{CompactItemize}
\item 
{\bf KURLBar\-Item} $\ast$ {\bf m\_\-active\-Item}
\item 
bool {\bf m\_\-use\-Global}:1
\item 
bool {\bf m\_\-is\-Modified}:1
\item 
bool {\bf m\_\-is\-Immutable}:1
\end{CompactItemize}


\subsection{Detailed Description}
KURLBar is a widget that displays icons together with a description. A URL-bar widget, as used in the {\bf KFile\-Dialog}{\rm (p.\,\pageref{classKFileDialog})}. 

They can be arranged either horizontally or vertically. Clicking on an item will cause the {\bf activated()}{\rm (p.\,\pageref{classKURLBar_l0})} signal to be emitted. The user can edit existing items by choosing \char`\"{}Edit entry\char`\"{} in the contextmenu. He can also remove or add new entries (via drag\&drop or the context menu).

KURLBar offers the methods {\bf read\-Config()}{\rm (p.\,\pageref{classKURLBar_a13})} and {\bf write\-Config()}{\rm (p.\,\pageref{classKURLBar_a14})} to read and write the configuration of all the entries. It can differentiate between global and local entries -- global entries will be saved in the global configuration (kdeglobals), while local entries will be saved in your application's {\bf KConfig} object.

Due to the configurability, you usually only insert some default entries once and then solely use the read and write\-Config methods to preserve the user's configuration.

The widget has a \char`\"{}current\char`\"{} item, that is visualized to differentiate it from others.

\begin{Desc}
\item[Author:]Carsten Pfeiffer $<${\tt pfeiffer@kde.org}$>$ \end{Desc}




Definition at line 230 of file kurlbar.h.

\subsection{Constructor \& Destructor Documentation}
\index{KURLBar@{KURLBar}!KURLBar@{KURLBar}}
\index{KURLBar@{KURLBar}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KURLBar::KURLBar (bool {\em use\-Global\-Items}, {\bf QWidget} $\ast$ {\em parent} = {\tt 0}, const char $\ast$ {\em name} = {\tt 0}, WFlags {\em f} = {\tt 0})}\label{classKURLBar_a0}


Constructs a KURLBar. 

Set {\tt use\-Global\-Items} to true if you want to allow global/local item separation. 

Definition at line 330 of file kurlbar.cpp.

References QWhats\-This::add(), is\-Vertical(), m\_\-active\-Item, m\_\-is\-Immutable, m\_\-is\-Modified, m\_\-use\-Global, and set\-List\-Box().\index{KURLBar@{KURLBar}!~KURLBar@{$\sim$KURLBar}}
\index{~KURLBar@{$\sim$KURLBar}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KURLBar::$\sim${\bf KURLBar} ()}\label{classKURLBar_a1}


Destroys the KURLBar. 



Definition at line 353 of file kurlbar.cpp.

\subsection{Member Function Documentation}
\index{KURLBar@{KURLBar}!insertItem@{insertItem}}
\index{insertItem@{insertItem}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KURLBar\-Item} $\ast$ KURLBar::insert\-Item (const {\bf KURL} \& {\em url}, const {\bf QString} \& {\em description}, bool {\em application\-Local} = {\tt true}, const {\bf QString} \& {\em icon} = {\tt QString::null}, {\bf KIcon::Group} {\em group} = {\tt {\bf KIcon::Panel}})\hspace{0.3cm}{\tt  [virtual]}}\label{classKURLBar_a2}


Inserts a new item into the KURLBar and returns the created {\bf KURLBar\-Item}{\rm (p.\,\pageref{classKURLBarItem})}. 

{\tt url} the url of the item {\tt description} the description of the item (shown in the view) {\tt application\-Local} whether this should be a global or a local item {\tt icon} an icon -- if empty, the default icon for the url will be used {\tt group} the icon-group for using icon-effects 

Definition at line 358 of file kurlbar.cpp.

References QList\-Box::insert\-Item(), and KURLBar\-Item::set\-Application\-Local().

Referenced by read\-Item(), and slot\-Dropped().\index{KURLBar@{KURLBar}!insertDynamicItem@{insertDynamicItem}}
\index{insertDynamicItem@{insertDynamicItem}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KURLBar\-Item} $\ast$ KURLBar::insert\-Dynamic\-Item (const {\bf KURL} \& {\em url}, const {\bf QString} \& {\em description}, const {\bf QString} \& {\em icon} = {\tt QString::null}, {\bf KIcon::Group} {\em group} = {\tt {\bf KIcon::Panel}})\hspace{0.3cm}{\tt  [virtual]}}\label{classKURLBar_a3}


Inserts a new dynamic item into the KURLBar and returns the created {\bf KURLBar\-Item}{\rm (p.\,\pageref{classKURLBarItem})}. 

{\tt url} the url of the item {\tt description} the description of the item (shown in the view) {\tt icon} an icon -- if empty, the default icon for the url will be used {\tt group} the icon-group for using icon-effects \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 368 of file kurlbar.cpp.

References QList\-Box::insert\-Item().\index{KURLBar@{KURLBar}!setOrientation@{setOrientation}}
\index{setOrientation@{setOrientation}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar::set\-Orientation (Qt::Orientation {\em orient})\hspace{0.3cm}{\tt  [virtual]}}\label{classKURLBar_a4}


The items can be arranged either vertically in one column or horizontally in one row. 

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


Definition at line 376 of file kurlbar.cpp.

References is\-Vertical(), and KURLBar\-List\-Box::set\-Orientation().

Referenced by set\-List\-Box().\index{KURLBar@{KURLBar}!orientation@{orientation}}
\index{orientation@{orientation}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Qt::Orientation KURLBar::orientation () const}\label{classKURLBar_a5}


\begin{Desc}
\item[Returns:]the current orientation mode. \end{Desc}
\begin{Desc}
\item[See also:]{\bf set\-Orientation}{\rm (p.\,\pageref{classKURLBar_a4})} \end{Desc}


Definition at line 387 of file kurlbar.cpp.

References KURLBar\-List\-Box::orientation().\index{KURLBar@{KURLBar}!setListBox@{setListBox}}
\index{setListBox@{setListBox}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar::set\-List\-Box ({\bf KURLBar\-List\-Box} $\ast$)\hspace{0.3cm}{\tt  [virtual]}}\label{classKURLBar_a6}


Allows to set a custom {\bf KURLBar\-List\-Box}{\rm (p.\,\pageref{classKURLBarListBox})}. 

Note: The previous listbox will be deleted. Items of the previous listbox will not be moved to the new box. \begin{Desc}
\item[See also:]{\bf list\-Box}{\rm (p.\,\pageref{classKURLBar_a7})} \end{Desc}


Definition at line 392 of file kurlbar.cpp.

References set\-Orientation(), QList\-Box::set\-Selection\-Mode(), slot\-Context\-Menu\-Requested(), slot\-Dropped(), and slot\-Selected().

Referenced by KURLBar().\index{KURLBar@{KURLBar}!listBox@{listBox}}
\index{listBox@{listBox}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KURLBar\-List\-Box}$\ast$ KURLBar::list\-Box () const\hspace{0.3cm}{\tt  [inline]}}\label{classKURLBar_a7}


\begin{Desc}
\item[Returns:]the {\bf KURLBar\-List\-Box}{\rm (p.\,\pageref{classKURLBarListBox})} that is used. \end{Desc}
\begin{Desc}
\item[See also:]{\bf set\-List\-Box}{\rm (p.\,\pageref{classKURLBar_a6})} \end{Desc}


Definition at line 298 of file kurlbar.h.\index{KURLBar@{KURLBar}!setIconSize@{setIconSize}}
\index{setIconSize@{setIconSize}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar::set\-Icon\-Size (int {\em size})\hspace{0.3cm}{\tt  [virtual]}}\label{classKURLBar_a8}


Sets the default iconsize to be used for items inserted with insert\-Item. 

By default {\bf KIcon::Size\-Medium}. \begin{Desc}
\item[See also:]iconsize \end{Desc}


Definition at line 422 of file kurlbar.cpp.

References QList\-Box::first\-Item(), KURLBar\-Item::icon(), KURLBar\-Item::icon\-Group(), KURLBar\-Item::set\-Icon(), and size\-Hint().

Referenced by slot\-Context\-Menu\-Requested().\index{KURLBar@{KURLBar}!iconSize@{iconSize}}
\index{iconSize@{iconSize}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KURLBar::icon\-Size () const\hspace{0.3cm}{\tt  [inline]}}\label{classKURLBar_a9}


\begin{Desc}
\item[Returns:]the default iconsize used for items inserted with insert\-Item. By default {\bf KIcon::Size\-Medium} \end{Desc}
\begin{Desc}
\item[See also:]{\bf set\-Icon\-Size}{\rm (p.\,\pageref{classKURLBar_a8})} \end{Desc}


Definition at line 311 of file kurlbar.h.

Referenced by KURLBar\-Item::size\-Hint().\index{KURLBar@{KURLBar}!clear@{clear}}
\index{clear@{clear}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar::clear ()\hspace{0.3cm}{\tt  [virtual]}}\label{classKURLBar_a10}


Clears the view, removes all items. 



Definition at line 440 of file kurlbar.cpp.

References QList\-Box::clear().\index{KURLBar@{KURLBar}!sizeHint@{sizeHint}}
\index{sizeHint@{sizeHint}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QSize} KURLBar::size\-Hint () const\hspace{0.3cm}{\tt  [virtual]}}\label{classKURLBar_a11}


\begin{Desc}
\item[Returns:]a proper sizehint, depending on the orientation and the number of items available. \end{Desc}


Definition at line 467 of file kurlbar.cpp.

References QList\-Box::first\-Item(), QSize::height(), is\-Vertical(), KURLBar\-Item::size\-Hint(), and QSize::width().

Referenced by minimum\-Size\-Hint(), and set\-Icon\-Size().\index{KURLBar@{KURLBar}!minimumSizeHint@{minimumSizeHint}}
\index{minimumSizeHint@{minimumSizeHint}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QSize} KURLBar::minimum\-Size\-Hint () const\hspace{0.3cm}{\tt  [virtual]}}\label{classKURLBar_a12}


\begin{Desc}
\item[Returns:]a proper minimum size (reimplemented) \end{Desc}


Definition at line 509 of file kurlbar.cpp.

References QSize::height(), size\-Hint(), and QSize::width().\index{KURLBar@{KURLBar}!readConfig@{readConfig}}
\index{readConfig@{readConfig}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar::read\-Config ({\bf KConfig} $\ast$ {\em config}, const {\bf QString} \& {\em item\-Group})\hspace{0.3cm}{\tt  [virtual]}}\label{classKURLBar_a13}


Call this method to read a saved configuration from {\tt config}, inside the group {\tt item\-Group}. 

All items in there will be restored. The reading of every item is delegated to the {\bf read\-Item()}{\rm (p.\,\pageref{classKURLBar_a15})} method. 

Definition at line 578 of file kurlbar.cpp.

References KGlobal::config(), m\_\-is\-Immutable, m\_\-use\-Global, read\-Item(), and KConfig\-Base::read\-Num\-Entry().\index{KURLBar@{KURLBar}!writeConfig@{writeConfig}}
\index{writeConfig@{writeConfig}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar::write\-Config ({\bf KConfig} $\ast$ {\em config}, const {\bf QString} \& {\em item\-Group})\hspace{0.3cm}{\tt  [virtual]}}\label{classKURLBar_a14}


Call this method to save the current configuration into {\tt config}, inside the group {\tt icon\-Group}. 

The {\bf write\-Item()}{\rm (p.\,\pageref{classKURLBar_a16})} method is used to save each item. 

Definition at line 616 of file kurlbar.cpp.

References KURLBar\-Item::application\-Local(), QList\-Box::first\-Item(), KURLBar\-Item::is\-Persistent(), m\_\-is\-Modified, m\_\-use\-Global, and write\-Item().\index{KURLBar@{KURLBar}!readItem@{readItem}}
\index{readItem@{readItem}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar::read\-Item (int {\em i}, {\bf KConfig} $\ast$ {\em config}, bool {\em application\-Local})\hspace{0.3cm}{\tt  [virtual]}}\label{classKURLBar_a15}


Called from {\bf read\-Config()}{\rm (p.\,\pageref{classKURLBar_a13})} to read the i'th from {\tt config}. 

After reading a {\bf KURLBar\-Item}{\rm (p.\,\pageref{classKURLBarItem})} is created and initialized with the read values (as well as the given {\tt application\-Local}). 

Definition at line 601 of file kurlbar.cpp.

References KURL::from\-Path\-Or\-URL(), insert\-Item(), KProtocol\-Info::is\-Known\-Protocol(), KURL::is\-Valid(), and QString::number().

Referenced by read\-Config().\index{KURLBar@{KURLBar}!writeItem@{writeItem}}
\index{writeItem@{writeItem}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar::write\-Item ({\bf KURLBar\-Item} $\ast$ {\em item}, int {\em i}, {\bf KConfig} $\ast$, bool {\em global})\hspace{0.3cm}{\tt  [virtual]}}\label{classKURLBar_a16}


Called from {\bf write\-Config()}{\rm (p.\,\pageref{classKURLBar_a14})} to save the {\bf KURLBar\-Item}{\rm (p.\,\pageref{classKURLBarItem})} {\tt item} as the i'th entry in the config-object. 

{\tt global} tell whether it should be saved in the global configuration or not (using KConfig::write\-Entry( key, value, true, global ) ). 

Definition at line 675 of file kurlbar.cpp.

References QString::number().

Referenced by write\-Config().\index{KURLBar@{KURLBar}!currentItem@{currentItem}}
\index{currentItem@{currentItem}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KURLBar\-Item} $\ast$ KURLBar::current\-Item () const}\label{classKURLBar_a17}


\begin{Desc}
\item[Returns:]the current {\bf KURLBar\-Item}{\rm (p.\,\pageref{classKURLBarItem})}, or 0L if none. \end{Desc}
\begin{Desc}
\item[See also:]{\bf set\-Current\-Item}{\rm (p.\,\pageref{classKURLBar_i0})} 

{\bf current\-URL}{\rm (p.\,\pageref{classKURLBar_a18})} \end{Desc}


Definition at line 564 of file kurlbar.cpp.

References QList\-Box::current\-Item(), and QList\-Box::item().

Referenced by current\-URL().\index{KURLBar@{KURLBar}!currentURL@{currentURL}}
\index{currentURL@{currentURL}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KURL} KURLBar::current\-URL () const}\label{classKURLBar_a18}


\begin{Desc}
\item[Returns:]the url of the current item or an invalid url, if there is no current item. \end{Desc}
\begin{Desc}
\item[See also:]{\bf current\-Item}{\rm (p.\,\pageref{classKURLBar_a17})} 

{\bf set\-Current\-Item}{\rm (p.\,\pageref{classKURLBar_i0})} \end{Desc}


Definition at line 572 of file kurlbar.cpp.

References current\-Item(), and KURLBar\-Item::url().\index{KURLBar@{KURLBar}!isModified@{isModified}}
\index{isModified@{isModified}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KURLBar::is\-Modified () const\hspace{0.3cm}{\tt  [inline]}}\label{classKURLBar_a19}


\begin{Desc}
\item[Returns:]true when the urlbar was modified by the user (e.g. by editing/adding/removing one or more entries). Will be reset to false after calling {\bf write\-Config()}{\rm (p.\,\pageref{classKURLBar_a14})}. \end{Desc}


Definition at line 375 of file kurlbar.h.\index{KURLBar@{KURLBar}!isImmutable@{isImmutable}}
\index{isImmutable@{isImmutable}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KURLBar::is\-Immutable () const\hspace{0.3cm}{\tt  [inline]}}\label{classKURLBar_a20}


\begin{Desc}
\item[Returns:]true when the urlbar may not be modified by the user \end{Desc}


Definition at line 380 of file kurlbar.h.\index{KURLBar@{KURLBar}!isVertical@{isVertical}}
\index{isVertical@{isVertical}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KURLBar::is\-Vertical () const\hspace{0.3cm}{\tt  [inline]}}\label{classKURLBar_a21}


\begin{Desc}
\item[Returns:]true if the bar is in vertical mode. \end{Desc}


Definition at line 385 of file kurlbar.h.

Referenced by KURLBar(), set\-Orientation(), and size\-Hint().\index{KURLBar@{KURLBar}!setCurrentItem@{setCurrentItem}}
\index{setCurrentItem@{setCurrentItem}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar::set\-Current\-Item (const {\bf KURL} \& {\em url})\hspace{0.3cm}{\tt  [virtual, slot]}}\label{classKURLBar_i0}


Makes the item with the url {\tt url} the current item. 

Does nothing if no item with that url is available. \begin{Desc}
\item[See also:]{\bf current\-Item}{\rm (p.\,\pageref{classKURLBar_a17})} 

{\bf current\-URL}{\rm (p.\,\pageref{classKURLBar_a18})} \end{Desc}


Definition at line 536 of file kurlbar.cpp.

References QList\-Box::clear\-Selection(), QList\-Box::first\-Item(), m\_\-active\-Item, QList\-Box::set\-Current\-Item(), QList\-Box::set\-Selected(), KURL::url(), and KURLBar\-Item::url().

Referenced by slot\-Context\-Menu\-Requested().\index{KURLBar@{KURLBar}!activated@{activated}}
\index{activated@{activated}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar::activated (const {\bf KURL} \& {\em url})\hspace{0.3cm}{\tt  [signal]}}\label{classKURLBar_l0}


This signal is emitted when the user activated an item, e.g., by clicking on it. 



Referenced by slot\-Selected().\index{KURLBar@{KURLBar}!addNewItem@{addNewItem}}
\index{addNewItem@{addNewItem}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KURLBar::add\-New\-Item ()\hspace{0.3cm}{\tt  [protected, virtual]}}\label{classKURLBar_b0}


Pops up a {\bf KURLBar\-Item\-Dialog}{\rm (p.\,\pageref{classKURLBarItemDialog})} to let the user add a new item. 

Uses {\bf edit\-Item()}{\rm (p.\,\pageref{classKURLBar_b1})} to do the job. \begin{Desc}
\item[Returns:]false if the user aborted the dialog and no item is added. \end{Desc}


Definition at line 773 of file kurlbar.cpp.

References edit\-Item(), and QList\-Box::insert\-Item().

Referenced by slot\-Context\-Menu\-Requested().\index{KURLBar@{KURLBar}!editItem@{editItem}}
\index{editItem@{editItem}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KURLBar::edit\-Item ({\bf KURLBar\-Item} $\ast$ {\em item})\hspace{0.3cm}{\tt  [protected, virtual]}}\label{classKURLBar_b1}


Pops up a {\bf KURLBar\-Item\-Dialog}{\rm (p.\,\pageref{classKURLBarItemDialog})} to let the user edit the properties of {\tt item}. 

Invoked e.g. by {\bf add\-New\-Item()}{\rm (p.\,\pageref{classKURLBar_b0})}, when the user drops a url onto the bar or from the contextmenu. \begin{Desc}
\item[Returns:]false if the user aborted the dialog and {\tt item} is not changed. \end{Desc}


Definition at line 786 of file kurlbar.cpp.

References m\_\-is\-Modified, m\_\-use\-Global, QList\-Box::trigger\-Update(), and KURLBar\-Item::url().

Referenced by add\-New\-Item(), and slot\-Context\-Menu\-Requested().\index{KURLBar@{KURLBar}!slotContextMenuRequested@{slotContextMenuRequested}}
\index{slotContextMenuRequested@{slotContextMenuRequested}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar::slot\-Context\-Menu\-Requested ({\bf QList\-Box\-Item} $\ast$, const {\bf QPoint} \& {\em pos})\hspace{0.3cm}{\tt  [protected, virtual, slot]}}\label{classKURLBar_j0}


Reimplemented to show a contextmenu, allowing the user to add, edit or remove items, or change the iconsize. 



Definition at line 713 of file kurlbar.cpp.

References add\-New\-Item(), edit\-Item(), QPopup\-Menu::exec(), QPopup\-Menu::insert\-Item(), QPopup\-Menu::insert\-Separator(), KURLBar\-Item::is\-Persistent(), m\_\-active\-Item, m\_\-is\-Immutable, m\_\-is\-Modified, set\-Current\-Item(), set\-Icon\-Size(), QList\-Box::trigger\-Update(), and KURLBar\-Item::url().

Referenced by set\-List\-Box().\index{KURLBar@{KURLBar}!slotSelected@{slotSelected}}
\index{slotSelected@{slotSelected}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar::slot\-Selected ({\bf QList\-Box\-Item} $\ast$)\hspace{0.3cm}{\tt  [protected, virtual, slot]}}\label{classKURLBar_j1}


Called when an item has been selected. 

Emits the {\bf activated()}{\rm (p.\,\pageref{classKURLBar_l0})} signal. 

Definition at line 525 of file kurlbar.cpp.

References activated(), m\_\-active\-Item, QList\-Box::set\-Current\-Item(), and KURLBar\-Item::url().

Referenced by set\-List\-Box().\index{KURLBar@{KURLBar}!slotDropped@{slotDropped}}
\index{slotDropped@{slotDropped}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar::slot\-Dropped ({\bf QDrop\-Event} $\ast$)\hspace{0.3cm}{\tt  [protected, virtual, slot]}}\label{classKURLBar_j2}


Called when a url was dropped onto the bar to show a {\bf KURLBar\-Item\-Dialog}{\rm (p.\,\pageref{classKURLBarItemDialog})}. 



Definition at line 695 of file kurlbar.cpp.

References QValue\-List::begin(), QValue\-List::end(), insert\-Item(), and m\_\-is\-Modified.

Referenced by set\-List\-Box().

\subsection{Member Data Documentation}
\index{KURLBar@{KURLBar}!m_activeItem@{m\_\-activeItem}}
\index{m_activeItem@{m\_\-activeItem}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KURLBar\-Item}$\ast$ {\bf KURLBar::m\_\-active\-Item}\hspace{0.3cm}{\tt  [protected]}}\label{classKURLBar_p0}


The currently active item. 



Definition at line 426 of file kurlbar.h.

Referenced by KURLBar(), set\-Current\-Item(), slot\-Context\-Menu\-Requested(), and slot\-Selected().\index{KURLBar@{KURLBar}!m_useGlobal@{m\_\-useGlobal}}
\index{m_useGlobal@{m\_\-useGlobal}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool {\bf KURLBar::m\_\-use\-Global}\hspace{0.3cm}{\tt  [protected]}}\label{classKURLBar_p1}


Whether we support global entries or just local ones. 



Definition at line 430 of file kurlbar.h.

Referenced by edit\-Item(), KURLBar(), read\-Config(), and write\-Config().\index{KURLBar@{KURLBar}!m_isModified@{m\_\-isModified}}
\index{m_isModified@{m\_\-isModified}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool {\bf KURLBar::m\_\-is\-Modified}\hspace{0.3cm}{\tt  [protected]}}\label{classKURLBar_p2}


Whether the urlbar was modified by the user (e.g. 

by editing/adding/removing an item). 

Definition at line 436 of file kurlbar.h.

Referenced by edit\-Item(), KURLBar(), slot\-Context\-Menu\-Requested(), slot\-Dropped(), and write\-Config().\index{KURLBar@{KURLBar}!m_isImmutable@{m\_\-isImmutable}}
\index{m_isImmutable@{m\_\-isImmutable}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool {\bf KURLBar::m\_\-is\-Immutable}\hspace{0.3cm}{\tt  [protected]}}\label{classKURLBar_p3}


Whether the urlbar may be modified by the user. 

If immutable is true, the urlbar can not be modified. 

Definition at line 442 of file kurlbar.h.

Referenced by KURLBar(), read\-Config(), and slot\-Context\-Menu\-Requested().

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