.TH "KABC::Addressee" 3 "28 Jan 2004" "kabc Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KABC::Addressee \- address book entry  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <addressee.h>\fP
.PP
.SS "Public Types"

.in +1c
.ti -1c
.RI "typedef \fBQValueList\fP< \fBAddressee\fP > \fBList\fP"
.br
.ti -1c
.RI "typedef \fBQValueList\fP< \fBAddressee\fP > \fBList\fP"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBAddressee\fP ()"
.br
.RI "\fIConstruct an empty address book entry. \fP"
.ti -1c
.RI "\fBAddressee\fP (const  \fBAddressee\fP &)"
.br
.ti -1c
.RI "\fBAddressee\fP & \fBoperator=\fP (const  \fBAddressee\fP &)"
.br
.ti -1c
.RI "bool \fBoperator==\fP (const  \fBAddressee\fP &) const "
.br
.ti -1c
.RI "bool \fBoperator!=\fP (const  \fBAddressee\fP &) const "
.br
.ti -1c
.RI "bool \fBisEmpty\fP () const "
.br
.RI "\fIReturn, if the address book entry is empty. \fP"
.ti -1c
.RI "void \fBsetUid\fP (const  \fBQString\fP &uid)"
.br
.RI "\fISet unique identifier. \fP"
.ti -1c
.RI "\fBQString\fP \fBuid\fP () const "
.br
.RI "\fIReturn unique identifier. \fP"
.ti -1c
.RI "void \fBsetName\fP (const  \fBQString\fP &name)"
.br
.RI "\fISet name. \fP"
.ti -1c
.RI "\fBQString\fP \fBname\fP () const "
.br
.RI "\fIReturn name. \fP"
.ti -1c
.RI "void \fBsetFormattedName\fP (const  \fBQString\fP &formattedName)"
.br
.RI "\fISet formatted name. \fP"
.ti -1c
.RI "\fBQString\fP \fBformattedName\fP () const "
.br
.RI "\fIReturn formatted name. \fP"
.ti -1c
.RI "void \fBsetFamilyName\fP (const  \fBQString\fP &familyName)"
.br
.RI "\fISet family name. \fP"
.ti -1c
.RI "\fBQString\fP \fBfamilyName\fP () const "
.br
.RI "\fIReturn family name. \fP"
.ti -1c
.RI "void \fBsetGivenName\fP (const  \fBQString\fP &givenName)"
.br
.RI "\fISet given name. \fP"
.ti -1c
.RI "\fBQString\fP \fBgivenName\fP () const "
.br
.RI "\fIReturn given name. \fP"
.ti -1c
.RI "void \fBsetAdditionalName\fP (const  \fBQString\fP &additionalName)"
.br
.RI "\fISet additional names. \fP"
.ti -1c
.RI "\fBQString\fP \fBadditionalName\fP () const "
.br
.RI "\fIReturn additional names. \fP"
.ti -1c
.RI "void \fBsetPrefix\fP (const  \fBQString\fP &prefix)"
.br
.RI "\fISet honorific prefixes. \fP"
.ti -1c
.RI "\fBQString\fP \fBprefix\fP () const "
.br
.RI "\fIReturn honorific prefixes. \fP"
.ti -1c
.RI "void \fBsetSuffix\fP (const  \fBQString\fP &suffix)"
.br
.RI "\fISet honorific suffixes. \fP"
.ti -1c
.RI "\fBQString\fP \fBsuffix\fP () const "
.br
.RI "\fIReturn honorific suffixes. \fP"
.ti -1c
.RI "void \fBsetNickName\fP (const  \fBQString\fP &nickName)"
.br
.RI "\fISet nick name. \fP"
.ti -1c
.RI "\fBQString\fP \fBnickName\fP () const "
.br
.RI "\fIReturn nick name. \fP"
.ti -1c
.RI "void \fBsetBirthday\fP (const  \fBQDateTime\fP &birthday)"
.br
.RI "\fISet birthday. \fP"
.ti -1c
.RI "\fBQDateTime\fP \fBbirthday\fP () const "
.br
.RI "\fIReturn birthday. \fP"
.ti -1c
.RI "void \fBsetMailer\fP (const  \fBQString\fP &mailer)"
.br
.RI "\fISet mail client. \fP"
.ti -1c
.RI "\fBQString\fP \fBmailer\fP () const "
.br
.RI "\fIReturn mail client. \fP"
.ti -1c
.RI "void \fBsetTimeZone\fP (const  \fBTimeZone\fP &timeZone)"
.br
.RI "\fISet time zone. \fP"
.ti -1c
.RI "\fBTimeZone\fP \fBtimeZone\fP () const "
.br
.RI "\fIReturn time zone. \fP"
.ti -1c
.RI "void \fBsetGeo\fP (const  \fBGeo\fP &geo)"
.br
.RI "\fISet geographic position. \fP"
.ti -1c
.RI "\fBGeo\fP \fBgeo\fP () const "
.br
.RI "\fIReturn geographic position. \fP"
.ti -1c
.RI "void \fBsetTitle\fP (const  \fBQString\fP &title)"
.br
.RI "\fISet title. \fP"
.ti -1c
.RI "\fBQString\fP \fBtitle\fP () const "
.br
.RI "\fIReturn title. \fP"
.ti -1c
.RI "void \fBsetRole\fP (const  \fBQString\fP &role)"
.br
.RI "\fISet role. \fP"
.ti -1c
.RI "\fBQString\fP \fBrole\fP () const "
.br
.RI "\fIReturn role. \fP"
.ti -1c
.RI "void \fBsetOrganization\fP (const  \fBQString\fP &organization)"
.br
.RI "\fISet organization. \fP"
.ti -1c
.RI "\fBQString\fP \fBorganization\fP () const "
.br
.RI "\fIReturn organization. \fP"
.ti -1c
.RI "void \fBsetNote\fP (const  \fBQString\fP &note)"
.br
.RI "\fISet note. \fP"
.ti -1c
.RI "\fBQString\fP \fBnote\fP () const "
.br
.RI "\fIReturn note. \fP"
.ti -1c
.RI "void \fBsetProductId\fP (const  \fBQString\fP &productId)"
.br
.RI "\fISet product identifier. \fP"
.ti -1c
.RI "\fBQString\fP \fBproductId\fP () const "
.br
.RI "\fIReturn product identifier. \fP"
.ti -1c
.RI "void \fBsetRevision\fP (const  \fBQDateTime\fP &revision)"
.br
.RI "\fISet revision date. \fP"
.ti -1c
.RI "\fBQDateTime\fP \fBrevision\fP () const "
.br
.RI "\fIReturn revision date. \fP"
.ti -1c
.RI "void \fBsetSortString\fP (const  \fBQString\fP &sortString)"
.br
.RI "\fISet sort string. \fP"
.ti -1c
.RI "\fBQString\fP \fBsortString\fP () const "
.br
.RI "\fIReturn sort string. \fP"
.ti -1c
.RI "void \fBsetUrl\fP (const  \fBKURL\fP &url)"
.br
.RI "\fISet URL. \fP"
.ti -1c
.RI "\fBKURL\fP \fBurl\fP () const "
.br
.RI "\fIReturn URL. \fP"
.ti -1c
.RI "void \fBsetSecrecy\fP (const  Secrecy &secrecy)"
.br
.RI "\fISet security class. \fP"
.ti -1c
.RI "Secrecy \fBsecrecy\fP () const "
.br
.RI "\fIReturn security class. \fP"
.ti -1c
.RI "void \fBsetLogo\fP (const  Picture &logo)"
.br
.RI "\fISet logo. \fP"
.ti -1c
.RI "Picture \fBlogo\fP () const "
.br
.RI "\fIReturn logo. \fP"
.ti -1c
.RI "void \fBsetPhoto\fP (const  Picture &photo)"
.br
.RI "\fISet photo. \fP"
.ti -1c
.RI "Picture \fBphoto\fP () const "
.br
.RI "\fIReturn photo. \fP"
.ti -1c
.RI "void \fBsetSound\fP (const  Sound &sound)"
.br
.RI "\fISet sound. \fP"
.ti -1c
.RI "Sound \fBsound\fP () const "
.br
.RI "\fIReturn sound. \fP"
.ti -1c
.RI "void \fBsetAgent\fP (const  \fBAgent\fP &agent)"
.br
.RI "\fISet agent. \fP"
.ti -1c
.RI "\fBAgent\fP \fBagent\fP () const "
.br
.RI "\fIReturn agent. \fP"
.ti -1c
.RI "void \fBsetNameFromString\fP (const  \fBQString\fP &)"
.br
.RI "\fISet name fields by parsing the given string and trying to associate the parts of the string with according fields. \fP"
.ti -1c
.RI "\fBQString\fP \fBrealName\fP () const "
.br
.RI "\fIReturn the name of the addressee. \fP"
.ti -1c
.RI "\fBQString\fP \fBassembledName\fP () const "
.br
.RI "\fIReturn the name that consists of all name parts. \fP"
.ti -1c
.RI "\fBQString\fP \fBfullEmail\fP (const  \fBQString\fP &email=QString::null) const "
.br
.RI "\fIReturn email address including real name. \fP"
.ti -1c
.RI "void \fBinsertEmail\fP (const  \fBQString\fP &email, bool preferred=false)"
.br
.RI "\fIInsert an email address. \fP"
.ti -1c
.RI "void \fBremoveEmail\fP (const  \fBQString\fP &email)"
.br
.RI "\fIRemove email address. \fP"
.ti -1c
.RI "\fBQString\fP \fBpreferredEmail\fP () const "
.br
.RI "\fIReturn preferred email address. \fP"
.ti -1c
.RI "\fBQStringList\fP \fBemails\fP () const "
.br
.RI "\fIReturn list of all email addresses. \fP"
.ti -1c
.RI "void \fBinsertPhoneNumber\fP (const  \fBPhoneNumber\fP &phoneNumber)"
.br
.RI "\fIInsert a phone number. \fP"
.ti -1c
.RI "void \fBremovePhoneNumber\fP (const  \fBPhoneNumber\fP &phoneNumber)"
.br
.RI "\fIRemove phone number. \fP"
.ti -1c
.RI "\fBPhoneNumber\fP \fBphoneNumber\fP (int type) const "
.br
.RI "\fIReturn phone number, which matches the given type. \fP"
.ti -1c
.RI "\fBPhoneNumber::List\fP \fBphoneNumbers\fP () const "
.br
.RI "\fIReturn list of all phone numbers. \fP"
.ti -1c
.RI "\fBPhoneNumber::List\fP \fBphoneNumbers\fP (int type) const "
.br
.RI "\fIReturn list of phone numbers with a special type. \fP"
.ti -1c
.RI "\fBPhoneNumber\fP \fBfindPhoneNumber\fP (const  \fBQString\fP &id) const "
.br
.RI "\fIReturn phone number with the given id. \fP"
.ti -1c
.RI "void \fBinsertKey\fP (const  \fBKey\fP &key)"
.br
.RI "\fIInsert a key. \fP"
.ti -1c
.RI "void \fBremoveKey\fP (const  \fBKey\fP &key)"
.br
.RI "\fIRemove a key. \fP"
.ti -1c
.RI "\fBKey\fP \fBkey\fP (int type, \fBQString\fP customTypeString=QString::null) const "
.br
.RI "\fIReturn key, which matches the given type. \fP"
.ti -1c
.RI "\fBKey::List\fP \fBkeys\fP () const "
.br
.RI "\fIReturn list of all keys. \fP"
.ti -1c
.RI "\fBKey::List\fP \fBkeys\fP (int type, \fBQString\fP customTypeString=QString::null) const "
.br
.RI "\fIReturn list of keys with a special type. \fP"
.ti -1c
.RI "\fBKey\fP \fBfindKey\fP (const  \fBQString\fP &id) const "
.br
.RI "\fIReturn key with the given id. \fP"
.ti -1c
.RI "void \fBinsertAddress\fP (const  \fBAddress\fP &address)"
.br
.RI "\fIInsert an address. \fP"
.ti -1c
.RI "void \fBremoveAddress\fP (const  \fBAddress\fP &address)"
.br
.RI "\fIRemove address. \fP"
.ti -1c
.RI "\fBAddress\fP \fBaddress\fP (int type) const "
.br
.RI "\fIReturn address, which matches the given type. \fP"
.ti -1c
.RI "\fBAddress::List\fP \fBaddresses\fP () const "
.br
.RI "\fIReturn list of all addresses. \fP"
.ti -1c
.RI "\fBAddress::List\fP \fBaddresses\fP (int type) const "
.br
.RI "\fIReturn list of addresses with a special type. \fP"
.ti -1c
.RI "\fBAddress\fP \fBfindAddress\fP (const  \fBQString\fP &id) const "
.br
.RI "\fIReturn address with the given id. \fP"
.ti -1c
.RI "void \fBinsertCategory\fP (const  \fBQString\fP &)"
.br
.RI "\fIInsert category. \fP"
.ti -1c
.RI "void \fBremoveCategory\fP (const  \fBQString\fP &)"
.br
.RI "\fIRemove category. \fP"
.ti -1c
.RI "bool \fBhasCategory\fP (const  \fBQString\fP &) const "
.br
.RI "\fIReturn, if addressee has the given category. \fP"
.ti -1c
.RI "void \fBsetCategories\fP (const  \fBQStringList\fP &)"
.br
.RI "\fISet categories to given value. \fP"
.ti -1c
.RI "\fBQStringList\fP \fBcategories\fP () const "
.br
.RI "\fIReturn list of all set categories. \fP"
.ti -1c
.RI "void \fBinsertCustom\fP (const  \fBQString\fP &app, const  \fBQString\fP &name, const  \fBQString\fP &value)"
.br
.RI "\fIInsert custom entry. \fP"
.ti -1c
.RI "void \fBremoveCustom\fP (const  \fBQString\fP &app, const  \fBQString\fP &name)"
.br
.RI "\fIRemove custom entry. \fP"
.ti -1c
.RI "\fBQString\fP \fBcustom\fP (const  \fBQString\fP &app, const  \fBQString\fP &name) const "
.br
.RI "\fIReturn value of custom entry, identified by app and entry name. \fP"
.ti -1c
.RI "void \fBsetCustoms\fP (const  \fBQStringList\fP &)"
.br
.RI "\fISet all custom entries. \fP"
.ti -1c
.RI "\fBQStringList\fP \fBcustoms\fP () const "
.br
.RI "\fIReturn list of all custom entries. \fP"
.ti -1c
.RI "void \fBdump\fP () const "
.br
.RI "\fIDebug output. \fP"
.ti -1c
.RI "\fBQString\fP \fBasString\fP () const "
.br
.RI "\fIReturns string representation of the addressee. \fP"
.ti -1c
.RI "void \fBsetResource\fP (Resource *resource)"
.br
.RI "\fISet resource where the addressee is from. \fP"
.ti -1c
.RI "Resource * \fBresource\fP () const "
.br
.RI "\fIReturn pointer to resource. \fP"
.ti -1c
.RI "void \fBsetChanged\fP (bool value)"
.br
.RI "\fIMark addressee as changed. \fP"
.ti -1c
.RI "bool \fBchanged\fP () const "
.br
.RI "\fIReturn whether the addressee is changed. \fP"
.ti -1c
.RI "\fBAddressee\fP ()"
.br
.RI "\fIConstruct an empty address book entry. \fP"
.ti -1c
.RI "\fBAddressee\fP (const  \fBAddressee\fP &)"
.br
.ti -1c
.RI "\fBAddressee\fP & \fBoperator=\fP (const  \fBAddressee\fP &)"
.br
.ti -1c
.RI "bool \fBoperator==\fP (const  \fBAddressee\fP &) const "
.br
.ti -1c
.RI "bool \fBoperator!=\fP (const  \fBAddressee\fP &) const "
.br
.ti -1c
.RI "bool \fBisEmpty\fP () const "
.br
.RI "\fIReturn, if the address book entry is empty. \fP"
.ti -1c
.RI "DECLARATIONS void \fBsetNameFromString\fP (const  \fBQString\fP &)"
.br
.RI "\fISet name fields by parsing the given string and trying to associate the parts of the string with according fields. \fP"
.ti -1c
.RI "\fBQString\fP \fBrealName\fP () const "
.br
.RI "\fIReturn the name of the addressee. \fP"
.ti -1c
.RI "\fBQString\fP \fBassembledName\fP () const "
.br
.RI "\fIReturn the name that consists of all name parts. \fP"
.ti -1c
.RI "\fBQString\fP \fBfullEmail\fP (const  \fBQString\fP &email=QString::null) const "
.br
.RI "\fIReturn email address including real name. \fP"
.ti -1c
.RI "void \fBinsertEmail\fP (const  \fBQString\fP &email, bool preferred=false)"
.br
.RI "\fIInsert an email address. \fP"
.ti -1c
.RI "void \fBremoveEmail\fP (const  \fBQString\fP &email)"
.br
.RI "\fIRemove email address. \fP"
.ti -1c
.RI "\fBQString\fP \fBpreferredEmail\fP () const "
.br
.RI "\fIReturn preferred email address. \fP"
.ti -1c
.RI "\fBQStringList\fP \fBemails\fP () const "
.br
.RI "\fIReturn list of all email addresses. \fP"
.ti -1c
.RI "void \fBinsertPhoneNumber\fP (const  \fBPhoneNumber\fP &phoneNumber)"
.br
.RI "\fIInsert a phone number. \fP"
.ti -1c
.RI "void \fBremovePhoneNumber\fP (const  \fBPhoneNumber\fP &phoneNumber)"
.br
.RI "\fIRemove phone number. \fP"
.ti -1c
.RI "\fBPhoneNumber\fP \fBphoneNumber\fP (int type) const "
.br
.RI "\fIReturn phone number, which matches the given type. \fP"
.ti -1c
.RI "\fBPhoneNumber::List\fP \fBphoneNumbers\fP () const "
.br
.RI "\fIReturn list of all phone numbers. \fP"
.ti -1c
.RI "\fBPhoneNumber::List\fP \fBphoneNumbers\fP (int type) const "
.br
.RI "\fIReturn list of phone numbers with a special type. \fP"
.ti -1c
.RI "\fBPhoneNumber\fP \fBfindPhoneNumber\fP (const  \fBQString\fP &id) const "
.br
.RI "\fIReturn phone number with the given id. \fP"
.ti -1c
.RI "void \fBinsertKey\fP (const  \fBKey\fP &key)"
.br
.RI "\fIInsert a key. \fP"
.ti -1c
.RI "void \fBremoveKey\fP (const  \fBKey\fP &key)"
.br
.RI "\fIRemove a key. \fP"
.ti -1c
.RI "\fBKey\fP \fBkey\fP (int type, \fBQString\fP customTypeString=QString::null) const "
.br
.RI "\fIReturn key, which matches the given type. \fP"
.ti -1c
.RI "\fBKey::List\fP \fBkeys\fP () const "
.br
.RI "\fIReturn list of all keys. \fP"
.ti -1c
.RI "\fBKey::List\fP \fBkeys\fP (int type, \fBQString\fP customTypeString=QString::null) const "
.br
.RI "\fIReturn list of keys with a special type. \fP"
.ti -1c
.RI "\fBKey\fP \fBfindKey\fP (const  \fBQString\fP &id) const "
.br
.RI "\fIReturn key with the given id. \fP"
.ti -1c
.RI "void \fBinsertAddress\fP (const  \fBAddress\fP &address)"
.br
.RI "\fIInsert an address. \fP"
.ti -1c
.RI "void \fBremoveAddress\fP (const  \fBAddress\fP &address)"
.br
.RI "\fIRemove address. \fP"
.ti -1c
.RI "\fBAddress\fP \fBaddress\fP (int type) const "
.br
.RI "\fIReturn address, which matches the given type. \fP"
.ti -1c
.RI "\fBAddress::List\fP \fBaddresses\fP () const "
.br
.RI "\fIReturn list of all addresses. \fP"
.ti -1c
.RI "\fBAddress::List\fP \fBaddresses\fP (int type) const "
.br
.RI "\fIReturn list of addresses with a special type. \fP"
.ti -1c
.RI "\fBAddress\fP \fBfindAddress\fP (const  \fBQString\fP &id) const "
.br
.RI "\fIReturn address with the given id. \fP"
.ti -1c
.RI "void \fBinsertCategory\fP (const  \fBQString\fP &)"
.br
.RI "\fIInsert category. \fP"
.ti -1c
.RI "void \fBremoveCategory\fP (const  \fBQString\fP &)"
.br
.RI "\fIRemove category. \fP"
.ti -1c
.RI "bool \fBhasCategory\fP (const  \fBQString\fP &) const "
.br
.RI "\fIReturn, if addressee has the given category. \fP"
.ti -1c
.RI "void \fBsetCategories\fP (const  \fBQStringList\fP &)"
.br
.RI "\fISet categories to given value. \fP"
.ti -1c
.RI "\fBQStringList\fP \fBcategories\fP () const "
.br
.RI "\fIReturn list of all set categories. \fP"
.ti -1c
.RI "void \fBinsertCustom\fP (const  \fBQString\fP &app, const  \fBQString\fP &name, const  \fBQString\fP &value)"
.br
.RI "\fIInsert custom entry. \fP"
.ti -1c
.RI "void \fBremoveCustom\fP (const  \fBQString\fP &app, const  \fBQString\fP &name)"
.br
.RI "\fIRemove custom entry. \fP"
.ti -1c
.RI "\fBQString\fP \fBcustom\fP (const  \fBQString\fP &app, const  \fBQString\fP &name) const "
.br
.RI "\fIReturn value of custom entry, identified by app and entry name. \fP"
.ti -1c
.RI "void \fBsetCustoms\fP (const  \fBQStringList\fP &)"
.br
.RI "\fISet all custom entries. \fP"
.ti -1c
.RI "\fBQStringList\fP \fBcustoms\fP () const "
.br
.RI "\fIReturn list of all custom entries. \fP"
.ti -1c
.RI "void \fBdump\fP () const "
.br
.RI "\fIDebug output. \fP"
.ti -1c
.RI "\fBQString\fP \fBasString\fP () const "
.br
.RI "\fIReturns string representation of the addressee. \fP"
.ti -1c
.RI "void \fBsetResource\fP (Resource *resource)"
.br
.RI "\fISet resource where the addressee is from. \fP"
.ti -1c
.RI "Resource * \fBresource\fP () const "
.br
.RI "\fIReturn pointer to resource. \fP"
.ti -1c
.RI "void \fBsetChanged\fP (bool value)"
.br
.RI "\fIMark addressee as changed. \fP"
.ti -1c
.RI "bool \fBchanged\fP () const "
.br
.RI "\fIReturn whether the addressee is changed. \fP"
.in -1c
.SS "Static Public Member Functions"

