\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=49pt]{classKURLBar__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for KURLBar:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=117pt]{classKURLBar__coll__graph}
\end{center}
\end{figure}
\subsection*{Public Slots}
\begin{CompactItemize}
\item 
virtual void {\bf set\-Current\-Item} (const  {\bf KURL} \&url)
\begin{CompactList}\small\item\em Makes the item with the url {\tt url} the current item. \item\end{CompactList}\end{CompactItemize}
\subsection*{Signals}
\begin{CompactItemize}
\item 
void {\bf activated} (const  {\bf KURL} \&url)
\begin{CompactList}\small\item\em This signal is emitted when the user activated an item, e.g by clicking on it. \item\end{CompactList}\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)
\begin{CompactList}\small\item\em Constructs a KURLBar. \item\end{CompactList}\item 
{\bf $\sim$KURLBar} ()
\begin{CompactList}\small\item\em Destroys the KURLBar. \item\end{CompactList}\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=KIcon::Panel)
\begin{CompactList}\small\item\em Inserts a new item into the KURLBar and returns the created {\bf KURLBar\-Item}{\rm (p.\,\pageref{classKURLBarItem})}. \item\end{CompactList}\item 
virtual void {\bf set\-Orientation} (Qt::Orientation orient)
\begin{CompactList}\small\item\em The items can be arranged either vertically in one column or horizontally in one row. \item\end{CompactList}\item 
Orientation {\bf orientation} () const 
\item 
virtual void {\bf set\-List\-Box} ({\bf KURLBar\-List\-Box} $\ast$)
\begin{CompactList}\small\item\em Allows to set a custom {\bf KURLBar\-List\-Box}{\rm (p.\,\pageref{classKURLBarListBox})}. \item\end{CompactList}\item 
{\bf KURLBar\-List\-Box} $\ast$ {\bf list\-Box} () const 
\item 
virtual void {\bf set\-Icon\-Size} (int size)
\begin{CompactList}\small\item\em Sets the default iconsize to be used for items inserted with {\bf insert\-Item}{\rm (p.\,\pageref{classKURLBar_a2})}. \item\end{CompactList}\item 
int {\bf icon\-Size} () const 
\item 
virtual void {\bf clear} ()
\begin{CompactList}\small\item\em Clears the view, removes all items. \item\end{CompactList}\item 
virtual {\bf QSize} {\bf size\-Hint} () const 
\item 
virtual {\bf QSize} {\bf minimum\-Size\-Hint} () const 
\begin{CompactList}\small\item\em \item\end{CompactList}\item 
virtual void {\bf read\-Config} ({\bf KConfig} $\ast$config, const  {\bf QString} \&item\-Group)
\begin{CompactList}\small\item\em Call this method to read a saved configuration from {\tt config}, inside the group {\tt item\-Group}. \item\end{CompactList}\item 
virtual void {\bf write\-Config} ({\bf KConfig} $\ast$config, const  {\bf QString} \&item\-Group)
\begin{CompactList}\small\item\em Call this method to save the current configuration into {\tt config}, inside the group {\tt icon\-Group}. \item\end{CompactList}\item 
virtual void {\bf read\-Item} (int i, {\bf KConfig} $\ast$config, bool application\-Local)
\begin{CompactList}\small\item\em Called from {\bf read\-Config}{\rm (p.\,\pageref{classKURLBar_a12})}() to read the i'th from {\tt config}. \item\end{CompactList}\item 
virtual void {\bf write\-Item} ({\bf KURLBar\-Item} $\ast$item, int i, {\bf KConfig} $\ast$, bool global)
\begin{CompactList}\small\item\em Called from {\bf write\-Config}{\rm (p.\,\pageref{classKURLBar_a13})}() to save the {\bf KURLBar\-Item}{\rm (p.\,\pageref{classKURLBarItem})} {\tt item} as the i'th entry in the config-object. \item\end{CompactList}\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)
\begin{CompactList}\small\item\em Reimplemented to show a contextmenu, allowing the user to add, edit or remove items, or change the iconsize. \item\end{CompactList}\item 
virtual void {\bf slot\-Selected} ({\bf QList\-Box\-Item} $\ast$)
\begin{CompactList}\small\item\em Called when an item has been selected. \item\end{CompactList}\item 
virtual void {\bf slot\-Dropped} ({\bf QDrop\-Event} $\ast$)
\begin{CompactList}\small\item\em Called when a url was dropped onto the bar to show a {\bf KURLBar\-Item\-Dialog}{\rm (p.\,\pageref{classKURLBarItemDialog})}. \item\end{CompactList}\end{CompactItemize}
\subsection*{Protected Member Functions}
\begin{CompactItemize}
\item 
virtual bool {\bf add\-New\-Item} ()
\begin{CompactList}\small\item\em Pops up a {\bf KURLBar\-Item\-Dialog}{\rm (p.\,\pageref{classKURLBarItemDialog})} to let the user add a new item. \item\end{CompactList}\item 
virtual bool {\bf edit\-Item} ({\bf KURLBar\-Item} $\ast$item)
\begin{CompactList}\small\item\em Pops up a {\bf KURLBar\-Item\-Dialog}{\rm (p.\,\pageref{classKURLBarItemDialog})} to let the user edit the properties of {\tt item}. \item\end{CompactList}\item 
virtual void {\bf resize\-Event} ({\bf QResize\-Event} $\ast$)
\begin{CompactList}\small\item\em \item\end{CompactList}\item 
virtual void {\bf virtual\_\-hook} (int id, void $\ast$data)\label{classKURLBar_b3}

