\section{KABC::Address\-Book Class Reference}
\label{classKABC_1_1AddressBook}\index{KABC::AddressBook@{KABC::AddressBook}}
{\bf Address}{\rm (p.\,\pageref{classKABC_1_1Address})} Book.  


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

Inheritance diagram for KABC::Address\-Book:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=79pt]{classKABC_1_1AddressBook__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for KABC::Address\-Book:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=111pt]{classKABC_1_1AddressBook__coll__graph}
\end{center}
\end{figure}
\subsection*{Signals}
\begin{CompactItemize}
\item 
void {\bf address\-Book\-Changed} ({\bf Address\-Book} $\ast$address\-Book)
\item 
void {\bf address\-Book\-Locked} ({\bf Address\-Book} $\ast$address\-Book)
\item 
void {\bf address\-Book\-Unlocked} ({\bf Address\-Book} $\ast$address\-Book)
\item 
void {\bf loading\-Finished} (Resource $\ast$resource)
\item 
void {\bf saving\-Finished} (Resource $\ast$resource)
\end{CompactItemize}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf Address\-Book} ()
\item 
{\bf Address\-Book} (const {\bf QString} \&config)
\item 
virtual {\bf $\sim$Address\-Book} ()
\item 
{\bf Ticket} $\ast$ {\bf request\-Save\-Ticket} (Resource $\ast$resource=0)
\item 
void {\bf release\-Save\-Ticket} ({\bf Ticket} $\ast$ticket)
\item 
bool {\bf load} ()
\item 
bool {\bf async\-Load} ()
\item 
bool {\bf save} ({\bf Ticket} $\ast$ticket)
\item 
bool {\bf async\-Save} ({\bf Ticket} $\ast$ticket)
\item 
{\bf Const\-Iterator} {\bf begin} () const 
\item 
{\bf Iterator} {\bf begin} ()
\item 
{\bf Const\-Iterator} {\bf end} () const 
\item 
{\bf Iterator} {\bf end} ()
\item 
void {\bf clear} ()
\item 
void {\bf insert\-Addressee} (const {\bf Addressee} \&addr)
\item 
void {\bf remove\-Addressee} (const {\bf Addressee} \&addr)
\item 
void {\bf remove\-Addressee} (const {\bf Iterator} \&it)
\item 
{\bf Iterator} {\bf find} (const {\bf Addressee} \&addr)
\item 
{\bf Addressee} {\bf find\-By\-Uid} (const {\bf QString} \&uid)
\item 
{\bf Addressee::List} {\bf all\-Addressees} ()
\item 
{\bf Addressee::List} {\bf find\-By\-Name} (const {\bf QString} \&{\bf name})
\item 
{\bf Addressee::List} {\bf find\-By\-Email} (const {\bf QString} \&email)
\item 
{\bf Addressee::List} {\bf find\-By\-Category} (const {\bf QString} \&category)
\item 
virtual {\bf QString} {\bf identifier} ()
\item 
{\bf Field::List} {\bf fields} (int category=Field::All)
\item 
bool {\bf add\-Custom\-Field} (const {\bf QString} \&label, int category=Field::All, const {\bf QString} \&key=QString::null, const {\bf QString} \&app=QString::null)
\item 
bool {\bf add\-Resource} (Resource $\ast$resource)
\item 
bool {\bf remove\-Resource} (Resource $\ast$resource)
\item 
{\bf QPtr\-List}$<$ Resource $>$ {\bf resources} ()
\item 
void {\bf set\-Error\-Handler} ({\bf Error\-Handler} $\ast$error\-Handler)
\item 
void {\bf error} (const {\bf QString} \&msg)
\item 
void {\bf clean\-Up} () KDE\_\-DEPRECATED
\item 
void {\bf dump} () const 
\item 
void {\bf emit\-Address\-Book\-Locked} ()\label{classKABC_1_1AddressBook_a33}