.in +1c
.ti -1c
.RI "\fBQString\fP \fBuidLabel\fP ()"
.br
.RI "\fIReturn translated label for uid field. \fP"
.ti -1c
.RI "\fBQString\fP \fBnameLabel\fP ()"
.br
.RI "\fIReturn translated label for name field. \fP"
.ti -1c
.RI "\fBQString\fP \fBformattedNameLabel\fP ()"
.br
.RI "\fIReturn translated label for formattedName field. \fP"
.ti -1c
.RI "\fBQString\fP \fBfamilyNameLabel\fP ()"
.br
.RI "\fIReturn translated label for familyName field. \fP"
.ti -1c
.RI "\fBQString\fP \fBgivenNameLabel\fP ()"
.br
.RI "\fIReturn translated label for givenName field. \fP"
.ti -1c
.RI "\fBQString\fP \fBadditionalNameLabel\fP ()"
.br
.RI "\fIReturn translated label for additionalName field. \fP"
.ti -1c
.RI "\fBQString\fP \fBprefixLabel\fP ()"
.br
.RI "\fIReturn translated label for prefix field. \fP"
.ti -1c
.RI "\fBQString\fP \fBsuffixLabel\fP ()"
.br
.RI "\fIReturn translated label for suffix field. \fP"
.ti -1c
.RI "\fBQString\fP \fBnickNameLabel\fP ()"
.br
.RI "\fIReturn translated label for nickName field. \fP"
.ti -1c
.RI "\fBQString\fP \fBbirthdayLabel\fP ()"
.br
.RI "\fIReturn translated label for birthday field. \fP"
.ti -1c
.RI "\fBQString\fP \fBhomeAddressStreetLabel\fP ()"
.br
.RI "\fIReturn translated label for homeAddressStreet field. \fP"
.ti -1c
.RI "\fBQString\fP \fBhomeAddressLocalityLabel\fP ()"
.br
.RI "\fIReturn translated label for homeAddressLocality field. \fP"
.ti -1c
.RI "\fBQString\fP \fBhomeAddressRegionLabel\fP ()"
.br
.RI "\fIReturn translated label for homeAddressRegion field. \fP"
.ti -1c
.RI "\fBQString\fP \fBhomeAddressPostalCodeLabel\fP ()"
.br
.RI "\fIReturn translated label for homeAddressPostalCode field. \fP"
.ti -1c
.RI "\fBQString\fP \fBhomeAddressCountryLabel\fP ()"
.br
.RI "\fIReturn translated label for homeAddressCountry field. \fP"
.ti -1c
.RI "\fBQString\fP \fBhomeAddressLabelLabel\fP ()"
.br
.RI "\fIReturn translated label for homeAddressLabel field. \fP"
.ti -1c
.RI "\fBQString\fP \fBbusinessAddressStreetLabel\fP ()"
.br
.RI "\fIReturn translated label for businessAddressStreet field. \fP"
.ti -1c
.RI "\fBQString\fP \fBbusinessAddressLocalityLabel\fP ()"
.br
.RI "\fIReturn translated label for businessAddressLocality field. \fP"
.ti -1c
.RI "\fBQString\fP \fBbusinessAddressRegionLabel\fP ()"
.br
.RI "\fIReturn translated label for businessAddressRegion field. \fP"
.ti -1c
.RI "\fBQString\fP \fBbusinessAddressPostalCodeLabel\fP ()"
.br
.RI "\fIReturn translated label for businessAddressPostalCode field. \fP"
.ti -1c
.RI "\fBQString\fP \fBbusinessAddressCountryLabel\fP ()"
.br
.RI "\fIReturn translated label for businessAddressCountry field. \fP"
.ti -1c
.RI "\fBQString\fP \fBbusinessAddressLabelLabel\fP ()"
.br
.RI "\fIReturn translated label for businessAddressLabel field. \fP"
.ti -1c
.RI "\fBQString\fP \fBhomePhoneLabel\fP ()"
.br
.RI "\fIReturn translated label for homePhone field. \fP"
.ti -1c
.RI "\fBQString\fP \fBbusinessPhoneLabel\fP ()"
.br
.RI "\fIReturn translated label for businessPhone field. \fP"
.ti -1c
.RI "\fBQString\fP \fBmobilePhoneLabel\fP ()"
.br
.RI "\fIReturn translated label for mobilePhone field. \fP"
.ti -1c
.RI "\fBQString\fP \fBhomeFaxLabel\fP ()"
.br
.RI "\fIReturn translated label for homeFax field. \fP"
.ti -1c
.RI "\fBQString\fP \fBbusinessFaxLabel\fP ()"
.br
.RI "\fIReturn translated label for businessFax field. \fP"
.ti -1c
.RI "\fBQString\fP \fBcarPhoneLabel\fP ()"
.br
.RI "\fIReturn translated label for carPhone field. \fP"
.ti -1c
.RI "\fBQString\fP \fBisdnLabel\fP ()"
.br
.RI "\fIReturn translated label for isdn field. \fP"
.ti -1c
.RI "\fBQString\fP \fBpagerLabel\fP ()"
.br
.RI "\fIReturn translated label for pager field. \fP"
.ti -1c
.RI "\fBQString\fP \fBemailLabel\fP ()"
.br
.RI "\fIReturn translated label for email field. \fP"
.ti -1c
.RI "\fBQString\fP \fBmailerLabel\fP ()"
.br
.RI "\fIReturn translated label for mailer field. \fP"
.ti -1c
.RI "\fBQString\fP \fBtimeZoneLabel\fP ()"
.br
.RI "\fIReturn translated label for timeZone field. \fP"
.ti -1c
.RI "\fBQString\fP \fBgeoLabel\fP ()"
.br
.RI "\fIReturn translated label for geo field. \fP"
.ti -1c
.RI "\fBQString\fP \fBtitleLabel\fP ()"
.br
.RI "\fIReturn translated label for title field. \fP"
.ti -1c
.RI "\fBQString\fP \fBroleLabel\fP ()"
.br
.RI "\fIReturn translated label for role field. \fP"
.ti -1c
.RI "\fBQString\fP \fBorganizationLabel\fP ()"
.br
.RI "\fIReturn translated label for organization field. \fP"
.ti -1c
.RI "\fBQString\fP \fBnoteLabel\fP ()"
.br
.RI "\fIReturn translated label for note field. \fP"
.ti -1c
.RI "\fBQString\fP \fBproductIdLabel\fP ()"
.br
.RI "\fIReturn translated label for productId field. \fP"
.ti -1c
.RI "\fBQString\fP \fBrevisionLabel\fP ()"
.br
.RI "\fIReturn translated label for revision field. \fP"
.ti -1c
.RI "\fBQString\fP \fBsortStringLabel\fP ()"
.br
.RI "\fIReturn translated label for sortString field. \fP"
.ti -1c
.RI "\fBQString\fP \fBurlLabel\fP ()"
.br
.RI "\fIReturn translated label for url field. \fP"
.ti -1c
.RI "\fBQString\fP \fBsecrecyLabel\fP ()"
.br
.RI "\fIReturn translated label for secrecy field. \fP"
.ti -1c
.RI "\fBQString\fP \fBlogoLabel\fP ()"
.br
.RI "\fIReturn translated label for logo field. \fP"
.ti -1c
.RI "\fBQString\fP \fBphotoLabel\fP ()"
.br
.RI "\fIReturn translated label for photo field. \fP"
.ti -1c
.RI "\fBQString\fP \fBsoundLabel\fP ()"
.br
.RI "\fIReturn translated label for sound field. \fP"
.ti -1c
.RI "\fBQString\fP \fBagentLabel\fP ()"
.br
.RI "\fIReturn translated label for agent field. \fP"
.ti -1c
.RI "void \fBparseEmailAddress\fP (const  \fBQString\fP &rawEmail, \fBQString\fP &fullName, \fBQString\fP &email)"
.br
.RI "\fIParse full email address. \fP"
.ti -1c
.RI "void \fBparseEmailAddress\fP (const  \fBQString\fP &rawEmail, \fBQString\fP &fullName, \fBQString\fP &email)"
.br
.RI "\fIParse full email address. \fP"
.in -1c
.SS "Friends"

