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
QContactRelationshipFetchRequest::~QContactRelationshipFetchRequest ()
Frees any memory used by this request
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().