/****************************************************************************

**

** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).

** All rights reserved.

** Contact: Nokia Corporation (qt-info@nokia.com)

**

** This file is part of the Qt Mobility Components.

**

** $QT_BEGIN_LICENSE:LGPL$

** No Commercial Usage

** This file contains pre-release code and may not be distributed.

** You may use this file in accordance with the terms and conditions

** contained in the Technology Preview License Agreement accompanying

** this package.

**

** GNU Lesser General Public License Usage

** Alternatively, this file may be used under the terms of the GNU Lesser

** General Public License version 2.1 as published by the Free Software

** Foundation and appearing in the file LICENSE.LGPL included in the

** packaging of this file.  Please review the following information to

** ensure the GNU Lesser General Public License version 2.1 requirements

** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

**

** In addition, as a special exception, Nokia gives you certain additional

** rights.  These rights are described in the Nokia Qt LGPL Exception

** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

**

** If you have questions regarding the use of this file, please contact

** Nokia at qt-info@nokia.com.

**

**

**

**

**

**

**

**

** $QT_END_LICENSE$

**

****************************************************************************/

#include <QByteArray>

#include <QUrl>

#include <QFile>

#include <QPixmap>

#include <QImage>

#include "qcontactmanager.h"

#include "qtcontacts.h"

#include "qcontactdetails.h"

QTM_BEGIN_NAMESPACE

/* template docs:

   XXXX::FieldYYYY:

       The field key constant for the YYYY value.

       \sa yyyy(), setYyyy()

   XXXX::DefinitionName:

        The string constant for the definition name of QContactXXXX details.

   XXXX::FieldSubType

        The field key constant for the field that stores the sub type of a XXXX.

        \sa subType(), setSubType()

   XXXX::SubTypeYYYY

        The predefined string constant for a sub type value,

        indicating blah blah blah.

        \sa subTypes(), setSubTypes()

 */

/* ==================== QContactSyncTarget ======================= */

/*!

   \class QContactSyncTarget

   \brief The QContactSyncTarget class provides a sync target

   for a contact.

   \ingroup contacts-details

 */

/*!

    \variable QContactSyncTarget::DefinitionName

    The string constant for the definition name of QContactSyncTarget details.

*/

Q_DEFINE_LATIN1_CONSTANT(QContactSyncTarget::DefinitionName, "SyncTarget");

/*!

    \variable QContactSyncTarget::FieldSyncTarget

   The field key constant for the sync target value.

   \sa syncTarget(), setSyncTarget()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactSyncTarget::FieldSyncTarget, "SyncTarget");

/*!

   \fn QContactSyncTarget::syncTarget() const

   Returns the identifier of the backend store to which the contact

   containing this detail should be synchronized.

 */

/*!

   \fn QContactSyncTarget::setSyncTarget(const QString& syncTarget)

   Sets the identifier of the backend store to which the contact

   containing this detail should be synchronized to \a syncTarget.

 */

/* ==================== QContactEmailAddress ======================= */

/*!

   \class QContactEmailAddress

   \brief The QContactEmailAddress class contains an email address of

   a contact.

   \ingroup contacts-details

 */

/*!

   \variable QContactEmailAddress::DefinitionName

   The string constant for the definition name of QContactEmailAddress details.

 */

Q_DEFINE_LATIN1_CONSTANT(QContactEmailAddress::DefinitionName, "EmailAddress");

/*!

   \variable QContactEmailAddress::FieldEmailAddress

   The field key constant for the email address value.

   \sa emailAddress(), setEmailAddress()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactEmailAddress::FieldEmailAddress, "EmailAddress");

/*!

   \fn QContactEmailAddress::emailAddress() const

   Returns the email address of the contact which is stored in this detail.

 */

/*!

   \fn QContactEmailAddress::setEmailAddress(const QString& emailAddress)

   Sets the email address of the contact which is stored in this detail to \a emailAddress.

 */

/* ==================== QContactFamily ======================= */

/*!

   \class QContactFamily

   \brief The QContactFamily class contains names of

   family members of a contact.

   \ingroup contacts-details

 */

/*!

   \variable QContactFamily::DefinitionName

   The string constant for the definition name of QContactFamily details.

 */

Q_DEFINE_LATIN1_CONSTANT(QContactFamily::DefinitionName, "Family");

/*!

   \variable QContactFamily::FieldSpouse

   The field key constant for the value containing the name of a spouse.

   \sa spouse(), setSpouse()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactFamily::FieldSpouse, "Spouse");

/*!

   \variable QContactFamily::FieldChildren

   The field key constant for the value containing the names of children.

   \sa children(), setChildren()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactFamily::FieldChildren, "Children");

/*!

   \fn QContactFamily::spouse() const

   Returns the name of the spouse of the contact which is stored in this detail.

 */