\item 
void {\bf emit\-Address\-Book\-Unlocked} ()\label{classKABC_1_1AddressBook_a34}

\item 
void {\bf emit\-Address\-Book\-Changed} ()\label{classKABC_1_1AddressBook_a35}

\end{CompactItemize}
\subsection*{Protected Slots}
\begin{CompactItemize}
\item 
void {\bf resource\-Loading\-Finished} (Resource $\ast$)\label{classKABC_1_1AddressBook_j0}

\item 
void {\bf resource\-Saving\-Finished} (Resource $\ast$)\label{classKABC_1_1AddressBook_j1}

\item 
void {\bf resource\-Loading\-Error} (Resource $\ast$, const {\bf QString} \&)\label{classKABC_1_1AddressBook_j2}

\item 
void {\bf resource\-Saving\-Error} (Resource $\ast$, const {\bf QString} \&)\label{classKABC_1_1AddressBook_j3}

\end{CompactItemize}
\subsection*{Protected Member Functions}
\begin{CompactItemize}
\item 
void {\bf delete\-Removed\-Addressees} ()\label{classKABC_1_1AddressBook_b0}

\item 
void {\bf set\-Standard\-Resource} (Resource $\ast$)\label{classKABC_1_1AddressBook_b1}

\item 
Resource $\ast$ {\bf standard\-Resource} ()\label{classKABC_1_1AddressBook_b2}

\item 
KRES::Manager$<$ Resource $>$ $\ast$ {\bf resource\-Manager} ()\label{classKABC_1_1AddressBook_b3}

\end{CompactItemize}
\subsection*{Friends}
\begin{CompactItemize}
\item 
class {\bf Std\-Address\-Book}\label{classKABC_1_1AddressBook_n0}

\item 
KABC\_\-EXPORT {\bf QData\-Stream} \& {\bf operator$<$$<$} ({\bf QData\-Stream} \&, const {\bf Address\-Book} \&)\label{classKABC_1_1AddressBook_n1}

\item 
KABC\_\-EXPORT {\bf QData\-Stream} \& {\bf operator$>$$>$} ({\bf QData\-Stream} \&, {\bf Address\-Book} \&)\label{classKABC_1_1AddressBook_n2}

\end{CompactItemize}
\subsection*{Classes}
\begin{CompactItemize}
\item 
class {\bf Const\-Iterator}
\begin{CompactList}\small\item\em {\bf Address}{\rm (p.\,\pageref{classKABC_1_1Address})} Book Const {\bf Iterator}{\rm (p.\,\pageref{classKABC_1_1AddressBook_1_1Iterator})}. \item\end{CompactList}\item 
class {\bf Iterator}
\begin{CompactList}\small\item\em {\bf Address}{\rm (p.\,\pageref{classKABC_1_1Address})} Book {\bf Iterator}{\rm (p.\,\pageref{classKABC_1_1AddressBook_1_1Iterator})}. \item\end{CompactList}\end{CompactItemize}


\subsection{Detailed Description}
{\bf Address}{\rm (p.\,\pageref{classKABC_1_1Address})} Book. 

This class provides access to a collection of address book entries. 



Definition at line 43 of file addressbook.h.

\subsection{Constructor \& Destructor Documentation}
\index{KABC::AddressBook@{KABC::Address\-Book}!AddressBook@{AddressBook}}
\index{AddressBook@{AddressBook}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KABC::Address\-Book::Address\-Book ()}\label{classKABC_1_1AddressBook_a0}


Constructs an address book object. 

You have to add the resources manually before calling {\bf load()}{\rm (p.\,\pageref{classKABC_1_1AddressBook_a5})}. \index{KABC::AddressBook@{KABC::Address\-Book}!AddressBook@{AddressBook}}
\index{AddressBook@{AddressBook}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KABC::Address\-Book::Address\-Book (const {\bf QString} \& {\em config})}\label{classKABC_1_1AddressBook_a1}


