QtMobility Reference Documentation

Supported vCard Features

Properties

The following table lists the vCard properties that the Versit API supports.

Versit PropertyQContactDetail
ADRQContactAddress
BDAYQContactBirthday
CATEGORIES, X-CATEGORIES*QContactTag
FNQContactName (CustomLabel field)
GEOQContactGeoLocation
EMAILQContactEmailAddress
IMPP, X-IMPP*QContactOnlineAccount (SubTypeImpp)
LOGOQContactOrganization (LogoUrl field)
NQContactName
NICKNAME, X-NICKNAME*, X-EPOCSECONDNAME*QContactNickname
NOTEQContactNote
ORGQContactOrganization (Name field)
PHOTOQContactThumbnail for base-64 encoded images or QContactAvatar for URLs
REVQContactTimestamp
ROLEQContactOrganization (Role field)
SOUNDQContactRingtone
TELQContactPhoneNumber
TITLEQContactOrganization (Title field)
UIDQContactGuid
URLQContactUrl
X-ANNIVERSARYQContactAnniversary
X-ASSISTANTQContactOrganization (Assistant field)
X-ASSISTANT-TELQContactPhoneNumber (SubTypeAssistant)
X-CHILDRENQContactFamily (Children field)
X-GENDERQContactGender
X-JABBERQContactOnlineAccount (SubTypeImpp)
X-SIPQContactOnlineAccount
X-SPOUSEQContactFamily (Spouse field)

* These are understood by the importer, but are not generated by the exporter.

Parameters

The Versit module supports the following vCard parameter:

  • ENCODING (for base64 or quoted-printable values)
  • CHARSET (text character set for a specific property)
  • VALUE (for LOGO, SOUND and PHOTO to specify whether the resource is external or embedded)
  • TYPE (see below)

The following table lists the values that are supported for the TYPE parameter:

Value of TYPE parameterValue of QContactDetail Context/SubType
HOMEQContactDetail::ContextHome
WORKQContactDetail::ContextWork
DOMQContactAddress::SubTypeDomestic
INTLQContactAddress::SubTypeInternational
POSTALQContactAddress::SubTypePostal
PARCELQContactAddress::SubTypeParcel
VOICEQContactPhoneNumber::SubTypeVoice
CELLQContactPhoneNumber::SubTypeMobile
MODEMQContactPhoneNumber::SubTypeModem
CARQContactPhoneNumber::SubTypeCar
VIDEOQContactPhoneNumber::SubTypeVideo
FAXQContactPhoneNumber::SubTypeFax
BBSQContactPhoneNumber::SubTypeBulletinBoardSystem
PAGERQContactPhoneNumber::SubTypePager
SWISQContactOnlineAccount::SubTypeVideoShare
VOIPQContactOnlineAccount::SubTypeSipVoip

PREF is partially supported. If a property has the parameter TYPE set to PREF, the QContactDetail that it generates is placed at the front of the list saved to the resultant QContact. This has the effect that calling QContact::detail() will return it in preference over other details. However, the existence of the PREF parameter is not preserved, so it won't appear when exporting the contact back to vCard.

X

Thank you for giving your feedback.

Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.