The Contact element represents an addressbook contact, A Contact object has a collection of details (like a name, phone numbers and email addresses). Each detail (which can have multiple fields) is stored in an appropriate subclass of ContactDetail, and the Contact allows retrieving these details in various ways. More...
This element was introduced in Mobility 1.1.
If some of the contact details are not unique details, all of this type of detail values can be accessed by dynamic properties. For example, there are 3 phone numbers stored in a contact, they can be accessed by contact.phoneNumbers property, Which holds a list of all PhoneNumber details. If the dynamic property was not exists (for unique details), an undefined value returned. The list of dynamic detail properties depends on the contact engine implementations.
The Contact element is part of the QtMobility.contacts 1.1 module.
See also QContact.
read-onlyaddress : Address |
This property holds the address detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlyanniversary : Anniversary |
This property holds the anniversary detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlyavatar : Avatar |
This property holds the avatar detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlybirthday : Birthday |
This property holds the birthday detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlycontactId : int |
This property holds the id of the Contact object. This property is read only.
This property group was introduced in Mobility 1.1.
read-onlydetails : list<ContactDetail> |
This property holds the list of ContactDetail elements that the contact has.
This property group was introduced in Mobility 1.1.
read-onlydisplayLabel : string |
This property holds the display label value of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlyemail : EmailAddress |
This property holds the email address detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlyfamily : Family |
This property holds the family detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlyfavorite : Favorite |
This property holds the favorite detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlygender : Gender |
This property holds the gender detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlygeolocation : GeoLocation |
This property holds the geolocation detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlyglobalPresence : GlobalPresence |
This property holds the globalPresence detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlyguid : Guid |
This property holds the guid detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlyhobby : Hobby |
This property holds the hobby detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlymanager : string |
This property holds the manager name which the Contact object comes from.
This property group was introduced in Mobility 1.1.
read-onlymodified : bool |
This property holds the dirty flag of the Contact object. If the Contact has been changed, returns true, otherwise returns false.
This property group was introduced in Mobility 1.1.
read-onlyname : Name |
This property holds the name detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlynickname : Nickname |
This property holds the nickname detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlynote : Note |
This property holds the note detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlyonlineAccount : OnlineAccount |
This property holds the onlineAccount detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlyorganization : Organization |
This property holds the organization detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlyphoneNumber : PhoneNumber |
This property holds the phoneNumber detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlypresence : Presence |
This property holds the presence detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlyringtone : Ringtone |
This property holds the ringtone detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlysyncTarget : SyncTarget |
This property holds the syncTarget detail of the Contact object.
This property group was introduced in Mobility 1.1.
read-onlytag : Tag |
This property holds the tag detail of the Contact object.
This property group was introduced in Mobility 1.1.
thumbnail : url |
This property holds the thumbnail URL of the Contact object.
This property group was introduced in Mobility 1.1.
type : enumeration |
This property holds type of the Contact, the value can be one of:
This property group was introduced in Mobility 1.1.
read-onlyurl : Url |
This property holds the url detail of the Contact object.
This property group was introduced in Mobility 1.1.
Contact::addDetail ( detail ) |
Adds the given contact detail to the contact, returns true if successful, otherwise returns false. Note:: If the detail has been added into the same contact before, this operation will be ignored, so if you want to add a detail multiple times, the detail should be copied before calling this function.
This documentation was introduced in Mobility 1.1.
Remove all detail objects in this contact.
This documentation was introduced in Mobility 1.1.
ContactDetail Contact::detail ( name ) |
Returns ContactDetail object which detail name or detail type is name.
This documentation was introduced in Mobility 1.1.
list<ContactDetail> Contact::details ( name ) |
Returns a list of ContactDetail objects which detail name or detail type is name.
This documentation was introduced in Mobility 1.1.
Contact::removeDetail ( detail ) |
Removes the give contact detail from the contact, returns true if successful, otherwise returns false.
This documentation was introduced in Mobility 1.1.
Saves this Contact if the contact has been modified.
This documentation was introduced in Mobility 1.1.
See also Contact::modified.
© 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide.
All other trademarks are property of their respective owners. Privacy Policy
Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia.
Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.