.in +1c
.ti -1c
.RI "\fBQDataStream\fP & \fBoperator<<\fP (\fBQDataStream\fP &, const  \fBAddressee\fP &)"
.br
.ti -1c
.RI "\fBQDataStream\fP & \fBoperator>>\fP (\fBQDataStream\fP &, \fBAddressee\fP &)"
.br
.ti -1c
.RI "\fBQDataStream\fP & \fBoperator<<\fP (\fBQDataStream\fP &, const  \fBAddressee\fP &)"
.br
.ti -1c
.RI "\fBQDataStream\fP & \fBoperator>>\fP (\fBQDataStream\fP &, \fBAddressee\fP &)"
.br
.in -1c
.SH "Detailed Description"
.PP 
address book entry 

This class represents an entry in the address book.
.PP
The data of this class is implicitly shared. You can pass this class by value.
.PP
If you need the name of a field for presenting it to the user you should use the functions ending in Label(). They return a translated string which can be used as label for the corresponding field.
.PP
About the name fields:
.PP
\fBgivenName()\fP is the first name and \fBfamilyName()\fP the last name. In some countries the family name comes first, that's the reason for the naming. \fBformattedName()\fP is the full name with the correct formatting. It is used as an override, when the correct formatting can't be generated from the other name fields automatically.
.PP
\fBrealName()\fP returns a fully formatted \fBname()\fP. It uses formattedName, if set, otherwise it constucts the name from the name fields. As fallback, if nothing else is set it uses \fBname()\fP.
.PP
\fBname()\fP is the NAME type of RFC2426. It can be used as internal name for the data enty, but shouldn't be used for displaying the data to the user. 
.PP
Definition at line 73 of file addressee.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "KABC::Addressee::Addressee ()"
.PP
Construct an empty address book entry. 
.SS "KABC::Addressee::Addressee ()"
.PP
Construct an empty address book entry. 
.SH "Member Function Documentation"
.PP 
.SS "bool KABC::Addressee::isEmpty () const"
.PP
Return, if the address book entry is empty. Referenced by KABC::DistributionListManager::load().
.SS "void KABC::Addressee::setUid (const \fBQString\fP & uid)"
.PP
Set unique identifier. 
.SS "\fBQString\fP KABC::Addressee::uid () const"
.PP
Return unique identifier. Referenced by KABC::DistributionList::insertEntry(), and KABC::DistributionList::removeEntry().
.SS "\fBQString\fP KABC::Addressee::uidLabel ()\fC [static]\fP"
.PP
Return translated label for uid field. 
.SS "void KABC::Addressee::setName (const \fBQString\fP & name)"
.PP
Set name. 
.SS "\fBQString\fP KABC::Addressee::name () const"
.PP
Return name. 
.SS "\fBQString\fP KABC::Addressee::nameLabel ()\fC [static]\fP"
.PP
Return translated label for name field. 
.SS "void KABC::Addressee::setFormattedName (const \fBQString\fP & formattedName)"
.PP
Set formatted name. 
.SS "\fBQString\fP KABC::Addressee::formattedName () const"
.PP
Return formatted name. 
.SS "\fBQString\fP KABC::Addressee::formattedNameLabel ()\fC [static]\fP"
.PP
Return translated label for formattedName field. 
.SS "void KABC::Addressee::setFamilyName (const \fBQString\fP & familyName)"
.PP
Set family name. 
.SS "\fBQString\fP KABC::Addressee::familyName () const"
.PP
Return family name. 
.SS "\fBQString\fP KABC::Addressee::familyNameLabel ()\fC [static]\fP"
.PP
Return translated label for familyName field. 
.SS "void KABC::Addressee::setGivenName (const \fBQString\fP & givenName)"
.PP
Set given name. 
.SS "\fBQString\fP KABC::Addressee::givenName () const"
.PP
Return given name. 
.SS "\fBQString\fP KABC::Addressee::givenNameLabel ()\fC [static]\fP"
.PP
Return translated label for givenName field. 
.SS "void KABC::Addressee::setAdditionalName (const \fBQString\fP & additionalName)"
.PP
Set additional names. 
.SS "\fBQString\fP KABC::Addressee::additionalName () const"
.PP
Return additional names. 
.SS "\fBQString\fP KABC::Addressee::additionalNameLabel ()\fC [static]\fP"
.PP
Return translated label for additionalName field. 
.SS "void KABC::Addressee::setPrefix (const \fBQString\fP & prefix)"
.PP
Set honorific prefixes. 
.SS "\fBQString\fP KABC::Addressee::prefix () const"
.PP
Return honorific prefixes. 
.SS "\fBQString\fP KABC::Addressee::prefixLabel ()\fC [static]\fP"
.PP
Return translated label for prefix field. 
.SS "void KABC::Addressee::setSuffix (const \fBQString\fP & suffix)"
.PP
Set honorific suffixes. 
.SS "\fBQString\fP KABC::Addressee::suffix () const"
.PP
Return honorific suffixes. 
.SS "\fBQString\fP KABC::Addressee::suffixLabel ()\fC [static]\fP"
.PP
Return translated label for suffix field. 
.SS "void KABC::Addressee::setNickName (const \fBQString\fP & nickName)"
.PP
Set nick name. 
.SS "\fBQString\fP KABC::Addressee::nickName () const"
.PP
Return nick name. 
.SS "\fBQString\fP KABC::Addressee::nickNameLabel ()\fC [static]\fP"
.PP
Return translated label for nickName field. 
.SS "void KABC::Addressee::setBirthday (const \fBQDateTime\fP & birthday)"
.PP
Set birthday. 
.SS "\fBQDateTime\fP KABC::Addressee::birthday () const"
.PP
Return birthday. 
.SS "\fBQString\fP KABC::Addressee::birthdayLabel ()\fC [static]\fP"
.PP
Return translated label for birthday field. 
.SS "\fBQString\fP KABC::Addressee::homeAddressStreetLabel ()\fC [static]\fP"
.PP
Return translated label for homeAddressStreet field. 
.SS "\fBQString\fP KABC::Addressee::homeAddressLocalityLabel ()\fC [static]\fP"
.PP
Return translated label for homeAddressLocality field. 
.SS "\fBQString\fP KABC::Addressee::homeAddressRegionLabel ()\fC [static]\fP"
.PP
Return translated label for homeAddressRegion field. 
.SS "\fBQString\fP KABC::Addressee::homeAddressPostalCodeLabel ()\fC [static]\fP"
.PP
Return translated label for homeAddressPostalCode field. 
.SS "\fBQString\fP KABC::Addressee::homeAddressCountryLabel ()\fC [static]\fP"
.PP
Return translated label for homeAddressCountry field. 
.SS "\fBQString\fP KABC::Addressee::homeAddressLabelLabel ()\fC [static]\fP"
.PP
Return translated label for homeAddressLabel field. 
.SS "\fBQString\fP KABC::Addressee::businessAddressStreetLabel ()\fC [static]\fP"
.PP
Return translated label for businessAddressStreet field. 
.SS "\fBQString\fP KABC::Addressee::businessAddressLocalityLabel ()\fC [static]\fP"
.PP
Return translated label for businessAddressLocality field. 
.SS "\fBQString\fP KABC::Addressee::businessAddressRegionLabel ()\fC [static]\fP"
.PP
Return translated label for businessAddressRegion field. 
.SS "\fBQString\fP KABC::Addressee::businessAddressPostalCodeLabel ()\fC [static]\fP"
.PP
Return translated label for businessAddressPostalCode field. 
.SS "\fBQString\fP KABC::Addressee::businessAddressCountryLabel ()\fC [static]\fP"
.PP
Return translated label for businessAddressCountry field. 
.SS "\fBQString\fP KABC::Addressee::businessAddressLabelLabel ()\fC [static]\fP"
.PP
Return translated label for businessAddressLabel field. 
.SS "\fBQString\fP KABC::Addressee::homePhoneLabel ()\fC [static]\fP"
.PP
Return translated label for homePhone field. 
.SS "\fBQString\fP KABC::Addressee::businessPhoneLabel ()\fC [static]\fP"
.PP
Return translated label for businessPhone field. 
.SS "\fBQString\fP KABC::Addressee::mobilePhoneLabel ()\fC [static]\fP"
.PP
Return translated label for mobilePhone field. 
.SS "\fBQString\fP KABC::Addressee::homeFaxLabel ()\fC [static]\fP"
.PP
Return translated label for homeFax field. 
.SS "\fBQString\fP KABC::Addressee::businessFaxLabel ()\fC [static]\fP"
.PP
Return translated label for businessFax field. 
.SS "\fBQString\fP KABC::Addressee::carPhoneLabel ()\fC [static]\fP"
.PP
Return translated label for carPhone field. 
.SS "\fBQString\fP KABC::Addressee::isdnLabel ()\fC [static]\fP"
.PP
Return translated label for isdn field. 
.SS "\fBQString\fP KABC::Addressee::pagerLabel ()\fC [static]\fP"
.PP
Return translated label for pager field. 
.SS "\fBQString\fP KABC::Addressee::emailLabel ()\fC [static]\fP"
.PP
Return translated label for email field. 
.SS "void KABC::Addressee::setMailer (const \fBQString\fP & mailer)"
.PP
Set mail client. 
.SS "\fBQString\fP KABC::Addressee::mailer () const"
.PP
Return mail client. 
.SS "\fBQString\fP KABC::Addressee::mailerLabel ()\fC [static]\fP"
.PP
Return translated label for mailer field. 
.SS "void KABC::Addressee::setTimeZone (const \fBTimeZone\fP & timeZone)"
.PP
Set time zone. 
.SS "\fBTimeZone\fP KABC::Addressee::timeZone () const"
.PP
Return time zone. 
.SS "\fBQString\fP KABC::Addressee::timeZoneLabel ()\fC [static]\fP"
.PP
Return translated label for timeZone field. 
.SS "void KABC::Addressee::setGeo (const \fBGeo\fP & geo)"
.PP
Set geographic position. 
.SS "\fBGeo\fP KABC::Addressee::geo () const"
.PP
Return geographic position. 
.SS "\fBQString\fP KABC::Addressee::geoLabel ()\fC [static]\fP"
.PP
Return translated label for geo field. 
.SS "void KABC::Addressee::setTitle (const \fBQString\fP & title)"
.PP
Set title. 
.SS "\fBQString\fP KABC::Addressee::title () const"
.PP
Return title. 
.SS "\fBQString\fP KABC::Addressee::titleLabel ()\fC [static]\fP"
.PP
Return translated label for title field. 
.SS "void KABC::Addressee::setRole (const \fBQString\fP & role)"
.PP
Set role. 
.SS "\fBQString\fP KABC::Addressee::role () const"
.PP
Return role. 
.SS "\fBQString\fP KABC::Addressee::roleLabel ()\fC [static]\fP"
.PP
Return translated label for role field. 
.SS "void KABC::Addressee::setOrganization (const \fBQString\fP & organization)"
.PP
Set organization. 
.SS "\fBQString\fP KABC::Addressee::organization () const"
.PP
Return organization. 
.SS "\fBQString\fP KABC::Addressee::organizationLabel ()\fC [static]\fP"
.PP
Return translated label for organization field. 
.SS "void KABC::Addressee::setNote (const \fBQString\fP & note)"
.PP
Set note. 
.SS "\fBQString\fP KABC::Addressee::note () const"
.PP
Return note. 
.SS "\fBQString\fP KABC::Addressee::noteLabel ()\fC [static]\fP"
.PP
Return translated label for note field. 
.SS "void KABC::Addressee::setProductId (const \fBQString\fP & productId)"
.PP
Set product identifier. 
.SS "\fBQString\fP KABC::Addressee::productId () const"
.PP
Return product identifier. 
.SS "\fBQString\fP KABC::Addressee::productIdLabel ()\fC [static]\fP"
.PP
Return translated label for productId field. 
.SS "void KABC::Addressee::setRevision (const \fBQDateTime\fP & revision)"
.PP
Set revision date. 
.SS "\fBQDateTime\fP KABC::Addressee::revision () const"
.PP
Return revision date. 
.SS "\fBQString\fP KABC::Addressee::revisionLabel ()\fC [static]\fP"
.PP
Return translated label for revision field. 
.SS "void KABC::Addressee::setSortString (const \fBQString\fP & sortString)"
.PP
Set sort string. 
.SS "\fBQString\fP KABC::Addressee::sortString () const"
.PP
Return sort string. 
.SS "\fBQString\fP KABC::Addressee::sortStringLabel ()\fC [static]\fP"
.PP
Return translated label for sortString field. 
.SS "void KABC::Addressee::setUrl (const \fBKURL\fP & url)"
.PP
Set URL. 
.SS "\fBKURL\fP KABC::Addressee::url () const"
.PP
Return URL. 
.SS "\fBQString\fP KABC::Addressee::urlLabel ()\fC [static]\fP"
.PP
Return translated label for url field. 
.SS "void KABC::Addressee::setSecrecy (const Secrecy & secrecy)"
.PP
Set security class. 
.SS "Secrecy KABC::Addressee::secrecy () const"
.PP
Return security class. 
.SS "\fBQString\fP KABC::Addressee::secrecyLabel ()\fC [static]\fP"
.PP
Return translated label for secrecy field. 
.SS "void KABC::Addressee::setLogo (const Picture & logo)"
.PP
Set logo. 
.SS "Picture KABC::Addressee::logo () const"
.PP
Return logo. 
.SS "\fBQString\fP KABC::Addressee::logoLabel ()\fC [static]\fP"
.PP
Return translated label for logo field. 
.SS "void KABC::Addressee::setPhoto (const Picture & photo)"
.PP
Set photo. 
.SS "Picture KABC::Addressee::photo () const"
.PP
Return photo. 
.SS "\fBQString\fP KABC::Addressee::photoLabel ()\fC [static]\fP"
.PP
Return translated label for photo field. 
.SS "void KABC::Addressee::setSound (const Sound & sound)"
.PP
Set sound. 
.SS "Sound KABC::Addressee::sound () const"
.PP
Return sound. 
.SS "\fBQString\fP KABC::Addressee::soundLabel ()\fC [static]\fP"
.PP
Return translated label for sound field. 
.SS "void KABC::Addressee::setAgent (const \fBAgent\fP & agent)"
.PP
Set agent. 
.SS "\fBAgent\fP KABC::Addressee::agent () const"
.PP
Return agent. 
.SS "\fBQString\fP KABC::Addressee::agentLabel ()\fC [static]\fP"
.PP
Return translated label for agent field. 
.SS "void KABC::Addressee::setNameFromString (const \fBQString\fP &)"
.PP
Set name fields by parsing the given string and trying to associate the parts of the string with according fields. This function should probably be a bit more clever. 
.SS "\fBQString\fP KABC::Addressee::realName () const"
.PP
Return the name of the addressee. This is calculated from all the name fields. Referenced by KABC::AddresseeItem::AddresseeItem().
.SS "\fBQString\fP KABC::Addressee::assembledName () const"
.PP
Return the name that consists of all name parts. 
.SS "\fBQString\fP KABC::Addressee::fullEmail (const \fBQString\fP & email = QString::null) const"
.PP
Return email address including real name. \fBParameters:\fP
.RS 4
\fIemail\fP Email address to be used to construct the full email string. If this is QString::null the preferred email address is used. 
.RE
.PP
Referenced by KABC::DistributionList::emails().
.SS "void KABC::Addressee::insertEmail (const \fBQString\fP & email, bool preferred = false)"
.PP
Insert an email address. If the email address already exists in this addressee it is not duplicated.
.PP
\fBParameters:\fP
.RS 4
\fIemail\fP Email address 
.br
\fIpreferred\fP Set to true, if this is the preferred email address of the addressee. 
.RE
.PP