/*!

   \fn QContactFamily::setSpouse(const QString& spouseName)

   Sets the name of the spouse of the contact which is stored in this detail to \a spouseName.

 */

/*!

   \fn QContactFamily::children() const

   Returns the names of the children of the contact which is stored in this detail.

 */

/*!

   \fn QContactFamily::setChildren(const QStringList& childrenNames)

   Sets the names of the children of the contact which is stored in this detail to \a childrenNames.

 */

/* ==================== QContactAnniversary ======================= */

/*!

   \class QContactAnniversary

   \brief The QContactAnniversary class contains an anniversary of a contact.

   \ingroup contacts-details

 */

/*!

   \variable QContactAnniversary::DefinitionName

   The string constant for the definition name of QContactAnniversary details.

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAnniversary::DefinitionName, "Anniversary");

/*!

   \variable QContactAnniversary::FieldOriginalDate

   The field key constant for the original anniversary date value.

   \sa originalDate(), setOriginalDate()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAnniversary::FieldOriginalDate, "OriginalDate");

/*!

   \variable QContactAnniversary::FieldEvent

   The field key constant for the name of the event value.

   \sa event(), setEvent()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAnniversary::FieldEvent, "Event");

/*!

   \variable QContactAnniversary::FieldCalendarId

   The field key constant for the value containing the id of the calendar event.

   \sa calendarId(), setCalendarId()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAnniversary::FieldCalendarId, "CalendarId");

/*!

   \variable QContactAnniversary::FieldSubType

   The field key constant for the field that stores the sub type of a QContactAnniversary.

   \sa subType(), setSubType()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAnniversary::FieldSubType, "SubType");

/*!

   \variable QContactAnniversary::SubTypeWedding

    The predefined string constant for a sub type value,

    indicating this anniversary is a wedding anniversary.

    \sa subType(), setSubType()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAnniversary::SubTypeWedding, "Wedding");

/*!

   \variable QContactAnniversary::SubTypeEngagement

    The predefined string constant for a sub type value,

    indicating this anniversary is the anniversary of an engagement.

    \sa subType(), setSubType()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAnniversary::SubTypeEngagement, "Engagement");

/*!

   \variable QContactAnniversary::SubTypeHouse

   \internal

    The predefined string constant for a sub type value,

    indicating this anniversary is the anniversary of a new residence.

    \sa subType(), setSubType()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAnniversary::SubTypeHouse, "House");

/*!

   \variable QContactAnniversary::SubTypeEmployment

    The predefined string constant for a sub type value,

    indicating this anniversary is the anniversary of a start of

    employment.

    \sa subType(), setSubType()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAnniversary::SubTypeEmployment, "Employment");

/*!

   \variable QContactAnniversary::SubTypeMemorial

    The predefined string constant for a sub type value,

    indicating this anniversary is an anniversary of an event of sentimental significance.

    \sa subType(), setSubType()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAnniversary::SubTypeMemorial, "Memorial");

/*!

   \fn QContactAnniversary::originalDate() const

   Returns the original date of occurrence of the event stored in this detail.

 */

/*!

   \fn QContactAnniversary::setOriginalDate(const QDate& date)

   Sets the original date of occurrence of the event stored in this detail to \a date.

 */

/*!

   \fn QContactAnniversary::calendarId() const

 * Returns the identifier of the calendar entry associated with this anniversary.

 */

/*!

   \fn QContactAnniversary::setCalendarId(const QString& calendarId)

   Sets the identifier of the calendar entry associated with this anniversary to \a calendarId.

 */

/*!

   \fn QContactAnniversary::event() const

   Returns the name of the event for which this detail contains information.

 */

/*!

   \fn QContactAnniversary::setEvent(const QString& event)

   Sets the name of the event for which this detail contains information to \a event.

 */

/*!

   \fn QContactAnniversary::setSubType(const QString& subType)

   Sets the subtype which this detail implements to be the given \a subType.

 */

/*!

   \fn QContactAnniversary::subType() const

   Returns the subtype that this detail implements, if defined.

 */

/* ==================== QContactAvatar ======================= */

/*!

   \class QContactAvatar

   \brief The QContactAvatar class contains the avatar of a contact.

   \ingroup contacts-details

 */

