QtMobility Reference Documentation

QContactId Class Reference

The QContactId class provides information that uniquely identifies a contact in a particular manager. More...

 #include <QContactId>

This class was introduced in Qt Mobility 1.0.

Public Functions

QContactId ()
QContactId ( const QContactId & other )
~QContactId ()
QContactLocalId localId () const
QString managerUri () const
void setLocalId ( const QContactLocalId & id )
void setManagerUri ( const QString & uri )
bool operator!= ( const QContactId & other ) const
bool operator< ( const QContactId & other ) const
QContactId & operator= ( const QContactId & other )
bool operator== ( const QContactId & other ) const

Related Non-Members

typedef QContactLocalId

Detailed Description

The QContactId class provides information that uniquely identifies a contact in a particular manager.

It consists of a manager URI which identifies the manager which contains the contact, and the local id of the contact in that manager.

A "null" QContactId has an empty manager URI, and an invalid QContactLocalId (0).

See also QContactLocalId.

Member Function Documentation

QContactId::QContactId ()

Constructs a new contact id

QContactId::QContactId ( const QContactId & other )

Constructs a new contact id as a copy of other

QContactId::~QContactId ()

Cleans up the memory in use by the contact id

QContactLocalId QContactId::localId () const

Returns the manager-local id of the contact identified by this contact id

This function was introduced in Qt Mobility 1.0.

See also setLocalId().

QString QContactId::managerUri () const

Returns the URI of the manager which contains the contact identified by this id

This function was introduced in Qt Mobility 1.0.

See also setManagerUri().

void QContactId::setLocalId ( const QContactLocalId & id )

Sets the manager-local id of the contact identified by this contact id to id

This function was introduced in Qt Mobility 1.0.

See also localId().

void QContactId::setManagerUri ( const QString & uri )

Sets the URI of the manager which contains the contact identified by this id to uri

This function was introduced in Qt Mobility 1.0.

See also managerUri().

bool QContactId::operator!= ( const QContactId & other ) const

Returns true if either the manager URI or local id of the contact id is different to that of other

This function was introduced in Qt Mobility 1.0.

bool QContactId::operator< ( const QContactId & other ) const

Returns true if this id is less than the other id. This id will be considered less than the other id if the manager URI of this id is alphabetically less than the manager URI of the other id. If both ids have the same manager URI, this id will be considered less than the other id if the local id of this id is less than the local id of the other id.

The invalid, empty id consists of an empty manager URI and the invalid, zero local id, and hence will be less than any non-invalid id.

This operator is provided primarily to allow use of a QContactId as a key in a QMap.

This function was introduced in Qt Mobility 1.0.

QContactId & QContactId::operator= ( const QContactId & other )

Assigns the contact id to be equal to other

This function was introduced in Qt Mobility 1.0.

bool QContactId::operator== ( const QContactId & other ) const

Returns true if the contact id has the same manager URI and local id as other

This function was introduced in Qt Mobility 1.0.

Related Non-Members

typedef QContactLocalId

The QContactLocalId type represents the unique id of a contact within its manager.

Most operations within a QContactManager accept a QContactLocalId. Some operations (involving links to contacts outside a particular manager) also accept a manager URI - this combination is stored in a QContactId.

An invalid QContactLocalId is represented by a zero (0) value.

See also QContactId.

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.