\section{KNS::Entry Class Reference}
\label{classKNS_1_1Entry}\index{KNS::Entry@{KNS::Entry}}
{\bf KNew\-Stuff}{\rm (p.\,\pageref{classKNewStuff})} data entry container.  


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

Collaboration diagram for KNS::Entry:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=286pt]{classKNS_1_1Entry__coll__graph}
\end{center}
\end{figure}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf Entry} (const {\bf QDom\-Element} \&)
\item 
{\bf $\sim$Entry} ()
\item 
void {\bf set\-Name} (const {\bf QString} \&)
\item 
{\bf QString} {\bf name} () const 
\item 
void {\bf set\-Type} (const {\bf QString} \&)
\item 
{\bf QString} {\bf type} () const 
\item 
void {\bf set\-Author} (const {\bf QString} \&)
\item 
{\bf QString} {\bf author} () const 
\item 
void {\bf set\-Licence} (const {\bf QString} \&)
\item 
{\bf QString} {\bf license} () const 
\item 
void {\bf set\-Summary} (const {\bf QString} \&, const {\bf QString} \&lang=QString::null)
\item 
{\bf QString} {\bf summary} (const {\bf QString} \&lang=QString::null) const 
\item 
void {\bf set\-Version} (const {\bf QString} \&)
\item 
{\bf QString} {\bf version} () const 
\item 
void {\bf set\-Release} (int)
\item 
int {\bf release} () const 
\item 
void {\bf set\-Release\-Date} (const {\bf QDate} \&)
\item 
{\bf QDate} {\bf release\-Date} () const 
\item 
void {\bf set\-Payload} (const KURL \&, const {\bf QString} \&lang=QString::null)
\item 
KURL {\bf payload} (const {\bf QString} \&lang=QString::null) const 
\item 
void {\bf set\-Preview} (const KURL \&, const {\bf QString} \&lang=QString::null)
\item 
KURL {\bf preview} (const {\bf QString} \&lang=QString::null) const 
\item 
void {\bf set\-Rating} (int)
\item 
int {\bf rating} ()
\item 
void {\bf set\-Downloads} (int)
\item 
int {\bf downloads} ()
\item 
{\bf QString} {\bf full\-Name} ()
\item 
{\bf QString\-List} {\bf langs} ()
\item 
void {\bf parse\-Dom\-Element} (const {\bf QDom\-Element} \&)\label{classKNS_1_1Entry_a29}

\item 
{\bf QDom\-Element} {\bf create\-Dom\-Element} ({\bf QDom\-Document} \&, {\bf QDom\-Element} \&parent)\label{classKNS_1_1Entry_a30}

\end{CompactItemize}
\subsection*{Protected Member Functions}
\begin{CompactItemize}
\item 
{\bf QDom\-Element} {\bf add\-Element} ({\bf QDom\-Document} \&doc, {\bf QDom\-Element} \&parent, const {\bf QString} \&tag, const {\bf QString} \&value)\label{classKNS_1_1Entry_b0}

\end{CompactItemize}


\subsection{Detailed Description}
{\bf KNew\-Stuff}{\rm (p.\,\pageref{classKNewStuff})} data entry container. 

This class provides accessor methods to the data objects as used by {\bf KNew\-Stuff}{\rm (p.\,\pageref{classKNewStuff})}. It should probably not be used directly by the application.

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




Definition at line 44 of file entry.h.

\subsection{Constructor \& Destructor Documentation}
\index{KNS::Entry@{KNS::Entry}!Entry@{Entry}}
\index{Entry@{Entry}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Entry::Entry (const {\bf QDom\-Element} \&)}\label{classKNS_1_1Entry_a1}


Constructor. 



Definition at line 34 of file entry.cpp.\index{KNS::Entry@{KNS::Entry}!~Entry@{$\sim$Entry}}
\index{~Entry@{$\sim$Entry}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Entry::$\sim${\bf Entry} ()}\label{classKNS_1_1Entry_a2}


Destructor. 



Definition at line 40 of file entry.cpp.

\subsection{Member Function Documentation}
\index{KNS::Entry@{KNS::Entry}!setName@{setName}}
\index{setName@{setName}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void Entry::set\-Name (const {\bf QString} \&)}\label{classKNS_1_1Entry_a3}


Sets the (unique) name for this data object. 



Definition at line 45 of file entry.cpp.

References name().\index{KNS::Entry@{KNS::Entry}!name@{name}}
\index{name@{name}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} Entry::name () const}\label{classKNS_1_1Entry_a4}