Constructs an address book object. 

The resources are loaded automatically.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em config}]The config file which contains the resource settings. \end{description}
\end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!~AddressBook@{$\sim$AddressBook}}
\index{~AddressBook@{$\sim$AddressBook}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}virtual KABC::Address\-Book::$\sim${\bf Address\-Book} ()\hspace{0.3cm}{\tt  [virtual]}}\label{classKABC_1_1AddressBook_a2}


Destructor. 



\subsection{Member Function Documentation}
\index{KABC::AddressBook@{KABC::Address\-Book}!requestSaveTicket@{requestSaveTicket}}
\index{requestSaveTicket@{requestSaveTicket}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Ticket}$\ast$ KABC::Address\-Book::request\-Save\-Ticket (Resource $\ast$ {\em resource} = {\tt 0})}\label{classKABC_1_1AddressBook_a3}


Requests a ticket for saving the addressbook. 

Calling this function locks the addressbook for all other processes. You need the returned ticket object for calling the {\bf save()}{\rm (p.\,\pageref{classKABC_1_1AddressBook_a7})} function.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em resource}]A pointer to the resource which shall be locked. If 0, the default resource is locked. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]0 if the resource is already locked or a valid save ticket otherwise. \end{Desc}
\begin{Desc}
\item[See also:]{\bf save()}{\rm (p.\,\pageref{classKABC_1_1AddressBook_a7})} \end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!releaseSaveTicket@{releaseSaveTicket}}
\index{releaseSaveTicket@{releaseSaveTicket}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KABC::Address\-Book::release\-Save\-Ticket ({\bf Ticket} $\ast$ {\em ticket})}\label{classKABC_1_1AddressBook_a4}


Releases the ticket requested previously with {\bf request\-Save\-Ticket()}{\rm (p.\,\pageref{classKABC_1_1AddressBook_a3})}. 

Call this function, if you want to release a ticket without saving. \index{KABC::AddressBook@{KABC::Address\-Book}!load@{load}}
\index{load@{load}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KABC::Address\-Book::load ()}\label{classKABC_1_1AddressBook_a5}


Loads all addressees synchronously. 

\begin{Desc}
\item[Returns:]Whether the loading was successfully. \end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!asyncLoad@{asyncLoad}}
\index{asyncLoad@{asyncLoad}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KABC::Address\-Book::async\-Load ()}\label{classKABC_1_1AddressBook_a6}


Loads all addressees asynchronously. 

This function returns immediately and emits the {\bf address\-Book\-Changed()}{\rm (p.\,\pageref{classKABC_1_1AddressBook_l0})} signal as soon as the loading has finished.

\begin{Desc}
\item[Returns:]Whether the synchronous part of loading was successfully. \end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!save@{save}}
\index{save@{save}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KABC::Address\-Book::save ({\bf Ticket} $\ast$ {\em ticket})}\label{classKABC_1_1AddressBook_a7}


Saves all addressees of one resource synchronously. 

If the save is successfull the ticket is deleted.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em ticket}]The ticket returned by {\bf request\-Save\-Ticket()}{\rm (p.\,\pageref{classKABC_1_1AddressBook_a3})}. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]Whether the saving was successfully. \end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!asyncSave@{asyncSave}}
\index{asyncSave@{asyncSave}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KABC::Address\-Book::async\-Save ({\bf Ticket} $\ast$ {\em ticket})}\label{classKABC_1_1AddressBook_a8}


Saves all addressees of one resource asynchronously. 

If the save is successfull the ticket is deleted.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em ticket}]The ticket returned by {\bf request\-Save\-Ticket()}{\rm (p.\,\pageref{classKABC_1_1AddressBook_a3})}. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]Whether the synchronous part of saving was successfully. \end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!begin@{begin}}
\index{begin@{begin}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Const\-Iterator} KABC::Address\-Book::begin () const}\label{classKABC_1_1AddressBook_a9}