.SS "void KABC::Addressee::removeEmail (const \fBQString\fP & email)"
.PP
Remove email address. If the email address doesn't exist, nothing happens. 
.SS "\fBQString\fP KABC::Addressee::preferredEmail () const"
.PP
Return preferred email address. This is the first email address or the last one added with \fBisnertEmail\fP() with a set preferred parameter. Referenced by KABC::AddresseeItem::AddresseeItem().
.SS "\fBQStringList\fP KABC::Addressee::emails () const"
.PP
Return list of all email addresses. 
.SS "void KABC::Addressee::insertPhoneNumber (const \fBPhoneNumber\fP & phoneNumber)"
.PP
Insert a phone number. If a phoen number with the same id already exists in this addressee it is not duplicated. 
.SS "void KABC::Addressee::removePhoneNumber (const \fBPhoneNumber\fP & phoneNumber)"
.PP
Remove phone number. If no phone number with the given id exists for this addresse nothing happens. 
.SS "\fBPhoneNumber\fP KABC::Addressee::phoneNumber (int type) const"
.PP
Return phone number, which matches the given type. 
.SS "\fBPhoneNumber::List\fP KABC::Addressee::phoneNumbers () const"
.PP
Return list of all phone numbers. 
.SS "\fBPhoneNumber::List\fP KABC::Addressee::phoneNumbers (int type) const"
.PP
Return list of phone numbers with a special type. 
.SS "\fBPhoneNumber\fP KABC::Addressee::findPhoneNumber (const \fBQString\fP & id) const"
.PP
Return phone number with the given id. 
.SS "void KABC::Addressee::insertKey (const \fBKey\fP & key)"
.PP
Insert a key. If a key with the same id already exists in this addressee it is not duplicated. 
.SS "void KABC::Addressee::removeKey (const \fBKey\fP & key)"
.PP
Remove a key. If no key with the given id exists for this addresse nothing happens. 
.SS "\fBKey\fP KABC::Addressee::key (int type, \fBQString\fP customTypeString = QString::null) const"
.PP
Return key, which matches the given type. If \fCtype\fP == Key::Custom you can specify a string that should match. If you leave the string empty, the first key with a custom value is returned. 
.SS "\fBKey::List\fP KABC::Addressee::keys () const"
.PP
Return list of all keys. 
.SS "\fBKey::List\fP KABC::Addressee::keys (int type, \fBQString\fP customTypeString = QString::null) const"
.PP
Return list of keys with a special type. If \fCtype\fP == Key::Custom you can specify a string that should match. If you leave the string empty, all custom keys will be returned. 
.SS "\fBKey\fP KABC::Addressee::findKey (const \fBQString\fP & id) const"
.PP
Return key with the given id. 
.SS "void KABC::Addressee::insertAddress (const \fBAddress\fP & address)"
.PP
Insert an address. If an address with the same id already exists in this addressee it is not duplicated. 
.SS "void KABC::Addressee::removeAddress (const \fBAddress\fP & address)"
.PP
Remove address. If no address with the given id exists for this addresse nothing happens. 
.SS "\fBAddress\fP KABC::Addressee::address (int type) const"
.PP
Return address, which matches the given type. 
.SS "\fBAddress::List\fP KABC::Addressee::addresses () const"
.PP
Return list of all addresses. 
.SS "\fBAddress::List\fP KABC::Addressee::addresses (int type) const"
.PP
Return list of addresses with a special type. 
.SS "\fBAddress\fP KABC::Addressee::findAddress (const \fBQString\fP & id) const"
.PP
Return address with the given id. 
.SS "void KABC::Addressee::insertCategory (const \fBQString\fP &)"
.PP
Insert category. If the category already exists it is not duplicated. 
.SS "void KABC::Addressee::removeCategory (const \fBQString\fP &)"
.PP
Remove category. 
.SS "bool KABC::Addressee::hasCategory (const \fBQString\fP &) const"
.PP
Return, if addressee has the given category. 
.SS "void KABC::Addressee::setCategories (const \fBQStringList\fP &)"
.PP
Set categories to given value. 
.SS "\fBQStringList\fP KABC::Addressee::categories () const"
.PP
Return list of all set categories. 
.SS "void KABC::Addressee::insertCustom (const \fBQString\fP & app, const \fBQString\fP & name, const \fBQString\fP & value)"
.PP
Insert custom entry. The entry is identified by the name of the inserting application and a unique name. If an entry with the given app and name already exists its value is replaced with the new given value. 
.SS "void KABC::Addressee::removeCustom (const \fBQString\fP & app, const \fBQString\fP & name)"
.PP
Remove custom entry. 
.SS "\fBQString\fP KABC::Addressee::custom (const \fBQString\fP & app, const \fBQString\fP & name) const"
.PP
Return value of custom entry, identified by app and entry name. 
.SS "void KABC::Addressee::setCustoms (const \fBQStringList\fP &)"
.PP
Set all custom entries. 
.SS "\fBQStringList\fP KABC::Addressee::customs () const"
.PP
Return list of all custom entries. 
.SS "void KABC::Addressee::parseEmailAddress (const \fBQString\fP & rawEmail, \fBQString\fP & fullName, \fBQString\fP & email)\fC [static]\fP"
.PP
Parse full email address. The result is given back in fullName and email. 
.SS "void KABC::Addressee::dump () const"
.PP
Debug output. 
.SS "\fBQString\fP KABC::Addressee::asString () const"
.PP
Returns string representation of the addressee. 
.SS "void KABC::Addressee::setResource (Resource * resource)"
.PP
Set resource where the addressee is from. Referenced by KABC::BinaryFormat::loadAll().
.SS "Resource* KABC::Addressee::resource () const"
.PP
Return pointer to resource. 
.SS "void KABC::Addressee::setChanged (bool value)"
.PP
Mark addressee as changed. 
.SS "bool KABC::Addressee::changed () const"
.PP
Return whether the addressee is changed. 
.SS "bool KABC::Addressee::isEmpty () const"
.PP
Return, if the address book entry is empty. 
.SS "DECLARATIONS void KABC::Addressee::setNameFromString (const \fBQString\fP &)"
.PP
Set name fields by parsing the given string and trying to associate the parts of the string with according fields. This function should probably be a bit more clever. 
.SS "\fBQString\fP KABC::Addressee::realName () const"
.PP
Return the name of the addressee. This is calculated from all the name fields. 
.SS "\fBQString\fP KABC::Addressee::assembledName () const"
.PP
Return the name that consists of all name parts. 
.SS "\fBQString\fP KABC::Addressee::fullEmail (const \fBQString\fP & email = QString::null) const"
.PP
Return email address including real name. \fBParameters:\fP
.RS 4
\fIemail\fP Email address to be used to construct the full email string. If this is QString::null the preferred email address is used. 
.RE
.PP

