#include <addressee.h>
Public Methods | |
| Addressee () | |
| bool | isEmpty () const |
| void | setUid (const QString &uid) |
| QString | uid () const |
| void | setName (const QString &name) |
| QString | name () const |
| void | setFormattedName (const QString &formattedName) |
| QString | formattedName () const |
| void | setFamilyName (const QString &familyName) |
| QString | familyName () const |
| void | setGivenName (const QString &givenName) |
| QString | givenName () const |
| void | setAdditionalName (const QString &additionalName) |
| QString | additionalName () const |
| void | setPrefix (const QString &prefix) |
| QString | prefix () const |
| void | setSuffix (const QString &suffix) |
| QString | suffix () const |
| void | setNickName (const QString &nickName) |
| QString | nickName () const |
| void | setBirthday (const QDateTime &birthday) |
| QDateTime | birthday () const |
| void | setMailer (const QString &mailer) |
| QString | mailer () const |
| void | setTimeZone (const TimeZone &timeZone) |
| TimeZone | timeZone () const |
| void | setGeo (const Geo &geo) |
| Geo | geo () const |
| void | setTitle (const QString &title) |
| QString | title () const |
| void | setRole (const QString &role) |
| QString | role () const |
| void | setOrganization (const QString &organization) |
| QString | organization () const |
| void | setNote (const QString ¬e) |
| QString | note () const |
| void | setProductId (const QString &productId) |
| QString | productId () const |
| void | setRevision (const QDateTime &revision) |
| QDateTime | revision () const |
| void | setSortString (const QString &sortString) |
| QString | sortString () const |
| void | setUrl (const KURL &url) |
| KURL | url () const |
| void | setSecrecy (const Secrecy &secrecy) |
| Secrecy | secrecy () const |
| void | setLogo (const Picture &logo) |
| Picture | logo () const |
| void | setPhoto (const Picture &photo) |
| Picture | photo () const |
| void | setSound (const Sound &sound) |
| Sound | sound () const |
| void | setAgent (const Agent &agent) |
| Agent | agent () const |
| void | setNameFromString (const QString &) |
| QString | realName () const |
| QString | assembledName () const |
| QString | fullEmail (const QString &email=QString::null) const |
| void | insertEmail (const QString &email, bool preferred=false) |
| void | removeEmail (const QString &email) |
| QString | preferredEmail () const |
| QStringList | emails () const |
| void | insertPhoneNumber (const PhoneNumber &phoneNumber) |
| void | removePhoneNumber (const PhoneNumber &phoneNumber) |
| PhoneNumber | phoneNumber (int type) const |
| PhoneNumber::List | phoneNumbers () const |
| PhoneNumber::List | phoneNumbers (int type) const |
| PhoneNumber | findPhoneNumber (const QString &id) const |
| void | insertKey (const Key &key) |
| void | removeKey (const Key &key) |
| Key | key (int type, QString customTypeString=QString::null) const |
| Key::List | keys () const |
| Key::List | keys (int type, QString customTypeString=QString::null) const |
| Key | findKey (const QString &id) const |
| void | insertAddress (const Address &address) |
| void | removeAddress (const Address &address) |
| Address | address (int type) const |
| Address::List | addresses () const |
| Address::List | addresses (int type) const |
| Address | findAddress (const QString &id) const |
| void | insertCategory (const QString &) |
| void | removeCategory (const QString &) |
| bool | hasCategory (const QString &) const |
| void | setCategories (const QStringList &) |
| QStringList | categories () const |
| void | insertCustom (const QString &app, const QString &name, const QString &value) |
| void | removeCustom (const QString &app, const QString &name) |
| QString | custom (const QString &app, const QString &name) const |
| void | setCustoms (const QStringList &) |
| QStringList | customs () const |
| void | dump () const |
| QString | asString () const |
| void | setResource (Resource *resource) |
| Resource * | resource () const |
| void | setChanged (bool value) |
| bool | changed () const |
| Addressee () | |
| bool | isEmpty () const |
| DECLARATIONS void | setNameFromString (const QString &) |
| QString | realName () const |
| QString | assembledName () const |
| QString | fullEmail (const QString &email=QString::null) const |
| void | insertEmail (const QString &email, bool preferred=false) |
| void | removeEmail (const QString &email) |
| QString | preferredEmail () const |
| QStringList | emails () const |
| void | insertPhoneNumber (const PhoneNumber &phoneNumber) |
| void | removePhoneNumber (const PhoneNumber &phoneNumber) |
| PhoneNumber | phoneNumber (int type) const |
| PhoneNumber::List | phoneNumbers () const |
| PhoneNumber::List | phoneNumbers (int type) const |
| PhoneNumber | findPhoneNumber (const QString &id) const |
| void | insertKey (const Key &key) |
| void | removeKey (const Key &key) |
| Key | key (int type, QString customTypeString=QString::null) const |
| Key::List | keys () const |
| Key::List | keys (int type, QString customTypeString=QString::null) const |
| Key | findKey (const QString &id) const |
| void | insertAddress (const Address &address) |
| void | removeAddress (const Address &address) |
| Address | address (int type) const |
| Address::List | addresses () const |
| Address::List | addresses (int type) const |
| Address | findAddress (const QString &id) const |
| void | insertCategory (const QString &) |
| void | removeCategory (const QString &) |
| bool | hasCategory (const QString &) const |
| void | setCategories (const QStringList &) |
| QStringList | categories () const |
| void | insertCustom (const QString &app, const QString &name, const QString &value) |
| void | removeCustom (const QString &app, const QString &name) |
| QString | custom (const QString &app, const QString &name) const |
| void | setCustoms (const QStringList &) |
| QStringList | customs () const |
| void | dump () const |
| QString | asString () const |
| void | setResource (Resource *resource) |
| Resource * | resource () const |
| void | setChanged (bool value) |
| bool | changed () const |
Static Public Methods | |
| QString | uidLabel () |
| QString | nameLabel () |
| QString | formattedNameLabel () |
| QString | familyNameLabel () |
| QString | givenNameLabel () |
| QString | additionalNameLabel () |
| QString | prefixLabel () |
| QString | suffixLabel () |
| QString | nickNameLabel () |
| QString | birthdayLabel () |
| QString | homeAddressStreetLabel () |
| QString | homeAddressLocalityLabel () |
| QString | homeAddressRegionLabel () |
| QString | homeAddressPostalCodeLabel () |
| QString | homeAddressCountryLabel () |
| QString | homeAddressLabelLabel () |
| QString | businessAddressStreetLabel () |
| QString | businessAddressLocalityLabel () |
| QString | businessAddressRegionLabel () |
| QString | businessAddressPostalCodeLabel () |
| QString | businessAddressCountryLabel () |
| QString | businessAddressLabelLabel () |
| QString | homePhoneLabel () |
| QString | businessPhoneLabel () |
| QString | mobilePhoneLabel () |
| QString | homeFaxLabel () |
| QString | businessFaxLabel () |
| QString | carPhoneLabel () |
| QString | isdnLabel () |
| QString | pagerLabel () |
| QString | emailLabel () |
| QString | mailerLabel () |
| QString | timeZoneLabel () |
| QString | geoLabel () |
| QString | titleLabel () |
| QString | roleLabel () |
| QString | organizationLabel () |
| QString | noteLabel () |
| QString | productIdLabel () |
| QString | revisionLabel () |
| QString | sortStringLabel () |
| QString | urlLabel () |
| QString | secrecyLabel () |
| QString | logoLabel () |
| QString | photoLabel () |
| QString | soundLabel () |
| QString | agentLabel () |
| void | parseEmailAddress (const QString &rawEmail, QString &fullName, QString &email) |
| void | parseEmailAddress (const QString &rawEmail, QString &fullName, QString &email) |
This class represents an entry in the address book.
The data of this class is implicitly shared. You can pass this class by value.
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.
About the name fields:
givenName() is the first name and familyName() the last name. In some countries the family name comes first, that's the reason for the naming. formattedName() 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.
realName() returns a fully formatted name(). It uses formattedName, if set, otherwise it constucts the name from the name fields. As fallback, if nothing else is set it uses name().
name() 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.
Definition at line 73 of file addressee.h.
|
|
Construct an empty address book entry. |
|
|
Construct an empty address book entry. |
|
|
Return additional names. |
|
|
Return translated label for additionalName field. |
|
|
Return address, which matches the given type. |
|
|
Return address, which matches the given type. |
|
|
Return list of addresses with a special type. |
|
|
Return list of all addresses. |
|
|
Return list of addresses with a special type. |
|
|
Return list of all addresses. |
|
|
Return agent. |
|
|
Return translated label for agent field. |
|
|
Return the name that consists of all name parts. |
|
|
Return the name that consists of all name parts. |
|
|
Returns string representation of the addressee. |
|
|
Returns string representation of the addressee. |
|
|
Return birthday. |
|
|
Return translated label for birthday field. |
|
|
Return translated label for businessAddressCountry field. |
|
|
Return translated label for businessAddressLabel field. |
|
|
Return translated label for businessAddressLocality field. |
|
|
Return translated label for businessAddressPostalCode field. |
|
|
Return translated label for businessAddressRegion field. |
|
|
Return translated label for businessAddressStreet field. |
|
|
Return translated label for businessFax field. |
|
|
Return translated label for businessPhone field. |
|
|
Return translated label for carPhone field. |
|
|
Return list of all set categories. |
|
|
Return list of all set categories. |
|
|
Return whether the addressee is changed. |
|
|
Return whether the addressee is changed. |
|
||||||||||||
|
Return value of custom entry, identified by app and entry name. |
|
||||||||||||
|
Return value of custom entry, identified by app and entry name. |
|
|
Return list of all custom entries. |
|
|
Return list of all custom entries. |
|
|
Debug output. |
|
|
Debug output. |
|
|
Return translated label for email field. |
|
|
Return list of all email addresses. |
|
|
Return list of all email addresses. |
|
|
Return family name. |
|
|
Return translated label for familyName field. |
|
|
Return address with the given id. |
|
|
Return address with the given id. |
|
|
Return key with the given id. |
|
|
Return key with the given id. |
|
|
Return phone number with the given id. |
|
|
Return phone number with the given id. |
|
|
Return formatted name. |
|
|
Return translated label for formattedName field. |
|
|
Return email address including real name.
|
|
|
Return email address including real name.
|
|
|
Return geographic position. |
|
|
Return translated label for geo field. |
|
|
Return given name. |
|
|
Return translated label for givenName field. |
|
|
Return, if addressee has the given category. |
|
|
Return, if addressee has the given category. |
|
|
Return translated label for homeAddressCountry field. |
|
|
Return translated label for homeAddressLabel field. |
|
|
Return translated label for homeAddressLocality field. |
|
|
Return translated label for homeAddressPostalCode field. |
|
|
Return translated label for homeAddressRegion field. |
|
|
Return translated label for homeAddressStreet field. |
|
|
Return translated label for homeFax field. |
|
|
Return translated label for homePhone field. |
|
|
Insert an address. If an address with the same id already exists in this addressee it is not duplicated. |
|
|
Insert an address. If an address with the same id already exists in this addressee it is not duplicated. |
|
|
Insert category. If the category already exists it is not duplicated. |
|
|
Insert category. If the category already exists it is not duplicated. |
|
||||||||||||||||
|
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. |
|
||||||||||||||||
|
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. |
|
||||||||||||
|
Insert an email address. If the email address already exists in this addressee it is not duplicated.
|
|
||||||||||||
|
Insert an email address. If the email address already exists in this addressee it is not duplicated.
|
|
|
Insert a key. If a key with the same id already exists in this addressee it is not duplicated. |
|
|
Insert a key. If a key with the same id already exists in this addressee it is not duplicated. |
|
|
Insert a phone number. If a phoen number with the same id already exists in this addressee it is not duplicated. |
|
|
Insert a phone number. If a phoen number with the same id already exists in this addressee it is not duplicated. |
|
|
Return translated label for isdn field. |
|
|
Return, if the address book entry is empty. |
|
|
Return, if the address book entry is empty. |
|
||||||||||||
|
Return key, which matches the given type. If |
|
||||||||||||
|
Return key, which matches the given type. If |
|
||||||||||||
|
Return list of keys with a special type. If |
|
|
Return list of all keys. |
|
||||||||||||
|
Return list of keys with a special type. If |
|
|
Return list of all keys. |
|
|
Return logo. |
|
|
Return translated label for logo field. |
|
|
Return mail client. |
|
|
Return translated label for mailer field. |
|
|
Return translated label for mobilePhone field. |
|
|
Return name. |
|
|
Return translated label for name field. |
|
|
Return nick name. |
|
|
Return translated label for nickName field. |
|
|
Return note. |
|
|
Return translated label for note field. |
|
|
Return organization. |
|
|
Return translated label for organization field. |
|
|
Return translated label for pager field. |
|
||||||||||||||||
|
Parse full email address. The result is given back in fullName and email. |
|
||||||||||||||||
|
Parse full email address. The result is given back in fullName and email. |
|
|
Return phone number, which matches the given type. |
|
|
Return phone number, which matches the given type. |
|
|
Return list of phone numbers with a special type. |
|
|
Return list of all phone numbers. |
|
|
Return list of phone numbers with a special type. |
|
|
Return list of all phone numbers. |
|
|
Return photo. |
|
|
Return translated label for photo field. |
|
|
Return preferred email address. This is the first email address or the last one added with isnertEmail() with a set preferred parameter. |
|
|
Return preferred email address. This is the first email address or the last one added with isnertEmail() with a set preferred parameter. |
|
|
Return honorific prefixes. |
|
|
Return translated label for prefix field. |
|
|
Return product identifier. |
|
|
Return translated label for productId field. |
|
|
Return the name of the addressee. This is calculated from all the name fields. |
|
|
Return the name of the addressee. This is calculated from all the name fields. |
|
|
Remove address. If no address with the given id exists for this addresse nothing happens. |
|
|
Remove address. If no address with the given id exists for this addresse nothing happens. |
|
|
Remove category. |
|
|
Remove category. |
|
||||||||||||
|
Remove custom entry. |
|
||||||||||||
|
Remove custom entry. |
|
|
Remove email address. If the email address doesn't exist, nothing happens. |
|
|
Remove email address. If the email address doesn't exist, nothing happens. |
|
|
Remove a key. If no key with the given id exists for this addresse nothing happens. |
|
|
Remove a key. If no key with the given id exists for this addresse nothing happens. |
|
|
Remove phone number. If no phone number with the given id exists for this addresse nothing happens. |
|
|
Remove phone number. If no phone number with the given id exists for this addresse nothing happens. |
|
|
Return pointer to resource. |
|
|
Return pointer to resource. |
|
|
Return revision date. |
|
|
Return translated label for revision field. |
|
|
Return role. |
|
|
Return translated label for role field. |
|
|
Return security class. |
|
|
Return translated label for secrecy field. |
|
|
Set additional names. |
|
|
Set agent. |
|
|
Set birthday. |
|
|
Set categories to given value. |
|
|
Set categories to given value. |
|
|
Mark addressee as changed. |
|
|
Mark addressee as changed. |
|
|
Set all custom entries. |
|
|
Set all custom entries. |
|
|
Set family name. |
|
|
Set formatted name. |
|
|
Set geographic position. |
|
|
Set given name. |
|
|
Set logo. |
|
|
Set mail client. |
|
|
Set name. |
|
|
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. |
|
|
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. |
|
|
Set nick name. |
|
|
Set note. |
|
|
Set organization. |
|
|
Set photo. |
|
|
Set honorific prefixes. |
|
|
Set product identifier. |
|
|
Set resource where the addressee is from. |
|
|
Set resource where the addressee is from. |
|
|
Set revision date. |
|
|
Set role. |
|
|
Set security class. |
|
|
Set sort string. |
|
|
Set sound. |
|
|
Set honorific suffixes. |
|
|
Set time zone. |
|
|
Set title. |
|
|
Set unique identifier. |
|
|
Set URL. |
|
|
Return sort string. |
|
|
Return translated label for sortString field. |
|
|
Return sound. |
|
|
Return translated label for sound field. |
|
|
Return honorific suffixes. |
|
|
Return translated label for suffix field. |
|
|
Return time zone. |
|
|
Return translated label for timeZone field. |
|
|
Return title. |
|
|
Return translated label for title field. |
|
|
Return unique identifier. |
|
|
Return translated label for uid field. |
|
|
Return URL. |
|
|
Return translated label for url field. |
1.2.18