\section{KURLBar\-Item\-Dialog Class Reference}
\label{classKURLBarItemDialog}\index{KURLBarItemDialog@{KURLBarItemDialog}}
A dialog that allows editing entries of a {\bf KURLBar}{\rm (p.\,\pageref{classKURLBar})} ({\bf KURLBar\-Item}{\rm (p.\,\pageref{classKURLBarItem})}).  


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

Inheritance diagram for KURLBar\-Item\-Dialog:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=77pt]{classKURLBarItemDialog__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for KURLBar\-Item\-Dialog:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=272pt]{classKURLBarItemDialog__coll__graph}
\end{center}
\end{figure}
\subsection*{Public Slots}
\begin{CompactItemize}
\item 
void {\bf url\-Changed} (const  {\bf QString} \&)\label{classKURLBarItemDialog_i0}

\end{CompactItemize}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf KURLBar\-Item\-Dialog} (bool allow\-Global, const  {\bf KURL} \&url, const  {\bf QString} \&description, {\bf QString} icon, bool app\-Local=true, int icon\-Size={\bf KIcon::Size\-Medium}, {\bf QWidget} $\ast$parent=0, const  char $\ast$name=0)
\begin{CompactList}\small\item\em Constructs a KURLBar\-Item\-Dialog. \item\end{CompactList}\item 
{\bf $\sim$KURLBar\-Item\-Dialog} ()
\begin{CompactList}\small\item\em Destroys the dialog. \item\end{CompactList}\item 
{\bf KURL} {\bf url} () const 
\item 
{\bf QString} {\bf description} () const 
\item 
{\bf QString} {\bf icon} () const 
\item 
bool {\bf application\-Local} () const 
\end{CompactItemize}
\subsection*{Static Public Member Functions}
\begin{CompactItemize}
\item 
bool {\bf get\-Information} (bool allow\-Global, {\bf KURL} \&url, {\bf QString} \&description, {\bf QString} \&icon, bool \&app\-Local, int icon\-Size, {\bf QWidget} $\ast$parent=0)
\begin{CompactList}\small\item\em A convenience method to show up the dialog and retrieve all the properties via the given parameters. \item\end{CompactList}\end{CompactItemize}
\subsection*{Protected Attributes}
\begin{CompactItemize}
\item 
{\bf KURLRequester} $\ast$ {\bf m\_\-url\-Edit}
\begin{CompactList}\small\item\em The {\bf KURLRequester}{\rm (p.\,\pageref{classKURLRequester})} used for editing the url. \item\end{CompactList}\item 
{\bf KLine\-Edit} $\ast$ {\bf m\_\-edit}
\begin{CompactList}\small\item\em The {\bf KLine\-Edit} used for editing the description. \item\end{CompactList}\item 
{\bf KIcon\-Button} $\ast$ {\bf m\_\-icon\-Button}
\begin{CompactList}\small\item\em The {\bf KIcon\-Button}{\rm (p.\,\pageref{classKIconButton})} to configure the icon. \item\end{CompactList}\item 
{\bf QCheck\-Box} $\ast$ {\bf m\_\-app\-Local}
\begin{CompactList}\small\item\em The {\bf QCheck\-Box} to modify the local/global setting. \item\end{CompactList}\end{CompactItemize}


\subsection{Detailed Description}
A dialog that allows editing entries of a {\bf KURLBar}{\rm (p.\,\pageref{classKURLBar})} ({\bf KURLBar\-Item}{\rm (p.\,\pageref{classKURLBarItem})}). 

The dialog offers to configure a given url, description and icon. See the class-method {\bf get\-Information}{\rm (p.\,\pageref{classKURLBarItemDialog_e0})}() for easy usage.

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




Definition at line 523 of file kurlbar.h.