Returns an iterator pointing to the first addressee of address book. 

This iterator equals {\bf end()}{\rm (p.\,\pageref{classKABC_1_1AddressBook_a12})} if the address book is empty. \index{KABC::AddressBook@{KABC::Address\-Book}!begin@{begin}}
\index{begin@{begin}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Iterator} KABC::Address\-Book::begin ()}\label{classKABC_1_1AddressBook_a10}


This is an overloaded member function, provided for convenience. 

It behaves essentially like the above function. \index{KABC::AddressBook@{KABC::Address\-Book}!end@{end}}
\index{end@{end}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Const\-Iterator} KABC::Address\-Book::end () const}\label{classKABC_1_1AddressBook_a11}


Returns an iterator pointing to the last addressee of address book. 

This iterator equals {\bf begin()}{\rm (p.\,\pageref{classKABC_1_1AddressBook_a10})} if the address book is empty. \index{KABC::AddressBook@{KABC::Address\-Book}!end@{end}}
\index{end@{end}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Iterator} KABC::Address\-Book::end ()}\label{classKABC_1_1AddressBook_a12}


This is an overloaded member function, provided for convenience. 

It behaves essentially like the above function. \index{KABC::AddressBook@{KABC::Address\-Book}!clear@{clear}}
\index{clear@{clear}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KABC::Address\-Book::clear ()}\label{classKABC_1_1AddressBook_a13}


Removes all addressees from the address book. 

\index{KABC::AddressBook@{KABC::Address\-Book}!insertAddressee@{insertAddressee}}
\index{insertAddressee@{insertAddressee}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KABC::Address\-Book::insert\-Addressee (const {\bf Addressee} \& {\em addr})}\label{classKABC_1_1AddressBook_a14}


Insert an addressee into the address book. 

If an addressee with the same unique id already exists, it is replaced by the new one, otherwise it is appended.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em addr}]The addressee which shall be insert. \end{description}
\end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!removeAddressee@{removeAddressee}}
\index{removeAddressee@{removeAddressee}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KABC::Address\-Book::remove\-Addressee (const {\bf Addressee} \& {\em addr})}\label{classKABC_1_1AddressBook_a15}


Removes an addressee from the address book. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em addr}]The addressee which shall be removed. \end{description}
\end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!removeAddressee@{removeAddressee}}
\index{removeAddressee@{removeAddressee}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KABC::Address\-Book::remove\-Addressee (const {\bf Iterator} \& {\em it})}\label{classKABC_1_1AddressBook_a16}


This is an overloaded member function, provided for convenience. 

It behaves essentially like the above function.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em it}]An iterator pointing to the addressee which shall be removed. \end{description}
\end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!find@{find}}
\index{find@{find}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Iterator} KABC::Address\-Book::find (const {\bf Addressee} \& {\em addr})}\label{classKABC_1_1AddressBook_a17}


Returns an iterator pointing to the specified addressee. 

It will return {\bf end()}{\rm (p.\,\pageref{classKABC_1_1AddressBook_a12})} if no addressee matched.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em addr}]The addresee you are looking for. \end{description}
\end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!findByUid@{findByUid}}
\index{findByUid@{findByUid}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Addressee} KABC::Address\-Book::find\-By\-Uid (const {\bf QString} \& {\em uid})}\label{classKABC_1_1AddressBook_a18}


Searches an addressee with the specified unique identifier. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em uid}]The unique identifier you are looking for. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]The addressee with the specified unique identifier or an empty addressee. \end{Desc}


Referenced by KABC::Std\-Address\-Book::who\-Am\-I().\index{KABC::AddressBook@{KABC::Address\-Book}!allAddressees@{allAddressees}}
\index{allAddressees@{allAddressees}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Addressee::List} KABC::Address\-Book::all\-Addressees ()}\label{classKABC_1_1AddressBook_a19}