Retrieve the name of the data object. 

\begin{Desc}
\item[Returns:]object name \end{Desc}


Definition at line 50 of file entry.cpp.

Referenced by full\-Name(), and set\-Name().\index{KNS::Entry@{KNS::Entry}!setType@{setType}}
\index{setType@{setType}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void Entry::set\-Type (const {\bf QString} \&)}\label{classKNS_1_1Entry_a5}


Sets the application type, e.g. 

'kdesktop/wallpaper'. 

Definition at line 56 of file entry.cpp.

References type().\index{KNS::Entry@{KNS::Entry}!type@{type}}
\index{type@{type}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} Entry::type () const}\label{classKNS_1_1Entry_a6}


Retrieve the type of the data object. 

\begin{Desc}
\item[Returns:]object type \end{Desc}


Definition at line 61 of file entry.cpp.

Referenced by set\-Type().\index{KNS::Entry@{KNS::Entry}!setAuthor@{setAuthor}}
\index{setAuthor@{setAuthor}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void Entry::set\-Author (const {\bf QString} \&)}\label{classKNS_1_1Entry_a7}


Sets the full name of the object's author. 



Definition at line 67 of file entry.cpp.

References author().\index{KNS::Entry@{KNS::Entry}!author@{author}}
\index{author@{author}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} Entry::author () const}\label{classKNS_1_1Entry_a8}


Retrieve the author's name of the object. 

\begin{Desc}
\item[Returns:]object author \end{Desc}


Definition at line 72 of file entry.cpp.

Referenced by set\-Author().\index{KNS::Entry@{KNS::Entry}!setLicence@{setLicence}}
\index{setLicence@{setLicence}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void Entry::set\-Licence (const {\bf QString} \&)}\label{classKNS_1_1Entry_a9}


Sets the license (abbreviation) applicable to the object. 



Definition at line 78 of file entry.cpp.

References license().\index{KNS::Entry@{KNS::Entry}!license@{license}}
\index{license@{license}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} Entry::license () const}\label{classKNS_1_1Entry_a10}


Retrieve the license name of the object. 

\begin{Desc}
\item[Returns:]object license \end{Desc}


Definition at line 83 of file entry.cpp.

Referenced by set\-Licence().\index{KNS::Entry@{KNS::Entry}!setSummary@{setSummary}}
\index{setSummary@{setSummary}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void Entry::set\-Summary (const {\bf QString} \&, const {\bf QString} \& {\em lang} = {\tt QString::null})}\label{classKNS_1_1Entry_a11}


Sets a short description on what the object is all about. 



Definition at line 89 of file entry.cpp.

References QMap::insert().\index{KNS::Entry@{KNS::Entry}!summary@{summary}}
\index{summary@{summary}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} Entry::summary (const {\bf QString} \& {\em lang} = {\tt QString::null}) const}\label{classKNS_1_1Entry_a12}


Retrieve a short description about the object. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em lang}]preferred language, or QString::null for KDE default \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]object description \end{Desc}


Definition at line 96 of file entry.cpp.

References QMap::begin(), QMap::is\-Empty(), and langs().\index{KNS::Entry@{KNS::Entry}!setVersion@{setVersion}}
\index{setVersion@{setVersion}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void Entry::set\-Version (const {\bf QString} \&)}\label{classKNS_1_1Entry_a13}


Sets the version number. 



Definition at line 111 of file entry.cpp.

References version().\index{KNS::Entry@{KNS::Entry}!version@{version}}
\index{version@{version}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} Entry::version () const}\label{classKNS_1_1Entry_a14}


Retrieve the version string of the object. 

\begin{Desc}
\item[Returns:]object version \end{Desc}


Definition at line 116 of file entry.cpp.

Referenced by full\-Name(), and set\-Version().\index{KNS::Entry@{KNS::Entry}!setRelease@{setRelease}}
\index{setRelease@{setRelease}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void Entry::set\-Release (int)}\label{classKNS_1_1Entry_a15}


Sets the release number, which is increased for feature-equal objects with the same version number, but slightly updated contents. 



Definition at line 122 of file entry.cpp.\index{KNS::Entry@{KNS::Entry}!release@{release}}
\index{release@{release}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int Entry::release () const}\label{classKNS_1_1Entry_a16}


Retrieve the release number of the object. 

\begin{Desc}
\item[Returns:]object release \end{Desc}


Definition at line 127 of file entry.cpp.