\subsection{Constructor \& Destructor Documentation}
\index{KURLBarItemDialog@{KURLBar\-Item\-Dialog}!KURLBarItemDialog@{KURLBarItemDialog}}
\index{KURLBarItemDialog@{KURLBarItemDialog}!KURLBarItemDialog@{KURLBar\-Item\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KURLBar\-Item\-Dialog::KURLBar\-Item\-Dialog (bool {\em allow\-Global}, const {\bf KURL} \& {\em url}, const {\bf QString} \& {\em description}, {\bf QString} {\em icon}, bool {\em app\-Local} = true, int {\em icon\-Size} = {\bf KIcon::Size\-Medium}, {\bf QWidget} $\ast$ {\em parent} = 0, const char $\ast$ {\em name} = 0)}\label{classKURLBarItemDialog_a0}


Constructs a KURLBar\-Item\-Dialog. 

{\tt allow\-Global} if you set this to true, the dialog will have a checkbox for the user to decide if he wants the entry to be available globally or just for the current application. {\tt url} the url of the item {\tt description} a short, translated description of the item {\tt icon} an icon for the item {\tt app\-Local} tells whether the item should be local for this application or available globalle {\tt icon\-Size} determines the size of the icon that is shown/selectable {\tt parent} the parent-widget for the dialog

If you leave the icon empty, the default icon for the given url will be used ({\bf KMime\-Type::pixmap\-For\-URL()}{\rm (p.\,\pageref{classKMimeType_e0})}). 

Definition at line 793 of file kurlbar.cpp.

References KInstance::about\-Data(), QWhats\-This::add(), QString::arg(), KStd\-Accel::description(), KURL::file\-Name(), QString::from\-Latin1(), QDir::home\-Dir\-Path(), KMime\-Type::icon\-For\-URL(), KGlobal::instance(), QString::is\-Empty(), KStd\-Accel::label(), KURLRequester::line\-Edit(), m\_\-app\-Local, m\_\-edit, m\_\-icon\-Button, m\_\-url\-Edit, KStd\-Accel::name(), KURL::pretty\-URL(), KAbout\-Data::program\-Name(), QCheck\-Box::set\-Checked(), KIcon\-Button::set\-Icon(), KIcon\-Button::set\-Icon\-Size(), KDialog\-Base::set\-Main\-Widget(), KURLRequester::set\-Mode(), QGrid::set\-Spacing(), KIcon\-Button::set\-Strict\-Icon\-Size(), QLine\-Edit::set\-Text(), and KDialog::spacing\-Hint().

Referenced by get\-Information().\index{KURLBarItemDialog@{KURLBar\-Item\-Dialog}!~KURLBarItemDialog@{$\sim$KURLBarItemDialog}}
\index{~KURLBarItemDialog@{$\sim$KURLBarItemDialog}!KURLBarItemDialog@{KURLBar\-Item\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KURLBar\-Item\-Dialog::$\sim${\bf KURLBar\-Item\-Dialog} ()}\label{classKURLBarItemDialog_a1}


Destroys the dialog. 



Definition at line 865 of file kurlbar.cpp.

\subsection{Member Function Documentation}
\index{KURLBarItemDialog@{KURLBar\-Item\-Dialog}!getInformation@{getInformation}}
\index{getInformation@{getInformation}!KURLBarItemDialog@{KURLBar\-Item\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KURLBar\-Item\-Dialog::get\-Information (bool {\em allow\-Global}, {\bf KURL} \& {\em url}, {\bf QString} \& {\em description}, {\bf QString} \& {\em icon}, bool \& {\em app\-Local}, int {\em icon\-Size}, {\bf QWidget} $\ast$ {\em parent} = 0)\hspace{0.3cm}{\tt  [static]}}\label{classKURLBarItemDialog_e0}


A convenience method to show up the dialog and retrieve all the properties via the given parameters. 

The parameters are used to initialize the dialog and then return the user-configured values.

See the {\bf KURLBar\-Item}{\rm (p.\,\pageref{classKURLBarItem})} constructor for the parameter description. 

Definition at line 769 of file kurlbar.cpp.

References application\-Local(), description(), KStd\-Accel::description(), QDialog::exec(), icon(), KURLBar\-Item\-Dialog(), and url().

Referenced by KURLBar::edit\-Item(), and KURLBar::slot\-Dropped().\index{KURLBarItemDialog@{KURLBar\-Item\-Dialog}!url@{url}}
\index{url@{url}!KURLBarItemDialog@{KURLBar\-Item\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KURL} KURLBar\-Item\-Dialog::url () const}\label{classKURLBarItemDialog_a2}


\begin{Desc}
\item[Returns:]the configured url \end{Desc}


Definition at line 874 of file kurlbar.cpp.

References QString::at(), m\_\-url\-Edit, KURL::set\-Path(), and KURLRequester::url().

Referenced by get\-Information().\index{KURLBarItemDialog@{KURLBar\-Item\-Dialog}!description@{description}}
\index{description@{description}!KURLBarItemDialog@{KURLBar\-Item\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KURLBar\-Item\-Dialog::description () const}\label{classKURLBarItemDialog_a3}


\begin{Desc}
\item[Returns:]the configured description \end{Desc}


Definition at line 886 of file kurlbar.cpp.

References m\_\-edit, and QLine\-Edit::text().

Referenced by get\-Information().\index{KURLBarItemDialog@{KURLBar\-Item\-Dialog}!icon@{icon}}
\index{icon@{icon}!KURLBarItemDialog@{KURLBar\-Item\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KURLBar\-Item\-Dialog::icon () const}\label{classKURLBarItemDialog_a4}


\begin{Desc}
\item[Returns:]the configured icon \end{Desc}


Definition at line 891 of file kurlbar.cpp.

References KIcon\-Button::icon(), and m\_\-icon\-Button.

Referenced by get\-Information().\index{KURLBarItemDialog@{KURLBar\-Item\-Dialog}!applicationLocal@{applicationLocal}}
\index{applicationLocal@{applicationLocal}!KURLBarItemDialog@{KURLBar\-Item\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KURLBar\-Item\-Dialog::application\-Local () const}\label{classKURLBarItemDialog_a5}


\begin{Desc}
\item[Returns:]whether the item should be local to the application or global. if allow\-Global was set to false in the constructor, this will always return true. \end{Desc}


Definition at line 896 of file kurlbar.cpp.

References QCheck\-Box::is\-Checked(), and m\_\-app\-Local.

Referenced by get\-Information().

\subsection{Member Data Documentation}
\index{KURLBarItemDialog@{KURLBar\-Item\-Dialog}!m_urlEdit@{m\_\-urlEdit}}
\index{m_urlEdit@{m\_\-urlEdit}!KURLBarItemDialog@{KURLBar\-Item\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KURLRequester}$\ast$ {\bf KURLBar\-Item\-Dialog::m\_\-url\-Edit}\hspace{0.3cm}{\tt  [protected]}}\label{classKURLBarItemDialog_p0}


The {\bf KURLRequester}{\rm (p.\,\pageref{classKURLRequester})} used for editing the url. 



Definition at line 593 of file kurlbar.h.

Referenced by KURLBar\-Item\-Dialog(), and url().\index{KURLBarItemDialog@{KURLBar\-Item\-Dialog}!m_edit@{m\_\-edit}}
\index{m_edit@{m\_\-edit}!KURLBarItemDialog@{KURLBar\-Item\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KLine\-Edit}$\ast$ {\bf KURLBar\-Item\-Dialog::m\_\-edit}\hspace{0.3cm}{\tt  [protected]}}\label{classKURLBarItemDialog_p1}


The {\bf KLine\-Edit} used for editing the description. 



Definition at line 597 of file kurlbar.h.

Referenced by description(), and KURLBar\-Item\-Dialog().\index{KURLBarItemDialog@{KURLBar\-Item\-Dialog}!m_iconButton@{m\_\-iconButton}}
\index{m_iconButton@{m\_\-iconButton}!KURLBarItemDialog@{KURLBar\-Item\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KIcon\-Button}$\ast$ {\bf KURLBar\-Item\-Dialog::m\_\-icon\-Button}\hspace{0.3cm}{\tt  [protected]}}\label{classKURLBarItemDialog_p2}


The {\bf KIcon\-Button}{\rm (p.\,\pageref{classKIconButton})} to configure the icon. 



Definition at line 601 of file kurlbar.h.

Referenced by icon(), and KURLBar\-Item\-Dialog().\index{KURLBarItemDialog@{KURLBar\-Item\-Dialog}!m_appLocal@{m\_\-appLocal}}
\index{m_appLocal@{m\_\-appLocal}!KURLBarItemDialog@{KURLBar\-Item\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QCheck\-Box}$\ast$ {\bf KURLBar\-Item\-Dialog::m\_\-app\-Local}\hspace{0.3cm}{\tt  [protected]}}\label{classKURLBarItemDialog_p3}


The {\bf QCheck\-Box} to modify the local/global setting. 



Definition at line 605 of file kurlbar.h.

Referenced by application\-Local(), and KURLBar\-Item\-Dialog().

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