.SS "void KABC::Addressee::insertEmail (const \fBQString\fP & email, bool preferred = false)"
.PP
Insert an email address. If the email address already exists in this addressee it is not duplicated.
.PP
\fBParameters:\fP
.RS 4
\fIemail\fP Email address 
.br
\fIpreferred\fP Set to true, if this is the preferred email address of the addressee. 
.RE
.PP

.SS "void KABC::Addressee::removeEmail (const \fBQString\fP & email)"
.PP
Remove email address. If the email address doesn't exist, nothing happens. 
.SS "\fBQString\fP KABC::Addressee::preferredEmail () const"
.PP
Return preferred email address. This is the first email address or the last one added with \fBisnertEmail\fP() with a set preferred parameter. 
.SS "\fBQStringList\fP KABC::Addressee::emails () const"
.PP
Return list of all email addresses. 
.SS "void KABC::Addressee::insertPhoneNumber (const \fBPhoneNumber\fP & phoneNumber)"
.PP
Insert a phone number. If a phoen number with the same id already exists in this addressee it is not duplicated. 
.SS "void KABC::Addressee::removePhoneNumber (const \fBPhoneNumber\fP & phoneNumber)"
.PP
Remove phone number. If no phone number with the given id exists for this addresse nothing happens. 
.SS "\fBPhoneNumber\fP KABC::Addressee::phoneNumber (int type) const"
.PP
Return phone number, which matches the given type. 
.SS "\fBPhoneNumber::List\fP KABC::Addressee::phoneNumbers () const"
.PP
Return list of all phone numbers. 
.SS "\fBPhoneNumber::List\fP KABC::Addressee::phoneNumbers (int type) const"
.PP
Return list of phone numbers with a special type. 
.SS "\fBPhoneNumber\fP KABC::Addressee::findPhoneNumber (const \fBQString\fP & id) const"
.PP
Return phone number with the given id. 
.SS "void KABC::Addressee::insertKey (const \fBKey\fP & key)"
.PP
Insert a key. If a key with the same id already exists in this addressee it is not duplicated. 
.SS "void KABC::Addressee::removeKey (const \fBKey\fP & key)"
.PP
Remove a key. If no key with the given id exists for this addresse nothing happens. 
.SS "\fBKey\fP KABC::Addressee::key (int type, \fBQString\fP customTypeString = QString::null) const"
.PP
Return key, which matches the given type. If \fCtype\fP == Key::Custom you can specify a string that should match. If you leave the string empty, the first key with a custom value is returned. 
.SS "\fBKey::List\fP KABC::Addressee::keys () const"
.PP
Return list of all keys. 
.SS "\fBKey::List\fP KABC::Addressee::keys (int type, \fBQString\fP customTypeString = QString::null) const"
.PP
Return list of keys with a special type. If \fCtype\fP == Key::Custom you can specify a string that should match. If you leave the string empty, all custom keys will be returned. 
.SS "\fBKey\fP KABC::Addressee::findKey (const \fBQString\fP & id) const"
.PP
Return key with the given id. 
.SS "void KABC::Addressee::insertAddress (const \fBAddress\fP & address)"
.PP
Insert an address. If an address with the same id already exists in this addressee it is not duplicated. 
.SS "void KABC::Addressee::removeAddress (const \fBAddress\fP & address)"
.PP
Remove address. If no address with the given id exists for this addresse nothing happens. 
.SS "\fBAddress\fP KABC::Addressee::address (int type) const"
.PP
Return address, which matches the given type. 
.SS "\fBAddress::List\fP KABC::Addressee::addresses () const"
.PP
Return list of all addresses. 
.SS "\fBAddress::List\fP KABC::Addressee::addresses (int type) const"
.PP
Return list of addresses with a special type. 
.SS "\fBAddress\fP KABC::Addressee::findAddress (const \fBQString\fP & id) const"
.PP
Return address with the given id. 
.SS "void KABC::Addressee::insertCategory (const \fBQString\fP &)"
.PP
Insert category. If the category already exists it is not duplicated. 
.SS "void KABC::Addressee::removeCategory (const \fBQString\fP &)"
.PP
Remove category. 
.SS "bool KABC::Addressee::hasCategory (const \fBQString\fP &) const"
.PP
Return, if addressee has the given category. 
.SS "void KABC::Addressee::setCategories (const \fBQStringList\fP &)"
.PP
Set categories to given value. 
.SS "\fBQStringList\fP KABC::Addressee::categories () const"
.PP
Return list of all set categories. 
.SS "void KABC::Addressee::insertCustom (const \fBQString\fP & app, const \fBQString\fP & name, const \fBQString\fP & value)"
.PP
Insert custom entry. The entry is identified by the name of the inserting application and a unique name. If an entry with the given app and name already exists its value is replaced with the new given value. 
.SS "void KABC::Addressee::removeCustom (const \fBQString\fP & app, const \fBQString\fP & name)"
.PP
Remove custom entry. 
.SS "\fBQString\fP KABC::Addressee::custom (const \fBQString\fP & app, const \fBQString\fP & name) const"
.PP
Return value of custom entry, identified by app and entry name. 
.SS "void KABC::Addressee::setCustoms (const \fBQStringList\fP &)"
.PP
Set all custom entries. 
.SS "\fBQStringList\fP KABC::Addressee::customs () const"
.PP
Return list of all custom entries. 
.SS "void KABC::Addressee::parseEmailAddress (const \fBQString\fP & rawEmail, \fBQString\fP & fullName, \fBQString\fP & email)\fC [static]\fP"
.PP
Parse full email address. The result is given back in fullName and email. 
.SS "void KABC::Addressee::dump () const"
.PP
Debug output. 
.SS "\fBQString\fP KABC::Addressee::asString () const"
.PP
Returns string representation of the addressee. 
.SS "void KABC::Addressee::setResource (Resource * resource)"
.PP
Set resource where the addressee is from. 
.SS "Resource* KABC::Addressee::resource () const"
.PP
Return pointer to resource. 
.SS "void KABC::Addressee::setChanged (bool value)"
.PP
Mark addressee as changed. 
.SS "bool KABC::Addressee::changed () const"
.PP
Return whether the addressee is changed. 

.SH "Author"
.PP 
Generated automatically by Doxygen for kabc Library from the source code.
