\section{KNS::Download\-Dialog Class Reference}
\label{classKNS_1_1DownloadDialog}\index{KNS::DownloadDialog@{KNS::DownloadDialog}}
Common download dialog for data browsing and installation.  


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

Collaboration diagram for KNS::Download\-Dialog:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=420pt]{classKNS_1_1DownloadDialog__coll__graph}
\end{center}
\end{figure}
\subsection*{Public Slots}
\begin{CompactItemize}
\item 
void {\bf slot\-Providers} ({\bf Provider::List} $\ast$list)
\end{CompactItemize}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf Download\-Dialog} ({\bf Engine} $\ast$engine, {\bf QWidget} $\ast$parent, const {\bf QString} \&caption)
\item 
{\bf Download\-Dialog} ({\bf QWidget} $\ast$parent, const {\bf QString} \&caption)
\item 
{\bf $\sim$Download\-Dialog} ()
\item 
void {\bf set\-Type} ({\bf QString} type)
\item 
void {\bf load} ()
\item 
void {\bf set\-Provider\-List} (const {\bf QString} \&provider\-List)
\item 
void {\bf load} ({\bf QString} provider\-List)
\item 
void {\bf add\-Provider} ({\bf Provider} $\ast$p)
\item 
void {\bf add\-Entry} ({\bf Entry} $\ast$entry)
\item 
void {\bf clear} ()
\item 
{\bf Download\-Dialog} ({\bf Engine} $\ast$engine, {\bf QWidget} $\ast$parent=0)
\item 
{\bf Download\-Dialog} ({\bf QWidget} $\ast$parent=0)
\end{CompactItemize}
\subsection*{Static Public Member Functions}
\begin{CompactItemize}
\item 
static void {\bf open} (const {\bf QString} \&type, const {\bf QString} \&caption)
\item 
static void {\bf open} ({\bf QString} type)
\end{CompactItemize}
\subsection*{Protected Slots}
\begin{CompactItemize}
\item 
void {\bf slot\-Apply} ()\label{classKNS_1_1DownloadDialog_j0}

\item 
void {\bf slot\-Ok} ()\label{classKNS_1_1DownloadDialog_j1}

\end{CompactItemize}


\subsection{Detailed Description}
Common download dialog for data browsing and installation. 

It provides an easy-to-use convenience method named {\bf open()}{\rm (p.\,\pageref{classKNS_1_1DownloadDialog_e0})} which does all the work, unless a more complex operation is needed. 

\footnotesize\begin{verbatim} KNewStuff::DownloadDialog::open("kdesktop/wallpapers");
\end{verbatim}
\normalsize


\begin{Desc}
\item[Author:]Josef Spillner ({\tt spillner@kde.org}) \end{Desc}
\begin{Desc}
\item[Maintainer:]Josef Spillner ({\tt spillner@kde.org}) \end{Desc}




Definition at line 57 of file downloaddialog.h.

\subsection{Constructor \& Destructor Documentation}
\index{KNS::DownloadDialog@{KNS::Download\-Dialog}!DownloadDialog@{DownloadDialog}}
\index{DownloadDialog@{DownloadDialog}!KNS::DownloadDialog@{KNS::Download\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KNS::Download\-Dialog::Download\-Dialog ({\bf Engine} $\ast$ {\em engine}, {\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em caption})}\label{classKNS_1_1DownloadDialog_a0}


Constructor. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em engine}]a pre-built engine object, or NULL if the download dialog should create an engine on its own \item[{\em parent}]the parent window \item[{\em caption}]the dialog caption \end{description}
\end{Desc}
\index{KNS::DownloadDialog@{KNS::Download\-Dialog}!DownloadDialog@{DownloadDialog}}
\index{DownloadDialog@{DownloadDialog}!KNS::DownloadDialog@{KNS::Download\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KNS::Download\-Dialog::Download\-Dialog ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em caption})}\label{classKNS_1_1DownloadDialog_a1}


Alternative constructor. 

Always uses an internal engine.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]the parent window \item[{\em caption}]the dialog caption \end{description}
\end{Desc}
\index{KNS::DownloadDialog@{KNS::Download\-Dialog}!~DownloadDialog@{$\sim$DownloadDialog}}
\index{~DownloadDialog@{$\sim$DownloadDialog}!KNS::DownloadDialog@{KNS::Download\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KNS::Download\-Dialog::$\sim${\bf Download\-Dialog} ()}\label{classKNS_1_1DownloadDialog_a2}


Destructor. 

\index{KNS::DownloadDialog@{KNS::Download\-Dialog}!DownloadDialog@{DownloadDialog}}
\index{DownloadDialog@{DownloadDialog}!KNS::DownloadDialog@{KNS::Download\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KNS::Download\-Dialog::Download\-Dialog ({\bf Engine} $\ast$ {\em engine}, {\bf QWidget} $\ast$ {\em parent} = {\tt 0})}\label{classKNS_1_1DownloadDialog_a10}


Constructor. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em engine}]a pre-built engine object, or NULL if the download dialog should create an engine on its own \item[{\em parent}]the parent window \end{description}
\end{Desc}
\index{KNS::DownloadDialog@{KNS::Download\-Dialog}!DownloadDialog@{DownloadDialog}}
\index{DownloadDialog@{DownloadDialog}!KNS::DownloadDialog@{KNS::Download\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KNS::Download\-Dialog::Download\-Dialog ({\bf QWidget} $\ast$ {\em parent} = {\tt 0})}\label{classKNS_1_1DownloadDialog_a11}


Alternative constructor. 

Always uses an internal engine.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]the parent window \end{description}
\end{Desc}