\end{CompactItemize}
\subsection*{Protected Attributes}
\begin{CompactItemize}
\item 
{\bf KURLBar\-Item} $\ast$ {\bf m\_\-active\-Item}
\begin{CompactList}\small\item\em The currently active item. \item\end{CompactList}\item 
bool {\bf m\_\-use\-Global}:1
\begin{CompactList}\small\item\em Whether we support global entries or just local ones. \item\end{CompactList}\item 
bool {\bf m\_\-is\-Modified}:1
\begin{CompactList}\small\item\em Whether the urlbar was modified by the user (e.g. \item\end{CompactList}\item 
bool {\bf m\_\-is\-Immutable}:1
\begin{CompactList}\small\item\em Whether the urlbar may be modified by the user. \item\end{CompactList}\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 make the {\bf activated}{\rm (p.\,\pageref{classKURLBar_l0})}() signal being 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_a12})}() and {\bf write\-Config}{\rm (p.\,\pageref{classKURLBar_a13})}() 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 198 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} = 0, const char $\ast$ {\em name} = 0, WFlags {\em f} = 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 239 of file kurlbar.cpp.

References QWhats\-This::add(), is\-Vertical(), m\_\-active\-Item, m\_\-is\-Immutable, m\_\-is\-Modified, m\_\-use\-Global, KStd\-Accel::name(), 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 262 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} = true, const {\bf QString} \& {\em icon} = QString::null, {\bf KIcon::Group} {\em group} = 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 267 of file kurlbar.cpp.

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

Referenced by read\-Item(), and slot\-Dropped().\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_a3}


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_a4})} \end{Desc}


Definition at line 277 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_a4}


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


Definition at line 288 of file kurlbar.cpp.

References KURLBar\-List\-Box::orientation().

Referenced by is\-Vertical().\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_a5}


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_a6})} \end{Desc}


Definition at line 293 of file kurlbar.cpp.

References QPalette::color(), QPalette::set\-Color(), 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_a6}


\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_a5})} \end{Desc}


Definition at line 252 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_a7}


Sets the default iconsize to be used for items inserted with {\bf insert\-Item}{\rm (p.\,\pageref{classKURLBar_a2})}. 

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


Definition at line 330 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_a8}


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


Definition at line 265 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_a9}


Clears the view, removes all items. 



Definition at line 348 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_a10}


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


Definition at line 359 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_a11}






Definition at line 401 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_a12}


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_a14})}() method. 

Definition at line 470 of file kurlbar.cpp.

References KGlobal::config(), KConfig\-Base::group\-Is\-Immutable(), 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_a13}


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_a15})}() method is used to save each item. 

Definition at line 528 of file kurlbar.cpp.

References KURLBar\-Item::application\-Local(), QList\-Box::first\-Item(), m\_\-is\-Modified, m\_\-use\-Global, KConfig\-Base::set\-Group(), KConfig\-Base::write\-Entry(), 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_a14}


