/****************************************************************************
**
** Copyright (C) 2009 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
/*!
\class QContactAddress
\brief The QContactAddress class contains an address of a contact.
\ingroup contacts-details
*/
/*!
\class QContactAnniversary
\brief The QContactAnniversary class contains the anniversary of a contact.
\ingroup contacts-details
*/
/*!
\class QContactAvatar
\brief The QContactAvatar class contains the avatar of a contact.
\ingroup contacts-details
*/
/*!
\class QContactBirthday
\brief The QContactBirthday class contains the birthday of a contact.
\ingroup contacts-details
*/
/*!
\class QContactDisplayLabel
\brief The QContactDisplayLabel class is the (possibly synthesized)
display label of a contact.
\ingroup contacts-details
*/
/*!
\class QContactEmailAddress
\brief The QContactEmailAddress class contains the email address of
a contact.
\ingroup contacts-details
*/
/*!
\class QContactFamily
\brief The QContactFamily class contains the names of the
family members of a contact.
\ingroup contacts-details
*/
/*!
\class QContactGender
\brief The QContactGender class contains the gender of a contact.
\ingroup contacts-details
*/
/*!
\class QContactGeoLocation
\brief The QContactGeoLocation class contains the global location
coordinate associated with a contact.
\ingroup contacts-details
*/
/*!
\class QContactGuid
\brief The QContactGuid class contains the globally unique
Id of a contact.
\ingroup contacts-details
*/
/*!
\class QContactName
\brief The QContactName class contains the name of a contact.
\ingroup contacts-details
*/
/*!
\class QContactNickname
\brief The QContactNickname class contains a nickname of a contact.
\ingroup contacts-details
*/
/*!
\class QContactNote
\brief The QContactNote class contains a note associated
with a contact.
\ingroup contacts-details
*/
/*!
\class QContactOnlineAccount
\brief The QContactOnlineAccount class provides the online account,
which the contact uses to communicate with friends and family.
\ingroup contacts-details
*/
/*!
\class QContactOrganization
\brief The QContactOrganization class provides details about an
organization that the contact is either a part of, or stands for.
\ingroup contacts-details
*/
/*!
\class QContactPhoneNumber
\brief The QContactPhoneNumber class provides a phone number
of a contact.
\ingroup contacts-details
*/
/*!
\class QContactSyncTarget
\brief The QContactSyncTarget class provides a sync target
for a contact.
\ingroup contacts-details
*/
/*!
\class QContactTimestamp
\brief The QContactTimestamp class contains the creation and
last-modified timestamp associated with the contact.
\ingroup contacts-details
*/
/*!
\class QContactType
\brief The QContactType class describes the type of the contact.
\ingroup contacts-details
*/
/*!
\class QContactUrl
\brief The QContactUrl class contains a url associated with
a contact.
\ingroup contacts-details
*/
/*!
\variable QContactName::DefinitionName
The constant string which identifies the definition of details which are names.
*/
Q_DEFINE_LATIN1_LITERAL(QContactName::DefinitionName, "Name");
/*!
\variable QContactNickname::DefinitionName
The constant string which identifies the definition of details which are nicknames.
*/
Q_DEFINE_LATIN1_LITERAL(QContactNickname::DefinitionName, "Nickname");
/*!
\variable QContactNote::DefinitionName
The constant string which identifies the definition of details which are notes.
*/
Q_DEFINE_LATIN1_LITERAL(QContactNote::DefinitionName, "Note");
/*!
\variable QContactAvatar::DefinitionName
The constant string which identifies the definition of details which are avatars.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAvatar::DefinitionName, "Avatar");
/*!
\variable QContactAddress::DefinitionName
The constant string which identifies the definition of details which are street addresses.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAddress::DefinitionName, "StreetAddress");
/*!
\variable QContactPhoneNumber::DefinitionName
The constant string which identifies the definition of details which are phone numbers.
*/
Q_DEFINE_LATIN1_LITERAL(QContactPhoneNumber::DefinitionName, "PhoneNumber");
/*!
\variable QContactSyncTarget::DefinitionName
The constant string which identifies the definition of details which are synchronisation target stores.
*/
Q_DEFINE_LATIN1_LITERAL(QContactSyncTarget::DefinitionName, "SyncTarget");
/*!
\variable QContactTimestamp::DefinitionName
The constant string which identifies the definition of details which are contact synchronisation timestamps.
*/
Q_DEFINE_LATIN1_LITERAL(QContactTimestamp::DefinitionName, "Timestamp");
/*!
\variable QContactType::DefinitionName
The constant string which identifies the definition of details which identify the type of the contact.
*/
Q_DEFINE_LATIN1_LITERAL(QContactType::DefinitionName, "Type");
/*!
\variable QContactGuid::DefinitionName
The constant string which identifies the definition of details which are globally unique identifiers.
*/
Q_DEFINE_LATIN1_LITERAL(QContactGuid::DefinitionName, "Guid");
/*!
\variable QContactEmailAddress::DefinitionName
The constant string which identifies the definition of details which are email addresses.
*/
Q_DEFINE_LATIN1_LITERAL(QContactEmailAddress::DefinitionName, "EmailAddress");
/*!
\variable QContactFamily::DefinitionName
The constant string which identifies the definition of details which contain the names of the contact's family.
*/
Q_DEFINE_LATIN1_LITERAL(QContactFamily::DefinitionName, "Family");
/*!
\variable QContactUrl::DefinitionName
The constant string which identifies the definition of details which are universal resource location paths.
*/
Q_DEFINE_LATIN1_LITERAL(QContactUrl::DefinitionName, "Url");
/*!
\variable QContactBirthday::DefinitionName
The constant string which identifies the definition of details which are the dates of birthdays.
*/
Q_DEFINE_LATIN1_LITERAL(QContactBirthday::DefinitionName, "Birthday");
/*!
\variable QContactAnniversary::DefinitionName
The constant string which identifies the definition of details which are anniversary dates.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAnniversary::DefinitionName, "Anniversary");
/*!
\variable QContactGender::DefinitionName
The constant string which identifies the definition of details
which identify the gender of a contact in a given context.
*/
Q_DEFINE_LATIN1_LITERAL(QContactGender::DefinitionName, "Gender");
/*!
\variable QContactGeoLocation::DefinitionName
The constant string which identifies the definition of details
which describe a location associated with a contact.
*/
Q_DEFINE_LATIN1_LITERAL(QContactGeoLocation::DefinitionName, "GeoLocation");
/*!
\variable QContactOnlineAccount::DefinitionName
The constant string which identifies the definition of details
which identify the organization to which a contact belongs in a
given context.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::DefinitionName, "OnlineAccount");
/*!
\variable QContactOnlineAccount::FieldNickname
The constant key for which the nickname value is stored in details
of the QContactOnlineAccount type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::FieldNickname, "Nickname");
/*!
\variable QContactOnlineAccount::FieldPresence
The constant key for which the presence value is stored in details
of the QContactOnlineAccount typel.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::FieldPresence, "Presence");
/*!
\variable QContactOnlineAccount::PresenceAvailable
The value for presence which specifies that the contact's current
status is available.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::PresenceAvailable, "Available");
/*!
\variable QContactOnlineAccount::PresenceHidden
The value for presence which specifies that the contact's current.
status is hidden
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::PresenceHidden, "Hidden");
/*!
\variable QContactOnlineAccount::PresenceBusy
The value for presence which specifies that the contact's current status is busy.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::PresenceBusy, "Busy");
/*!
\variable QContactOnlineAccount::PresenceAway
The value for presence which specifies that the contact's current status is away.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::PresenceAway, "Away");
/*!
\variable QContactOnlineAccount::PresenceExtendedAway
The value for presence which specifies that the contact's current status is extended away.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::PresenceExtendedAway, "ExtendedAway");
/*!
\variable QContactOnlineAccount::PresenceUnknown
The value for presence which specifies that the contact's current status is unknown.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::PresenceUnknown, "Unknown");
/*!
\variable QContactOnlineAccount::PresenceOffline
The value for presence which specifies that the contact's current status is offline.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::PresenceOffline, "Offline");
/*!
\variable QContactOnlineAccount::FieldStatusMessage
The constant key for which the status message value is stored in
details of the QContactOnlineAccount type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::FieldStatusMessage, "StatusMessage");
/*!
\variable QContactOnlineAccount::FieldCapabilities
The constant key for which the account capabilities value is stored in
details of the QContactOnlineAccount type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::FieldCapabilities, "Capabilities");
/*!
\variable QContactOrganization::DefinitionName
The constant string which identifies the definition of details
which identify the organization to which a contact belongs in a
given context.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOrganization::DefinitionName, "Organization");
/*!
\variable QContactDisplayLabel::DefinitionName
The constant string which identifies the definition of details
which contain a display label of a contact.
*/
Q_DEFINE_LATIN1_LITERAL(QContactDisplayLabel::DefinitionName, "DisplayLabel");
/*!
\variable QContactPhoneNumber::FieldNumber
The constant key for which the phone number value is stored in
details of the QContactPhoneNumber type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactPhoneNumber::FieldNumber, "PhoneNumber");
/*!
\variable QContactPhoneNumber::FieldSubTypes
The constant key for which the subtype values are stored in details
of the QContactPhoneNumber type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactPhoneNumber::FieldSubTypes, "SubTypes");
/*!
\variable QContactEmailAddress::FieldEmailAddress
The constant key for which the email address value is stored in
details of the QContactEmailAddress type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactEmailAddress::FieldEmailAddress, "EmailAddress");
/*!
\variable QContactFamily::FieldSpouse
The constant key for which the spouse name value is stored in
details of the QContactFamily type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactFamily::FieldSpouse, "Spouse");
/*!
\variable QContactFamily::FieldChildren
The constant key for which the children names value is stored in
details of the QContactFamily type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactFamily::FieldChildren, "Children");
/*!
\variable QContactGuid::FieldGuid
The constant key for which the globally unique identifier value is
stored in details of the QContactGuid type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactGuid::FieldGuid, "Guid");
/*!
\variable QContactSyncTarget::FieldSyncTarget
The constant key for which the value of the target store for
synchronisation is stored in details of the QContactSyncTarget type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactSyncTarget::FieldSyncTarget, "SyncTarget");
/*!
\variable QContactAvatar::FieldAvatar
The constant key for which the path the avatar value is stored in
details of the QContactAvatar type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAvatar::FieldAvatar, "Avatar");
/*!
\variable QContactAvatar::FieldAvatarPixmap
The constant key for which the path the avatar value is stored in
details of the QContactAvatar type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAvatar::FieldAvatarPixmap, "AvatarPixmap");
/*!
\variable QContactAvatar::FieldSubType
The constant key for which the subtypes value is stored in details
of the QContactAvatar type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAvatar::FieldSubType, "SubType");
/*!
\variable QContactName::FieldPrefix
The constant key for which the name prefix value is stored in
details of the QContactName type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactName::FieldPrefix, "Prefix");
/*!
\variable QContactName::FieldFirstName
The constant key for which the first name value is stored in
details of the QContactName type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactName::FieldFirstName, "FirstName");
/*!
\variable QContactName::FieldMiddleName
The constant key for which the middle name value is stored in
details of the QContactName type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactName::FieldMiddleName, "MiddleName");
/*!
\variable QContactName::FieldLastName
The constant key for which the last name value is stored in details
of the QContactName type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactName::FieldLastName, "LastName");
/*!
\variable QContactName::FieldFirst
The constant key for which the first name value is stored in
details of the QContactName type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactName::FieldFirst, "FirstName");
/*!
\variable QContactName::FieldMiddle
The constant key for which the middle name value is stored in
details of the QContactName type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactName::FieldMiddle, "MiddleName");
/*!
\variable QContactName::FieldLast
The constant key for which the last name value is stored in details
of the QContactName type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactName::FieldLast, "LastName");
/*!
\variable QContactName::FieldSuffix
The constant key for which the name suffix value is stored in
details of the QContactName type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactName::FieldSuffix, "Suffix");
/*!
\variable QContactName::FieldCustomLabel
The constant key for which the custom name label value is stored in
details of the QContactName type, if supported.
*/
Q_DEFINE_LATIN1_LITERAL(QContactName::FieldCustomLabel, "CustomLabel");
/*!
\variable QContactNickname::FieldNickname
The constant key for which the nickname value is stored in details
of the QContactNickname type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactNickname::FieldNickname, "Nickname");
/*!
\variable QContactNote::FieldNote
The constant key for which the note value is stored in details of
the QContactNote type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactNote::FieldNote, "Note");
/*!
\variable QContactAddress::FieldStreet
The constant key for which the street value is stored in details of
the QContactAddress type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAddress::FieldStreet, "Street");
/*!
\variable QContactAddress::FieldLocality
The constant key for which the locality value is stored in details
of the QContactAddress type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAddress::FieldLocality, "Locality");
/*!
\variable QContactAddress::FieldRegion
The constant key for which the region value is stored in details of
the QContactAddress type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAddress::FieldRegion, "Region");
/*!
\variable QContactAddress::FieldPostcode
The constant key for which the postcode value is stored in details
of the QContactAddress type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAddress::FieldPostcode, "Postcode");
/*!
\variable QContactAddress::FieldCountry
The constant key for which the country value is stored in details
of the QContactAddress type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAddress::FieldCountry, "Country");
/*!
\variable QContactAddress::FieldPostOfficeBox
The constant key for which the post office box value is stored in
details of the QContactAddress type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAddress::FieldPostOfficeBox, "PostOfficeBox");
/*!
\variable QContactAddress::FieldSubTypes
The constant key for which the subtypes value is stored in details
of the QContactAddress type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAddress::FieldSubTypes, "SubTypes");
/*!
\variable QContactUrl::FieldUrl
The constant key for which the url value is stored in details of
the QContactUrl type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactUrl::FieldUrl, "Url");
/*!
\variable QContactUrl::FieldSubType
The constant key for which the subtypes value is stored in details
of the QContactUrl type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactUrl::FieldSubType, "SubType");
/*!
\variable QContactBirthday::FieldBirthday
The constant key for which the birthday date value is stored in
details of the QContactBirthday type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactBirthday::FieldBirthday, "Birthday");
/*!
\variable QContactAnniversary::FieldOriginalDate
The constant key for which the anniversary original event date
value is stored in details of the QContactAnniversary type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAnniversary::FieldOriginalDate, "OriginalDate");
/*!
\variable QContactAnniversary::FieldEvent
The constant key for which the name of the event is stored in
details of the QContactAnniversary type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAnniversary::FieldEvent, "Event");
/*!
\variable QContactAnniversary::FieldCalendarId
The constant key for which the value of the identifier of the
associated calendar entry is stored in details of the
QContactAnniversary type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAnniversary::FieldCalendarId, "CalendarId");
/*!
\variable QContactAnniversary::FieldSubType
The constant key for which the subtypes value is stored in details
of the QContactAnniversary type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAnniversary::FieldSubType, "SubType");
/*!
\variable QContactGender::FieldGender
The constant key for which the gender value is stored in details of
the QContactGender type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactGender::FieldGender, "Gender");
/*!
\variable QContactGender::GenderMale
The value that identifies this contact as being male.
*/
Q_DEFINE_LATIN1_LITERAL(QContactGender::GenderMale, "Male");
/*!
\variable QContactGender::GenderFemale
The value that identifies this contact as being female.
*/
Q_DEFINE_LATIN1_LITERAL(QContactGender::GenderFemale, "Female");
/*!
\variable QContactGender::GenderUnspecified
The value that identifies this contact as being of unspecified gender.
*/
Q_DEFINE_LATIN1_LITERAL(QContactGender::GenderUnspecified, "Unspecified");
/*!
\variable QContactGeoLocation::FieldLabel
The constant key for which the location label value is stored in
details of the QContactGeoLocation type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactGeoLocation::FieldLabel, "Label");
/*!
\variable QContactGeoLocation::FieldLatitude
The constant key for which the latitude value is stored in details
of the QContactGeoLocation type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactGeoLocation::FieldLatitude, "Latitude");
/*!
\variable QContactGeoLocation::FieldLongitude
The constant key for which the longitude value is stored in details
of the QContactGeoLocation type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactGeoLocation::FieldLongitude, "Longitude");
/*!
\variable QContactGeoLocation::FieldAccuracy
The constant key for which the location accuracy value is stored in
details of the QContactGeoLocation type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactGeoLocation::FieldAccuracy, "Accuracy");
/*!
\variable QContactGeoLocation::FieldAltitude
The constant key for which the altitude value is stored in details
of the QContactGeoLocation type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactGeoLocation::FieldAltitude, "Altitude");
/*!
\variable QContactGeoLocation::FieldAltitudeAccuracy
The constant key for which the altitude accuracy value is stored in
details of the QContactGeoLocation type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactGeoLocation::FieldAltitudeAccuracy, "AltitudeAccuracy");
/*!
\variable QContactGeoLocation::FieldHeading
The constant key for which the heading value is stored in details
of the QContactGeoLocation type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactGeoLocation::FieldHeading, "Heading");
/*!
\variable QContactGeoLocation::FieldSpeed
The constant key for which the speed value is stored in details of
the QContactGeoLocation type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactGeoLocation::FieldSpeed, "Speed");
/*!
\variable QContactGeoLocation::FieldTimestamp
The constant key for which the timestamp value is stored in details
of the QContactGeoLocation type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactGeoLocation::FieldTimestamp, "Timestamp");
/*!
\variable QContactOnlineAccount::FieldAccountUri
The constant key for which the remote account uri value is stored
in details of the QContactOnlineAccount type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::FieldAccountUri, "AccountUri");
/*!
\variable QContactOnlineAccount::FieldServiceProvider
The constant key for which the service provider value is stored in
details of the QContactOnlineAccount type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::FieldServiceProvider, "ServiceProvider");
/*!
\variable QContactOnlineAccount::FieldSubTypes
The constant key for which the subtypes value is stored in details
of the QContactOnlineAccount type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::FieldSubTypes, "SubTypes");
/*!
\variable QContactOnlineAccount::SubTypeSip
The constant attribute value which describes the online account as
supporting SIP.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::SubTypeSip, "Sip");
/*!
\variable QContactOnlineAccount::SubTypeSipVoip
The constant attribute value which describes the online account as
supporting SIP-based VoIP.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::SubTypeSipVoip, "SipVoip");
/*!
\variable QContactOnlineAccount::SubTypeImpp
The constant attribute value which describes the online account as
supporting IMPP.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::SubTypeImpp, "Impp");
/*!
\variable QContactOnlineAccount::SubTypeVideoShare
The constant attribute value which describes the online account as
supporting VideoShare.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOnlineAccount::SubTypeVideoShare, "VideoShare");
/*!
\variable QContactOrganization::FieldName
The constant key for which the name value is stored in details of
the QContactOrganization type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOrganization::FieldName, "Name");
/*!
\variable QContactOrganization::FieldLogo
The constant key for which the logo path value is stored in details
of the QContactOrganization type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOrganization::FieldLogo, "Logo");
/*!
\variable QContactOrganization::FieldDepartment
The constant key for which the organization's department value is
stored in details of the QContactOrganization type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOrganization::FieldDepartment, "Department");
/*!
\variable QContactOrganization::FieldLocation
The constant key for which the organization's location (or the
location of the contact's part of the organization) value is stored
in details of the QContactOrganization type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOrganization::FieldLocation, "Location");
/*!
\variable QContactOrganization::FieldRole
The constant key for which the contact's role within the
organization is stored in details of the QContactOrganization type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOrganization::FieldRole, "Role");
/*!
\variable QContactOrganization::FieldTitle
The constant key for which the contact's title within the
organization is stored in details of the QContactOrganization type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOrganization::FieldTitle, "Title");
/*!
\variable QContactOrganization::FieldAssistantName
The constant key for which the contact's assistant name within the
organization is stored in details of the QContactOrganization type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactOrganization::FieldAssistantName, "AssistantName");
/*!
\variable QContactDisplayLabel::FieldLabel
The constant key for which the display label value is stored in
details of the QContactDisplayLabel type.
*/
Q_DEFINE_LATIN1_LITERAL(QContactDisplayLabel::FieldLabel, "Label");
/*!
\variable QContactTimestamp::FieldModificationTimestamp
The constant key for the value which is stored in details of the
QContactTimestamp type which describes the last modification date
and time of a contact.
*/
Q_DEFINE_LATIN1_LITERAL(QContactTimestamp::FieldModificationTimestamp, "ModificationTimestamp");
/*!
\variable QContactTimestamp::FieldCreationTimestamp
The constant key for the value which is stored in details of the
QContactTimestamp type which describes the creation date and time
of a contact.
*/
Q_DEFINE_LATIN1_LITERAL(QContactTimestamp::FieldCreationTimestamp, "CreationTimestamp");
/*!
\variable QContactType::FieldType
The constant key for the type value which is stored in details of
the QContactType definition.
*/
Q_DEFINE_LATIN1_LITERAL(QContactType::FieldType, "Type");
/*!
\variable QContactType::TypeContact
The constant attribute value which describes the contact as being
an ordinary contact.
*/
Q_DEFINE_LATIN1_LITERAL(QContactType::TypeContact, "Contact");
/*!
\variable QContactType::TypeGroup
The constant attribute value which describes the contact as being a
group.
*/
Q_DEFINE_LATIN1_LITERAL(QContactType::TypeGroup, "Group");
/*!
\variable QContactPhoneNumber::SubTypeLandline
The constant attribute value which describes the phone number as
identifying a landline phone.
*/
Q_DEFINE_LATIN1_LITERAL(QContactPhoneNumber::SubTypeLandline, "Landline");
/*!
\variable QContactPhoneNumber::SubTypeMobile
The constant attribute value which describes the phone number as
identifying a mobile phone.
*/
Q_DEFINE_LATIN1_LITERAL(QContactPhoneNumber::SubTypeMobile, "Mobile");
/*!
\variable QContactPhoneNumber::SubTypeFacsimile
The constant attribute value which describes the phone number as
identifying a facsimile machine.
*/
Q_DEFINE_LATIN1_LITERAL(QContactPhoneNumber::SubTypeFacsimile, "Facsimile");
/*!
\variable QContactPhoneNumber::SubTypePager
The constant attribute value which describes the phone number as
identifying a pager device.
*/
Q_DEFINE_LATIN1_LITERAL(QContactPhoneNumber::SubTypePager, "Pager");
/*!
\variable QContactPhoneNumber::SubTypeCar
The constant attribute value which describes the phone number as
identifying a car phone.
*/
Q_DEFINE_LATIN1_LITERAL(QContactPhoneNumber::SubTypeCar, "Car");
/*!
\variable QContactPhoneNumber::SubTypeBulletinBoardSystem
The constant attribute value which describes the phone number as
identifying a bulletin board system.
*/
Q_DEFINE_LATIN1_LITERAL(QContactPhoneNumber::SubTypeBulletinBoardSystem, "BulletinBoardSystem");
/*!
\variable QContactPhoneNumber::SubTypeVoice
The constant attribute value which describes the phone number as
supporting voice transmission.
*/
Q_DEFINE_LATIN1_LITERAL(QContactPhoneNumber::SubTypeVoice, "Voice");
/*!
\variable QContactPhoneNumber::SubTypeModem
The constant attribute value which describes the phone number as
supporting digital data transfer.
*/
Q_DEFINE_LATIN1_LITERAL(QContactPhoneNumber::SubTypeModem, "Modem");
/*!
\variable QContactPhoneNumber::SubTypeVideo
The constant attribute value which describes the phone number as
supporting video transmission.
*/
Q_DEFINE_LATIN1_LITERAL(QContactPhoneNumber::SubTypeVideo, "Video");
/*!
\variable QContactPhoneNumber::SubTypeMessagingCapable
The constant attribute value which describes the phone number as
supporting messaging services.
*/
Q_DEFINE_LATIN1_LITERAL(QContactPhoneNumber::SubTypeMessagingCapable, "MessagingCapable");
/*!
\variable QContactPhoneNumber::SubTypeAssistant
The constant attribute value which describes the phone number as an
assistant phone number.
*/
Q_DEFINE_LATIN1_LITERAL(QContactPhoneNumber::SubTypeAssistant, "Assistant");
/*!
\variable QContactPhoneNumber::SubTypeDtmfMenu
The constant attribute value which describes the phone number as
supporting DTMF-controlled electronic menu navigation.
*/
Q_DEFINE_LATIN1_LITERAL(QContactPhoneNumber::SubTypeDtmfMenu, "DtmfMenu");
/*!
\variable QContactAddress::SubTypeParcel
The constant attribute value which describes the address as being
an address for parcel delivery.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAddress::SubTypeParcel, "Parcel");
/*!
\variable QContactAddress::SubTypePostal
The constant attribute value which describes the address as being
an address for postal delivery.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAddress::SubTypePostal, "Postal");
/*!
\variable QContactAddress::SubTypeDomestic
The constant attribute value which describes the address as being a
domestic address.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAddress::SubTypeDomestic, "Domestic");
/*!
\variable QContactAddress::SubTypeInternational
The constant attribute value which describes the address as being
an international address.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAddress::SubTypeInternational, "International");
/*!
\variable QContactAvatar::SubTypeImage
The constant attribute value which describes the avatar as being an
image.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAvatar::SubTypeImage, "Image");
/*!
\variable QContactAvatar::SubTypeVideo
The constant attribute value which describes the avatar as being a
video.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAvatar::SubTypeVideo, "Video");
/*!
\variable QContactAvatar::SubTypeAudioRingtone
The constant attribute value which describes the avatar as being an
audio ringtone.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAvatar::SubTypeAudioRingtone, "AudioRingtone");
/*!
\variable QContactAvatar::SubTypeVideoRingtone
The constant attribute value which describes the avatar as being a
video ringtone.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAvatar::SubTypeVideoRingtone, "VideoRingtone");
/*!
\variable QContactAvatar::SubTypeTexturedMesh
The constant attribute value which describes the avatar as being a
textured, 3D mesh.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAvatar::SubTypeTexturedMesh, "TexturedMesh");
/*!
\variable QContactUrl::SubTypeHomePage
The constant attribute value which describes the url as being the
homepage of the contact.
*/
Q_DEFINE_LATIN1_LITERAL(QContactUrl::SubTypeHomePage, "HomePage");
/*!
\variable QContactUrl::SubTypeFavourite
The constant attribute value which describes the url as being a
favourite page of the contact.
*/
Q_DEFINE_LATIN1_LITERAL(QContactUrl::SubTypeFavourite, "Favourite");
/*!
\variable QContactAnniversary::SubTypeWedding
The constant attribute value which describes the anniversary as
being a wedding anniversary.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAnniversary::SubTypeWedding, "Wedding");
/*!
\variable QContactAnniversary::SubTypeEngagement
The constant attribute value which describes the anniversary as
being an engagement anniversary.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAnniversary::SubTypeEngagement, "Engagement");
/*!
\variable QContactAnniversary::SubTypeHouse
The constant attribute value which describes the anniversary as
being an anniversary of ownership of a particular residence.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAnniversary::SubTypeHouse, "House");
/*!
\variable QContactAnniversary::SubTypeEmployment
The constant attribute value which describes the anniversary as
being an anniversary of employment at a particular company.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAnniversary::SubTypeEmployment, "Employment");
/*!
\variable QContactAnniversary::SubTypeMemorial
The constant attribute value which describes the anniversary as
being an anniversary of an event of sentimental significance.
*/
Q_DEFINE_LATIN1_LITERAL(QContactAnniversary::SubTypeMemorial, "Memorial");
/*!
\fn QContactSyncTarget::syncTarget() const
Returns the identifier of the backend store to which the contact
containing this detail should be synchronised.
*/
/*!
\fn QContactSyncTarget::setSyncTarget(const QString& syncTarget)
Sets the identifier of the backend store to which the contact
containing this detail should be synchronised to \a syncTarget.
*/
/*!
\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.
*/
/*!
\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.
*/
/*!
\fn QContactAnniversary::originalDate() const
Returns the original date of occurrance of the event stored in this detail.
*/
/*!
\fn QContactAnniversary::setOriginalDate(const QDate& date)
Sets the original date of occurrance 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.
*/
/*!
\fn QContactAvatar::avatar() const
Returns the location of an avatar file associated with the contact.
*/
/*!
\fn QContactAvatar::setAvatar(const QString& avatar)
Sets the location of an avatar file associated with the contact to \a avatar.
*/
/*!
\fn QContactAvatar::pixmap() const
Returns a thumbnail for a picture associated with this contact.
*/
/*!
\fn QContactAvatar::setPixmap(const QPixmap& pixmap)
Sets the thumbnail of a picture avatar associated with the contact to \a pixmap.
If \a pixmap is empty, the thumbnail pixmap will be removed.
Returns true if the pixmap could be set, and false otherwise.
*/
/*!
\fn QContactAvatar::setSubType(const QString& subType)
Sets the subtype which this detail implements to be the given \a subType.
*/
/*!
\fn QContactAvatar::subType() const
Returns the subtype that this detail implements, if defined.
*/
/*!
\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
Returns the postcode segment of the address stored in this detail.
*/
/*!
\fn QContactAddress::setPostcode(const QString& postcode)
Sets the postcode segment of the address stored in this detail to \a postcode.
*/
/*!
\fn QContactAddress::country() const
Returns the country segment of the address stored in this detail.
*/
/*!
\fn QContactAddress::setCountry(const QString& country)
Sets the country segment of the address stored in this detail to \a country.
*/
/*!
\fn QContactAddress::setSubTypes(const QStringList& subTypes)
Sets the subtypes which this detail implements to be those contained in the list of given \a subTypes.
*/
/*!
\fn QContactAddress::setSubTypes(const QString& subType)
Sets the subtypes which this detail implements to be just the given \a subType.
*/
/*!
\fn QContactAddress::subTypes() const
Returns the list of subtypes that this detail implements.
*/
/*!
\fn QContactUrl::url() const
Returns the url stored in this detail.
*/
/*!
\fn QContactUrl::setUrl(const QString& url)
Sets the url stored in this detail to \a url.
*/
/*!
\fn QContactUrl::setSubType(const QString& subType)
Sets the subtype which this detail implements to be the given \a subType.
*/
/*!
\fn QContactUrl::subType() const
Returns the subtype that this detail implements, if defined.
*/
/*!
\fn QContactPhoneNumber::number() const
Returns the phone number stored in this detail.
*/
/*!
\fn QContactPhoneNumber::setNumber(const QString& number)
Sets the phone number stored in this detail to \a number.
*/
/*!
\fn QContactPhoneNumber::setSubTypes(const QStringList& subTypes)
Sets the subtypes which this detail implements to be those contained in the list of given \a subTypes
*/
/*!
\fn QContactPhoneNumber::setSubTypes(const QString& subType)
Sets the subtypes which this detail implements to be just the given \a subType.
*/
/*!
\fn QContactPhoneNumber::subTypes() const
Returns the list of subtypes that this detail implements.
*/
/*!
\fn QContactBirthday::date() const
Returns the date of the birthday which is stored in this detail.
*/
/*!
\fn QContactBirthday::setDate(const QDate& date)
Sets the date of the birthday which is stored in this detail to \a date.
*/
/*!
\fn QContactGender::gender() const
Returns the gender of the contact, as stored in this detail. The
possible values for the value stored are "Male", "Female" and
"Unspecified".
*/
/*!
\fn QContactGender::setGender(const QString& gender)
Sets the gender of the contact (as stored in this detail) to \a
gender, if \a gender is either "Male" or "Female", otherwise sets
it to "Unspecified".
*/
/*!
\fn QContactGeoLocation::setLabel(const QString& label)
Sets the label of the location stored in the detail to \a label.
*/
/*!
\fn QContactGeoLocation::label() const
Returns the label of the location stored in the detail.
*/
/*!
\fn QContactGeoLocation::setLatitude(double latitude)
Sets the latitude portion of the coordinate (in decimal degrees) of
the location stored in the detail to \a latitude.
*/
/*!
\fn QContactGeoLocation::latitude() const
Returns the latitude portion of the coordinate (specified in
decimal degrees) of the location stored in the detail.
*/
/*!
\fn QContactGeoLocation::setLongitude(double longitude)
Sets the longitude portion of the coordinate (in decimal degrees)
of the location stored in the detail to \a longitude.
*/
/*!
\fn QContactGeoLocation::longitude() const
Returns the longitude portion of the coordinate (specified in
decimal degrees) of the location stored in the detail.
*/
/*!
\fn QContactGeoLocation::setAccuracy(double accuracy)
Specifies that the latitude and longitude portions of the location
stored in the detail are accurate to within \a accuracy metres.
*/
/*!
\fn QContactGeoLocation::accuracy() const
Returns the accuracy (in metres) of the latitude and longitude of
the location stored in the detail.
*/
/*!
\fn QContactGeoLocation::setAltitude(double altitude)
Sets the altitude portion of the coordinate (in metres above the
ellipsoid) of the location stored in the detail to \a altitude.
*/
/*!
\fn QContactGeoLocation::altitude() const
Returns the altitude (in metres) of the location stored in the detail.
*/
/*!
\fn QContactGeoLocation::setAltitudeAccuracy(double altitudeAccuracy)
Sets the altitude-accuracy portion of the coordinate (in metres) of
the location stored in the detail to \a altitudeAccuracy.
*/
/*!
\fn QContactGeoLocation::altitudeAccuracy() const
Returns the accuracy of the altitude portion of the location stored
in the detail.
*/
/*!
\fn QContactGeoLocation::setHeading(double heading)
Sets the heading portion of the coordinate (in decimal degrees
clockwise relative to true north) of the location-aware device at
the time of measurement to \a heading.
*/
/*!
\fn QContactGeoLocation::heading() const
Returns the heading (at the time of measurement) of the
location-aware device that recorded (or was provided) the
measurement.
*/
/*!
\fn QContactGeoLocation::setSpeed(double speed)
Sets the speed portion of the coordinate (in metres per second) of
the location-aware device at the time of measurement to \a speed.
*/
/*!
\fn QContactGeoLocation::speed() const
Returns the speed (at the time of measurement) of the
location-aware device that recorded (or was provided) the
measurement.
*/
/*!
\fn QContactGeoLocation::setTimestamp(const QDateTime& timestamp)
Sets the creation (or first-valid) timestamp of the location
information to \a timestamp.
*/
/*!
\fn QContactGeoLocation::timestamp() const
Returns the timestamp associated with the location stored in the
detail.
*/
/*!
\fn QContactGuid::guid() const
Returns the globally unique identifier which is stored in this
detail.
*/
/*!
\fn QContactGuid::setGuid(const QString& guid)
Sets the globally unique identifier which is stored in this detail to \a guid.
*/
/*!
\fn QContactName::prefix() const
Returns the prefix segment of the name stored in this detail.
*/
/*!
\fn QContactName::setPrefix(const QString& prefix)
Sets the prefix segment of the name stored in this detail to \a prefix.
*/
/*!
\fn QContactName::firstName() const
Returns the first (given) name segment of the name stored in this detail.
*/
/*!
\fn QContactName::setFirstName(const QString& firstName)
Sets the first name segment of the name stored in this detail to \a firstName.
*/
/*!
\fn QContactName::middleName() const
Returns the middle (additional, or other) name segment of the name
stored in this detail.
*/
/*!
\fn QContactName::setMiddleName(const QString& middleName)
Sets the middle name segment of the name stored in this detail to \a middleName.
*/
/*!
\fn QContactName::lastName() const
Returns the last (family, or surname) name segment of the name
stored in this detail.
*/
/*!
\fn QContactName::setLastName(const QString& lastName)
Sets the last name segment of the name stored in this detail to \a lastName.
*/
/*!
\fn QContactName::suffix() const
Returns the suffix segment of the name stored in this detail.
*/
/*!
\fn QContactName::setSuffix(const QString& suffix)
Sets the suffix segment of the name stored in this detail to \a suffix.
*/
/*!
\fn QContactName::customLabel() const
Returns the custom label of the name stored in this detail.
*/
/*!
\fn QContactName::setCustomLabel(const QString& customLabel)
Sets the custom label of the name stored in this detail to \a customLabel.
*/
/*!
\fn QContactNickname::setNickname(const QString& nickname)
Sets the nickname of the contact which is stored in this detail to \a nickname.
*/
/*!
\fn QContactNickname::nickname() const
Returns the nickname of the contact which is stored in this detail.
*/
/*!
\fn QContactNote::setNote(const QString& note)
Sets a note associated with a contact to \a note.
*/
/*!
\fn QContactNote::note() const
Returns a string for a note associated with a contact.
*/
/*!
\fn QContactTimestamp::created() const
Returns the creation timestamp saved in this detail.
*/
/*!
\fn QContactTimestamp::lastModified() const
Returns the last-modified timestamp saved in this detail.
*/
/*!
\fn QContactTimestamp::setCreated(const QDateTime& dateTime)
Sets the creation timestamp saved in this detail to \a dateTime.
*/
/*!
\fn QContactTimestamp::setLastModified(const QDateTime& dateTime)
Sets the last-modified timestamp saved in this detail to \a dateTime.
*/
/*!
\fn QContactType::type() const
Returns the contact type value stored in this detail.
*/
/*!
\fn QContactType::setType(const QString& type)
Sets the type of the contact to be the give \a type.
*/
/*!
\fn QContactDisplayLabel::label() const
Returns the display label of the contact.
*/
/*!
\fn QContactOnlineAccount::setAccountUri(const QString& accountUri)
Sets the universal resource identifier of the contact's online
account to \a accountUri.
*/
/*!
\fn QContactOnlineAccount::accountUri() const
Returns the universal resource identifier of the online account of
the contact.
*/
/*!
\fn QContactOnlineAccount::setServiceProvider(const QString& serviceProvider)
Sets the service provider of the contact's online account to \a
serviceProvider.
*/
/*!
\fn QContactOnlineAccount::serviceProvider() const
Returns the service provider of the online account of the contact.
*/
/*!
\fn QContactOnlineAccount::setSubTypes(const QStringList& subTypes)
Sets the subtypes which this detail implements to be those
contained in the list of given \a subTypes.
*/
/*!
\fn QContactOnlineAccount::setSubTypes(const QString& subType)
Sets the subtypes which this detail implements to be just the given \a subType.
*/
/*!
\fn QContactOnlineAccount::subTypes() const
Returns the list of subtypes that this detail implements.
*/
/*!
\fn QContactOnlineAccount::setNickname(const QString& nickname)
Sets the last-known nickname used by the contact during
communications via the online account about which this detail
stores presence information to \a nickname.
*/
/*!
\fn QContactOnlineAccount::nickname() const
Returns the last-known nickname used by the contact during
communications via the online account.
*/
/*!
\fn QContactOnlineAccount::setPresence(const QString& presence)
Sets the presence of the online account according to the presence
information provider to \a presence.
*/
/*!
\fn QContactOnlineAccount::presence() const
Returns the presence of the online account according to the
presence provider.
*/
/*!
\fn QContactOnlineAccount::setStatusMessage(const QString& statusMessage)
Sets the last-known status message of the contact which was
communicated via the online account about which this detail stores
presence information to \a statusMessage.
*/
/*!
\fn QContactOnlineAccount::statusMessage() const
Returns the last-known status message of the contact which was
communicated via the online account about which this detail stores
presence information.
*/
/*!
\fn QContactOnlineAccount::setCapabilities(const QStringList& capabilities)
Sets the capabilities of the online account about which this detail stores
presence information to \a capabilities. The \a capabilities list is a
list of service-provider specified strings which together identify the
types of communication which may be possible.
*/
/*!
\fn QContactOnlineAccount::capabilities() const
Returns the capabilities of the online account about which this detail stores
presence information.
*/
/*!
\fn QContactOrganization::setName(const QString& name)
Sets the name of the organization stored in this detail to \a name.
*/
/*!
\fn QContactOrganization::name() const
Returns the name of the organization stored in this detail.
*/
/*!
\fn QContactOrganization::setLogo(const QString& logo)
Sets the logo of the organization stored in this detail to \a logo.
*/
/*!
\fn QContactOrganization::logo() const
Returns the logo of the organization stored in this detail.
*/
/*!
\fn QContactOrganization::setDepartment(const QStringList& department)
Sets the contact's department of the organization stored in this
detail to \a department. The department is a list of progressively
finer-grained information.
*/
/*!
\fn QContactOrganization::department() const
Returns the contact's department stored in this detail.
*/
/*!
\fn QContactOrganization::setLocation(const QString& location)
Sets the location (e.g. city or suburb) of the organization stored
in this detail to \a location.
*/
/*!
\fn QContactOrganization::location() const
Returns the location of the organization stored in this detail.
*/
/*!
\fn QContactOrganization::setRole(const QString& role)
Sets the contact's role within the organization stored in this detail to \a role.
*/
/*!
\fn QContactOrganization::role() const
Returns the contact's role within the organization stored in this detail.
*/
/*!
\fn QContactOrganization::setTitle(const QString& title)
Sets the contact's title within the organization stored in this detail to \a title.
*/
/*!
\fn QContactOrganization::title() const
Returns the contact's title within the organization stored in this detail.
*/
/*!
\fn QContactOrganization::setAssistantName(const QString& assistantName)
Sets the name of the default assistant of contacts belonging to
this organization to \a assistantName.
*/
/*!
\fn QContactOrganization::assistantName() const
Returns the name of the default assistant of contacts belonging to
this organization.
*/
/* Convenience filters */
/*!
Returns a filter suitable for finding
contacts with a display label matching the specified \a label.
*/
QContactFilter QContactDisplayLabel::match(const QString &label)
{
QContactDetailFilter f;
f.setDetailDefinitionName(QContactDisplayLabel::DefinitionName);
f.setValue(label);
return f;
}
/*!
Returns a filter suitable for finding
contacts with a name matching the specified \a firstName and
\a lastName. If either parameter is empty, any value will match
that component.
*/
QContactFilter QContactName::match(const QString &firstName, const QString &lastName)
{
if (firstName.isEmpty()) {
if (lastName.isEmpty()) {
// Matches contacts that have a name
QContactDetailFilter f;
f.setDetailDefinitionName(QContactName::DefinitionName);
return f;
} else {
// Contact with matching lastname
QContactDetailFilter f;
f.setDetailDefinitionName(QContactName::DefinitionName, QContactName::FieldLastName);
f.setValue(lastName);
return f;
}
} else {
if (lastName.isEmpty()) {
// Contact with matching firstName
QContactDetailFilter f;
f.setDetailDefinitionName(QContactName::DefinitionName, QContactName::FieldFirstName);
f.setValue(firstName);
return f;
} else {
// Match a contact with the specified first and last names
// XXX This needs multi detail filter!
// Best we can currently do is "and" and assume there's only one name per contact
QContactDetailFilter f;
f.setDetailDefinitionName(QContactName::DefinitionName, QContactName::FieldFirstName);
f.setValue(firstName);
QContactDetailFilter l;
l.setDetailDefinitionName(QContactName::DefinitionName, QContactName::FieldLastName);
l.setValue(lastName);
return f & l;
}
}
}
/*!
Returns a filter suitable for finding
contacts with a name field (e.g. first, last) that
matches the supplied \a name.
*/
QContactFilter QContactName::match(const QString &name)
{
QContactDetailFilter l;
l.setDetailDefinitionName(QContactName::DefinitionName);
l.setValue(name);
return l;
}
/*!
Returns a filter suitable for finding
contacts with an email address matching the specified \a emailAddress.
*/
QContactFilter QContactEmailAddress::match(const QString &emailAddress)
{
QContactDetailFilter l;
l.setDetailDefinitionName(QContactEmailAddress::DefinitionName, QContactEmailAddress::FieldEmailAddress);
l.setValue(emailAddress);
return l;
}
/*!
Returns a filter suitable for finding
contacts with a phone number matching the specified \a number.
*/
QContactFilter QContactPhoneNumber::match(const QString &number)
{
QContactDetailFilter l;
l.setDetailDefinitionName(QContactPhoneNumber::DefinitionName, QContactPhoneNumber::FieldNumber);
l.setValue(number);
l.setMatchFlags(QContactFilter::MatchPhoneNumber);
return l;
}
QTM_END_NAMESPACE