\subsection{Member Function Documentation}
\index{KNS::DownloadDialog@{KNS::Download\-Dialog}!setType@{setType}}
\index{setType@{setType}!KNS::DownloadDialog@{KNS::Download\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KNS::Download\-Dialog::set\-Type ({\bf QString} {\em type})}\label{classKNS_1_1DownloadDialog_a3}


Restricts the display of available data to a certain data type. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em type}]a Hotstuff data type such as \char`\"{}korganizer/calendar\char`\"{} \end{description}
\end{Desc}
\index{KNS::DownloadDialog@{KNS::Download\-Dialog}!load@{load}}
\index{load@{load}!KNS::DownloadDialog@{KNS::Download\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KNS::Download\-Dialog::load ()}\label{classKNS_1_1DownloadDialog_a4}


Fetches descriptions of all available data, optionally considering a previously set type. 

\index{KNS::DownloadDialog@{KNS::Download\-Dialog}!setProviderList@{setProviderList}}
\index{setProviderList@{setProviderList}!KNS::DownloadDialog@{KNS::Download\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KNS::Download\-Dialog::set\-Provider\-List (const {\bf QString} \& {\em provider\-List})}\label{classKNS_1_1DownloadDialog_a5}


Explicitly uses this provider list instead of the one read from the application configuration. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em provider\-List}]the URL of the provider list\end{description}
\end{Desc}
\begin{Desc}
\item[Since:]3.4 \end{Desc}
\index{KNS::DownloadDialog@{KNS::Download\-Dialog}!load@{load}}
\index{load@{load}!KNS::DownloadDialog@{KNS::Download\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KNS::Download\-Dialog::load ({\bf QString} {\em provider\-List})}\label{classKNS_1_1DownloadDialog_a6}


Fetches descriptions of all available data, optionally considering a previously set type. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em provider\-List}]the URl to the list of providers; if empty we first try the Providers\-Url from KGlobal::config, then we fall back to a hardcoded value. \end{description}
\end{Desc}
\index{KNS::DownloadDialog@{KNS::Download\-Dialog}!addProvider@{addProvider}}
\index{addProvider@{addProvider}!KNS::DownloadDialog@{KNS::Download\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KNS::Download\-Dialog::add\-Provider ({\bf Provider} $\ast$ {\em p})}\label{classKNS_1_1DownloadDialog_a7}


Adds another provider to the download dialog. 

This is normally done internally.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em p}]the Hotstuff provider to be added \end{description}
\end{Desc}
\index{KNS::DownloadDialog@{KNS::Download\-Dialog}!addEntry@{addEntry}}
\index{addEntry@{addEntry}!KNS::DownloadDialog@{KNS::Download\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KNS::Download\-Dialog::add\-Entry ({\bf Entry} $\ast$ {\em entry})}\label{classKNS_1_1DownloadDialog_a8}


Adds an additional entry to the current provider. 

This is normally done internally.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em entry}]a Hotstuff data entry to be added \end{description}
\end{Desc}
\index{KNS::DownloadDialog@{KNS::Download\-Dialog}!clear@{clear}}
\index{clear@{clear}!KNS::DownloadDialog@{KNS::Download\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KNS::Download\-Dialog::clear ()}\label{classKNS_1_1DownloadDialog_a9}


Clears the entry list of the current provider. 

This is normally done internally. \index{KNS::DownloadDialog@{KNS::Download\-Dialog}!open@{open}}
\index{open@{open}!KNS::DownloadDialog@{KNS::Download\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}static void KNS::Download\-Dialog::open (const {\bf QString} \& {\em type}, const {\bf QString} \& {\em caption})\hspace{0.3cm}{\tt  [static]}}\label{classKNS_1_1DownloadDialog_e0}


Opens the download dialog. 

This is a convenience method which automatically sets up the dialog. \begin{Desc}
\item[See also:]{\bf set\-Type()}{\rm (p.\,\pageref{classKNS_1_1DownloadDialog_a3})} 

{\bf load()}{\rm (p.\,\pageref{classKNS_1_1DownloadDialog_a4})}\end{Desc}
\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em type}]a data type such as \char`\"{}korganizer/calendar\char`\"{} \item[{\em caption}]the dialog caption \end{description}
\end{Desc}
\index{KNS::DownloadDialog@{KNS::Download\-Dialog}!open@{open}}
\index{open@{open}!KNS::DownloadDialog@{KNS::Download\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}static void KNS::Download\-Dialog::open ({\bf QString} {\em type})\hspace{0.3cm}{\tt  [static]}}\label{classKNS_1_1DownloadDialog_e1}


Opens the download dialog. 

This is a convenience method which automatically sets up the dialog. \begin{Desc}
\item[See also:]{\bf set\-Type()}{\rm (p.\,\pageref{classKNS_1_1DownloadDialog_a3})} 

{\bf load()}{\rm (p.\,\pageref{classKNS_1_1DownloadDialog_a4})}\end{Desc}
\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em type}]a data type such as \char`\"{}korganizer/calendar\char`\"{} \end{description}
\end{Desc}
\index{KNS::DownloadDialog@{KNS::Download\-Dialog}!slotProviders@{slotProviders}}
\index{slotProviders@{slotProviders}!KNS::DownloadDialog@{KNS::Download\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KNS::Download\-Dialog::slot\-Providers ({\bf Provider::List} $\ast$ {\em list})\hspace{0.3cm}{\tt  [slot]}}\label{classKNS_1_1DownloadDialog_i0}


Availability of the provider list. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em list}]list of Hotstuff providers \end{description}
\end{Desc}


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