/*!

   \variable QContactAvatar::DefinitionName

   The string constant for the definition name of QContactAvatar details.

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAvatar::DefinitionName, "Avatar");

/*!

   \variable QContactAvatar::FieldImageUrl

   The field key constant for the value containing the URL of the avatar image.

   \sa imageUrl(), setImageUrl()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAvatar::FieldImageUrl, "ImageUrl");

/*!

   \variable QContactAvatar::FieldVideoUrl

   The field key constant for the value containing the URL of a video avatar.

   \sa videoUrl(), setVideoUrl()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAvatar::FieldVideoUrl, "VideoUrl");

/*!

  \fn QContactAvatar::imageUrl() const

  Returns the url of an avatar image associated with the contact

 */

/*!

  \fn QContactAvatar::setImageUrl(const QUrl& imageUrl)

  Sets the url of an avatar image associated with the contact to \a imageUrl

 */

/*!

  \fn QContactAvatar::videoUrl() const

  Returns the url of an avatar video associated with the contact

 */

/*!

  \fn QContactAvatar::setVideoUrl(const QUrl& videoUrl)

  Sets the url of an avatar video associated with the contact to \a videoUrl

 */

/* ==================== QContactAddress ======================= */

// XXX TODO - explain the different segments and their typical mapping

/*!

   \class QContactAddress

   \brief The QContactAddress class contains an address of a contact.

   \ingroup contacts-details

 */

/*!

   \variable QContactAddress::DefinitionName

   The string constant for the definition name of QContactAddress details.

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAddress::DefinitionName, "Address");

/*!

   \variable QContactAddress::FieldStreet

   The field key constant for the value containing the street segment.

   \sa street(), setStreet()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAddress::FieldStreet, "Street");

/*!

   \variable QContactAddress::FieldLocality

   The field key constant for the value containing the locality segment.

   \sa locality(), setLocality()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAddress::FieldLocality, "Locality");

/*!

   \variable QContactAddress::FieldRegion

   The field key constant for the value containing the region segment.

   \sa region(), setRegion()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAddress::FieldRegion, "Region");

/*!

   \variable QContactAddress::FieldPostcode

   The field key constant for the value containing the postcode segment.

   \sa postcode(), setPostcode()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAddress::FieldPostcode, "Postcode");

/*!

   \variable QContactAddress::FieldCountry

   The field key constant for the value containing the country segment.

   \sa country(), setCountry()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAddress::FieldCountry, "Country");

/*!

   \variable QContactAddress::FieldPostOfficeBox

   The field key constant for the value containing the post office box segment.

   \sa postOfficeBox(), setPostOfficeBox()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAddress::FieldPostOfficeBox, "PostOfficeBox");

/*!

   \variable QContactAddress::FieldSubTypes

   The field key constant for the field that stores the sub types of a QContactAddress.

   \sa subTypes(), setSubTypes()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAddress::FieldSubTypes, "SubTypes");

/*!

   \variable QContactAddress::SubTypeParcel

    The predefined string constant for a sub type value,

    indicating this address is an address for parcel delivery.

    \sa subTypes(), setSubTypes()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAddress::SubTypeParcel, "Parcel");

/*!

   \variable QContactAddress::SubTypePostal

    The predefined string constant for a sub type value,

    indicating this address is an address for postal delivery.

    \sa subTypes(), setSubTypes()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAddress::SubTypePostal, "Postal");

/*!

   \variable QContactAddress::SubTypeDomestic

    The predefined string constant for a sub type value,

    indicating this address is an address for domestic mail delivery.

    \sa subTypes(), setSubTypes()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAddress::SubTypeDomestic, "Domestic");

/*!

   \variable QContactAddress::SubTypeInternational

    The predefined string constant for a sub type value,

    indicating this address is an address for international mail delivery.

    \sa subTypes(), setSubTypes()

 */

Q_DEFINE_LATIN1_CONSTANT(QContactAddress::SubTypeInternational, "International");

/*!

   \fn QContactAddress::postOfficeBox() const

   Returns the post office box segment of the address stored in this detail.

 */

/*!

   \fn QContactAddress::setPostOfficeBox(const QString& postOfficeBox)

   Sets the post office box segment of the address stored in this detail to \a postOfficeBox.

 */

/*!

   \fn QContactAddress::street() const

   Returns the street segment of the address stored in this detail.

 */

/*!

   \fn QContactAddress::setStreet(const QString& street)

   Sets the street segment of the address stored in this detail to \a street.

 */

/*!

   \fn QContactAddress::locality() const

   Returns the locality segment of the address stored in this detail.

 */

/*!

   \fn QContactAddress::setLocality(const QString& locality)

   Sets the locality segment of the address stored in this detail to \a locality.

 */

/*!

   \fn QContactAddress::region() const

   Returns the region segment of the address stored in this detail.

 */

/*!

   \fn QContactAddress::setRegion(const QString& region)

   Sets the region segment of the address stored in this detail to \a region.

 */

/*!

   \fn QContactAddress::postcode() const