Returns a list of all addressees in the address book. 

\index{KABC::AddressBook@{KABC::Address\-Book}!findByName@{findByName}}
\index{findByName@{findByName}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Addressee::List} KABC::Address\-Book::find\-By\-Name (const {\bf QString} \& {\em name})}\label{classKABC_1_1AddressBook_a20}


Searches all addressees which match the specified name. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em name}]The name you are looking for. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]A list of all matching addressees. \end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!findByEmail@{findByEmail}}
\index{findByEmail@{findByEmail}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Addressee::List} KABC::Address\-Book::find\-By\-Email (const {\bf QString} \& {\em email})}\label{classKABC_1_1AddressBook_a21}


Searches all addressees which match the specified email address. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em email}]The email address you are looking for. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]A list of all matching addressees. \end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!findByCategory@{findByCategory}}
\index{findByCategory@{findByCategory}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Addressee::List} KABC::Address\-Book::find\-By\-Category (const {\bf QString} \& {\em category})}\label{classKABC_1_1AddressBook_a22}


Searches all addressees which belongs to the specified category. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em category}]The category you are looking for. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]A list of all matching addressees. \end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!identifier@{identifier}}
\index{identifier@{identifier}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}virtual {\bf QString} KABC::Address\-Book::identifier ()\hspace{0.3cm}{\tt  [virtual]}}\label{classKABC_1_1AddressBook_a23}


Returns a string identifying this addressbook. 

The identifier is created by concatenation of the resource identifiers. \index{KABC::AddressBook@{KABC::Address\-Book}!fields@{fields}}
\index{fields@{fields}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Field::List} KABC::Address\-Book::fields (int {\em category} = {\tt Field::All})}\label{classKABC_1_1AddressBook_a24}


Returns a list of all Fields known to the address book which are associated with the given field category. 

\index{KABC::AddressBook@{KABC::Address\-Book}!addCustomField@{addCustomField}}
\index{addCustomField@{addCustomField}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KABC::Address\-Book::add\-Custom\-Field (const {\bf QString} \& {\em label}, int {\em category} = {\tt Field::All}, const {\bf QString} \& {\em key} = {\tt QString::null}, const {\bf QString} \& {\em app} = {\tt QString::null})}\label{classKABC_1_1AddressBook_a25}


Add custom field to address book. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em label}]User visible label of the field. \item[{\em category}]Ored list of field categories. \item[{\em key}]Identifier used as key for reading and writing the field. \item[{\em app}]String used as application key for reading and writing the field. \end{description}
\end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!addResource@{addResource}}
\index{addResource@{addResource}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KABC::Address\-Book::add\-Resource (Resource $\ast$ {\em resource})}\label{classKABC_1_1AddressBook_a26}


Adds a resource to the address book. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em resource}]The resource you want to add. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]Whether opening the resource was successfully. \end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!removeResource@{removeResource}}
\index{removeResource@{removeResource}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KABC::Address\-Book::remove\-Resource (Resource $\ast$ {\em resource})}\label{classKABC_1_1AddressBook_a27}


Removes a resource from the address book. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em resource}]The resource you want to remove. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]Whether closing the resource was successfully. \end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!resources@{resources}}
\index{resources@{resources}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QPtr\-List}$<$Resource$>$ KABC::Address\-Book::resources ()}\label{classKABC_1_1AddressBook_a28}


Returns a list of all resources. 

\index{KABC::AddressBook@{KABC::Address\-Book}!setErrorHandler@{setErrorHandler}}
\index{setErrorHandler@{setErrorHandler}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KABC::Address\-Book::set\-Error\-Handler ({\bf Error\-Handler} $\ast$ {\em error\-Handler})}\label{classKABC_1_1AddressBook_a29}