Called from {\bf read\-Config}{\rm (p.\,\pageref{classKURLBar_a12})}() 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 513 of file kurlbar.cpp.

References insert\-Item(), KProtocol\-Info::is\-Known\-Protocol(), KURL::is\-Malformed(), QString::number(), KIO::number(), KConfig\-Base::read\-Entry(), and KConfig\-Base::read\-Num\-Entry().

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_a15}


Called from {\bf write\-Config}{\rm (p.\,\pageref{classKURLBar_a13})}() 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 574 of file kurlbar.cpp.

References KURLBar\-Item::description(), KURLBar\-Item::icon(), KURLBar\-Item::icon\-Group(), KURL::is\-Local\-File(), QString::number(), KIO::number(), KURL::path(), KURL::pretty\-URL(), KURLBar\-Item::url(), KConfig\-Base::write\-Entry(), and KConfig\-Base::write\-Path\-Entry().

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_a16}


\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_a17})} \end{Desc}


Definition at line 456 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_a17}


\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_a16})} 

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


Definition at line 464 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_a18}


\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_a13})}(). \end{Desc}


Definition at line 328 of file kurlbar.h.

References m\_\-is\-Modified.\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_a19}


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


Definition at line 333 of file kurlbar.h.

References m\_\-is\-Immutable.\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_a20}


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


Definition at line 338 of file kurlbar.h.

References orientation().

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_a16})} 

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


Definition at line 428 of file kurlbar.cpp.

References QList\-Box::clear\-Selection(), QList\-Box::first\-Item(), m\_\-active\-Item, QList\-Box\-Item::next(), QList\-Box::set\-Current\-Item(), QList\-Box::set\-Selected(), KURLBar\-Item::url(), and KURL::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 669 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 682 of file kurlbar.cpp.

References KURLBar\-Item::application\-Local(), KURLBar\-Item::description(), KStd\-Accel::description(), KURLBar\-Item\-Dialog::get\-Information(), KURLBar\-Item::icon(), m\_\-is\-Modified, m\_\-use\-Global, KURLBar\-Item::set\-Application\-Local(), KURLBar\-Item::set\-Description(), KURLBar\-Item::set\-Icon(), KURLBar\-Item::set\-URL(), QList\-Box::trigger\-Update(), and KURLBar\-Item::url().

Referenced by add\-New\-Item(), and slot\-Context\-Menu\-Requested().\index{KURLBar@{KURLBar}!resizeEvent@{resizeEvent}}
\index{resizeEvent@{resizeEvent}!KURLBar@{KURLBar}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KURLBar::resize\-Event ({\bf QResize\-Event} $\ast$)\hspace{0.3cm}{\tt  [protected, virtual]}}\label{classKURLBar_b2}






Reimplemented from {\bf QFrame}.

Definition at line 353 of file kurlbar.cpp.

References QFrame::resize\-Event().\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 618 of file kurlbar.cpp.

References add\-New\-Item(), edit\-Item(), QPopup\-Menu::exec(), QPopup\-Menu::insert\-Item(), QPopup\-Menu::insert\-Separator(), m\_\-active\-Item, m\_\-is\-Immutable, m\_\-is\-Modified, set\-Current\-Item(), set\-Icon\-Size(), QPopup\-Menu::set\-Item\-Enabled(), KIcon::Size\-Medium, KIcon::Size\-Small, 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 417 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 594 of file kurlbar.cpp.

References QValue\-List$<$ KURL $>$::begin(), KURLDrag::decode(), KStd\-Accel::description(), QValue\-List$<$ KURL $>$::end(), KURLBar\-Item\-Dialog::get\-Information(), insert\-Item(), QValue\-List$<$ KURL $>$::Iterator(), m\_\-is\-Modified, and m\_\-use\-Global.

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 379 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 383 of file kurlbar.h.

Referenced by edit\-Item(), KURLBar(), read\-Config(), slot\-Dropped(), 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 389 of file kurlbar.h.

Referenced by edit\-Item(), is\-Modified(), 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 395 of file kurlbar.h.

Referenced by is\-Immutable(), 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}
