Versit API

Mapping the vCard constants

vCard properties are mapped to QContactDetails as follows:

    // Mappings from versit property names to Qt contact details
    const versitContactDetailMapping versitContactDetailMappings[] = {
        {"ADR",           QContactAddress::DefinitionName.str,
                          ""},
        {"BDAY",          QContactBirthday::DefinitionName.str,
                          QContactBirthday::FieldBirthday.str},
        {"FN",            QContactDisplayLabel::DefinitionName.str,
                          ""},
        {"GEO",           QContactGeolocation::DefinitionName.str,
                          ""},
        {"EMAIL",         QContactEmailAddress::DefinitionName.str,
                          QContactEmailAddress::FieldEmailAddress.str},
        {"IMPP",          QContactOnlineAccount::DefinitionName.str,
                          QContactOnlineAccount::SubTypeImpp.str},
        {"LOGO",          QContactOrganization::DefinitionName.str,
                          QContactOrganization::FieldLogo.str},
        {"N",             QContactName::DefinitionName.str,
                          ""},
        {"NICKNAME",      QContactNickname::DefinitionName.str,
                          QContactNickname::FieldNickname.str},
        {"NOTE",          QContactNote::DefinitionName.str,
                          QContactNote::FieldNote.str},
        {"ORG",           QContactOrganization::DefinitionName.str,
                          QContactOrganization::FieldName.str},
        {"PHOTO",         QContactAvatar::DefinitionName.str,
                          QContactAvatar::SubTypeImage.str},
        {"REV",           QContactTimestamp::DefinitionName.str,
                          ""},
        {"ROLE",          QContactOrganization::DefinitionName.str,
                          QContactOrganization::FieldRole.str},
        {"SOUND",         QContactAvatar::DefinitionName.str,
                          QContactAvatar::SubTypeAudioRingtone.str},
        {"TEL",           QContactPhoneNumber::DefinitionName.str,
                          QContactPhoneNumber::FieldNumber.str},
        {"TITLE",         QContactOrganization::DefinitionName.str,
                          QContactOrganization::FieldTitle.str},
        {"UID",           QContactGuid::DefinitionName.str,
                          QContactGuid::FieldGuid.str},
        {"URL",           QContactUrl::DefinitionName.str,
                          QContactUrl::FieldUrl.str},
        {"X-ANNIVERSARY", QContactAnniversary::DefinitionName.str,
                          ""},
        {"X-ASSISTANT",   QContactOrganization::DefinitionName.str,
                          QContactOrganization::FieldAssistantName.str},
        {"X-CHILDREN",    QContactFamily::DefinitionName.str,
                          QContactFamily::FieldChildren.str},
        {"X-GENDER",      QContactGender::DefinitionName.str,
                          QContactGender::FieldGender.str},
        {"X-IMPP",        QContactOnlineAccount::DefinitionName.str,
                          QContactOnlineAccount::SubTypeImpp.str},
        {"X-NICKNAME",    QContactNickname::DefinitionName.str,
                          QContactNickname::FieldNickname.str},
        {"X-SIP",         QContactOnlineAccount::DefinitionName.str,
                          ""},
        {"X-SPOUSE",      QContactFamily::DefinitionName.str,
                          QContactFamily::FieldSpouse.str}
    };

vCard type parameters are mapped to subtypes in QContactDetails as follows:

    // Mappings from versit TYPE parameters to Qt contact detail subtypes
    const versitMapping versitSubTypeMappings[] = {
        {"DOM",    QContactAddress::SubTypeDomestic.str},
        {"INTL",   QContactAddress::SubTypeInternational.str},
        {"POSTAL", QContactAddress::SubTypePostal.str},
        {"PARCEL", QContactAddress::SubTypeParcel.str},
        {"VOICE",  QContactPhoneNumber::SubTypeVoice.str},
        {"CELL",   QContactPhoneNumber::SubTypeMobile.str},
        {"MODEM",  QContactPhoneNumber::SubTypeModem.str},
        {"CAR",    QContactPhoneNumber::SubTypeCar.str},
        {"VIDEO",  QContactPhoneNumber::SubTypeVideo.str},
        {"FAX",    QContactPhoneNumber::SubTypeFacsimile.str},
        {"BBS",    QContactPhoneNumber::SubTypeBulletinBoardSystem.str},
        {"PAGER",  QContactPhoneNumber::SubTypePager.str},
        {"SWIS",   QContactOnlineAccount::SubTypeVideoShare.str},
        {"VOIP",   QContactOnlineAccount::SubTypeSipVoip.str}
    };

File extensions in vCards are mapped to the file system file extensions as follows:

    // Mappings from file types in versit specifications to file extensions
    const versitMapping versitFileExtensionMappings[] = {
        {"JPEG", "JPG"},
        {"WAVE", "WAV"},
        {"PICT", "PCT"},
        {"TIFF", "TIF"},
        {"MPEG", "MPG"},
        {"MPEG2", "M2P"},
        {"QTIME", "QT"},
        {"AIFF", "AIF"},
        {"GIF", "GIF"}
    };