Referenced by full\-Name().\index{KNS::Entry@{KNS::Entry}!setReleaseDate@{setReleaseDate}}
\index{setReleaseDate@{setReleaseDate}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void Entry::set\-Release\-Date (const {\bf QDate} \&)}\label{classKNS_1_1Entry_a17}


Sets the release date. 



Definition at line 133 of file entry.cpp.\index{KNS::Entry@{KNS::Entry}!releaseDate@{releaseDate}}
\index{releaseDate@{releaseDate}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QDate} Entry::release\-Date () const}\label{classKNS_1_1Entry_a18}


Retrieve the date of the object's publication. 

\begin{Desc}
\item[Returns:]object release date \end{Desc}


Definition at line 138 of file entry.cpp.\index{KNS::Entry@{KNS::Entry}!setPayload@{setPayload}}
\index{setPayload@{setPayload}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void Entry::set\-Payload (const KURL \&, const {\bf QString} \& {\em lang} = {\tt QString::null})}\label{classKNS_1_1Entry_a19}


Sets the object's file. 



Definition at line 144 of file entry.cpp.

References QMap::insert().\index{KNS::Entry@{KNS::Entry}!payload@{payload}}
\index{payload@{payload}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KURL Entry::payload (const {\bf QString} \& {\em lang} = {\tt QString::null}) const}\label{classKNS_1_1Entry_a20}


Retrieve the file name of the object. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em lang}]preferred language, or QString::null for KDE default \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]object filename \end{Desc}


Definition at line 151 of file entry.cpp.

References QMap::begin(), QMap::is\-Empty(), langs(), and payload().

Referenced by payload().\index{KNS::Entry@{KNS::Entry}!setPreview@{setPreview}}
\index{setPreview@{setPreview}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void Entry::set\-Preview (const KURL \&, const {\bf QString} \& {\em lang} = {\tt QString::null})}\label{classKNS_1_1Entry_a21}


Sets the object's preview file, if available. 

This should be a picture file. 

Definition at line 167 of file entry.cpp.

References QMap::insert().\index{KNS::Entry@{KNS::Entry}!preview@{preview}}
\index{preview@{preview}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KURL Entry::preview (const {\bf QString} \& {\em lang} = {\tt QString::null}) const}\label{classKNS_1_1Entry_a22}


Retrieve the file name of an image containing a preview of the object. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em lang}]preferred language, or QString::null for KDE default \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]object preview filename \end{Desc}


Definition at line 174 of file entry.cpp.

References QMap::begin(), QMap::is\-Empty(), langs(), and preview().

Referenced by preview().\index{KNS::Entry@{KNS::Entry}!setRating@{setRating}}
\index{setRating@{setRating}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void Entry::set\-Rating (int)}\label{classKNS_1_1Entry_a23}


Sets the rating between 0 (worst) and 10 (best). 



Definition at line 190 of file entry.cpp.\index{KNS::Entry@{KNS::Entry}!rating@{rating}}
\index{rating@{rating}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int Entry::rating ()}\label{classKNS_1_1Entry_a24}


Retrieve the rating for the object, which has been determined by its users and thus might change over time. 

\begin{Desc}
\item[Returns:]object rating \end{Desc}


Definition at line 195 of file entry.cpp.\index{KNS::Entry@{KNS::Entry}!setDownloads@{setDownloads}}
\index{setDownloads@{setDownloads}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void Entry::set\-Downloads (int)}\label{classKNS_1_1Entry_a25}


Sets the number of downloads. 



Definition at line 201 of file entry.cpp.\index{KNS::Entry@{KNS::Entry}!downloads@{downloads}}
\index{downloads@{downloads}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int Entry::downloads ()}\label{classKNS_1_1Entry_a26}


Retrieve the download count for the object, which has been determined by its hosting sites and thus might change over time. 

\begin{Desc}
\item[Returns:]object download count \end{Desc}


Definition at line 206 of file entry.cpp.\index{KNS::Entry@{KNS::Entry}!fullName@{fullName}}
\index{fullName@{fullName}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} Entry::full\-Name ()}\label{classKNS_1_1Entry_a27}


Return the full name for the meta information. 

It is constructed as name-version-release. 

Definition at line 211 of file entry.cpp.

References name(), QString::number(), release(), and version().\index{KNS::Entry@{KNS::Entry}!langs@{langs}}
\index{langs@{langs}!KNS::Entry@{KNS::Entry}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString\-List} Entry::langs ()}\label{classKNS_1_1Entry_a28}


Return the list of languages this object supports. 



Definition at line 216 of file entry.cpp.

Referenced by payload(), preview(), and summary().

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