Home · All Classes · All Functions ·

QContactRelationshipFetchRequest Class Reference

The QContactRelationshipFetchRequest class allows a client to asynchronously request relationships from a contacts store manager. More...

    #include <QContactRelationshipFetchRequest>

Inherits QContactAbstractRequest.


Public Functions

QContactRelationshipFetchRequest ( QObject * parent = 0 )
QContactId first () const
QString relationshipType () const
QList<QContactRelationship> relationships () const
QContactId second () const
void setFirst ( const QContactId & firstId )
void setRelationshipType ( const QString & relationshipType )
void setSecond ( const QContactId & secondId )

Additional Inherited Members


Detailed Description

The QContactRelationshipFetchRequest class allows a client to asynchronously request relationships from a contacts store manager.

For a QContactRelationshipFetchRequest, the resultsAvailable() signal will be emitted when the resultant relationships (which may be retrieved by calling relationships()), are updated, as well as if the overall operation error (which may be retrieved by calling error()) is updated.

Please see the class documentation of QContactAbstractRequest for more information about the usage of request classes and ownership semantics.


Member Function Documentation

QContactRelationshipFetchRequest::QContactRelationshipFetchRequest ( QObject * parent = 0 )

Constructs a new relationship fetch request whose parent is the specified parent

QContactId QContactRelationshipFetchRequest::first () const

Returns the source contact criterion of the fetch request

See also setFirst().

QString QContactRelationshipFetchRequest::relationshipType () const

Returns the relationship type criterion of the fetch request

See also setRelationshipType().

QList<QContactRelationship> QContactRelationshipFetchRequest::relationships () const

Returns the list of relationships that was the result of the request

QContactId QContactRelationshipFetchRequest::second () const

Returns the destination contact criterion of the fetch request

See also setSecond().

void QContactRelationshipFetchRequest::setFirst ( const QContactId & firstId )

Sets the source contact criterion of the fetch request to firstId. If firstId is the default-constructed id, or the first contact id is not set, the request will fetch relationships involving any first contact.

See also first().

void QContactRelationshipFetchRequest::setRelationshipType ( const QString & relationshipType )

Sets the relationship type criterion of the fetch request to relationshipType. If relationshipType is empty, or the relationship type is not set, the request will fetch relationships of any type.

See also relationshipType().

void QContactRelationshipFetchRequest::setSecond ( const QContactId & secondId )

Sets the destination contact criterion of the fetch request to secondId. If secondId is the default-constructed id, or the second contact id is not set, the request will fetch relationships involving any second contact.

See also second().


Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies) Trademarks
Qt Mobility Project 1.0.2