Sets the {\tt {\bf Error\-Handler}{\rm (p.\,\pageref{classKABC_1_1ErrorHandler})}}, that is used by {\bf error()}{\rm (p.\,\pageref{classKABC_1_1AddressBook_a30})} to provide GUI independent error messages. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em error\-Handler}]The error handler you want to use. \end{description}
\end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!error@{error}}
\index{error@{error}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KABC::Address\-Book::error (const {\bf QString} \& {\em msg})}\label{classKABC_1_1AddressBook_a30}


Shows GUI independent error messages. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em msg}]The error message that shall be displayed. \end{description}
\end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!cleanUp@{cleanUp}}
\index{cleanUp@{cleanUp}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KABC::Address\-Book::clean\-Up ()}\label{classKABC_1_1AddressBook_a31}


\begin{Desc}
\item[{\bf Deprecated}]There is no need to call this function anymore. \end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!dump@{dump}}
\index{dump@{dump}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KABC::Address\-Book::dump () const}\label{classKABC_1_1AddressBook_a32}


Used for debug output. 

This function prints out the list of all addressees to kd\-Debug(5700). \index{KABC::AddressBook@{KABC::Address\-Book}!addressBookChanged@{addressBookChanged}}
\index{addressBookChanged@{addressBookChanged}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KABC::Address\-Book::address\-Book\-Changed ({\bf Address\-Book} $\ast$ {\em address\-Book})\hspace{0.3cm}{\tt  [signal]}}\label{classKABC_1_1AddressBook_l0}


Emitted when one of the resources discovered a change in its backend or the asynchronous loading of all resources has finished. 

You should connect to this signal to update the presentation of the contact data in your application.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em address\-Book}]The address book which emitted this signal. \end{description}
\end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!addressBookLocked@{addressBookLocked}}
\index{addressBookLocked@{addressBookLocked}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KABC::Address\-Book::address\-Book\-Locked ({\bf Address\-Book} $\ast$ {\em address\-Book})\hspace{0.3cm}{\tt  [signal]}}\label{classKABC_1_1AddressBook_l1}


Emitted when one of the resources has been locked for writing. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em address\-Book}]The address book which emitted this signal. \end{description}
\end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!addressBookUnlocked@{addressBookUnlocked}}
\index{addressBookUnlocked@{addressBookUnlocked}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KABC::Address\-Book::address\-Book\-Unlocked ({\bf Address\-Book} $\ast$ {\em address\-Book})\hspace{0.3cm}{\tt  [signal]}}\label{classKABC_1_1AddressBook_l2}


Emitted when one of the resources has been unlocked. 

You should connect to this signal if you want to save your changes to a resource which is currently locked, and want to get notified when saving is possible again.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em address\-Book}]The address book which emitted this signal. \end{description}
\end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!loadingFinished@{loadingFinished}}
\index{loadingFinished@{loadingFinished}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KABC::Address\-Book::loading\-Finished (Resource $\ast$ {\em resource})\hspace{0.3cm}{\tt  [signal]}}\label{classKABC_1_1AddressBook_l3}


Emitted when the asynchronous loading of one resource has finished after calling {\bf async\-Load()}{\rm (p.\,\pageref{classKABC_1_1AddressBook_a6})}. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em resource}]The resource which emitted this signal. \end{description}
\end{Desc}
\index{KABC::AddressBook@{KABC::Address\-Book}!savingFinished@{savingFinished}}
\index{savingFinished@{savingFinished}!KABC::AddressBook@{KABC::Address\-Book}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KABC::Address\-Book::saving\-Finished (Resource $\ast$ {\em resource})\hspace{0.3cm}{\tt  [signal]}}\label{classKABC_1_1AddressBook_l4}


Emitted when the asynchronous saving of one resource has finished after calling {\bf async\-Save()}{\rm (p.\,\pageref{classKABC_1_1AddressBook_a8})}. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em resource}]The resource which emitted this signal. \end{description}
\end{Desc}


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