QtMobility Reference Documentation

Contents

QContactRelationshipSaveRequest Class Reference

The QContactRelationshipSaveRequest class allows a client to asynchronously request that certain groups be saved to a contacts store. More...

 #include <QContactRelationshipSaveRequest>

Inherits QContactAbstractRequest.

This class was introduced in Qt Mobility 1.0.

Public Functions

QContactRelationshipSaveRequest ( QObject * parent = 0 )
~QContactRelationshipSaveRequest ()
QMap<int, QContactManager::Error> errorMap () const
QList<QContactRelationship> relationships () const
void setRelationship ( const QContactRelationship & contactRelationship )
void setRelationships ( const QList<QContactRelationship> & contactRelationships )

Additional Inherited Members

Detailed Description

The QContactRelationshipSaveRequest class allows a client to asynchronously request that certain groups be saved to a contacts store.

For a QContactRelationshipSaveRequest, the resultsAvailable() signal will be emitted when either the individual item errors (which may be retrieved by calling errorMap()), or 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

QContactRelationshipSaveRequest::QContactRelationshipSaveRequest ( QObject * parent = 0 )

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

QContactRelationshipSaveRequest::~QContactRelationshipSaveRequest ()

Frees any memory used by this request

QMap<int, QContactManager::Error> QContactRelationshipSaveRequest::errorMap () const

Returns the map of input relationship list indices to errors which occurred

QList<QContactRelationship> QContactRelationshipSaveRequest::relationships () const

Returns the list of relationships that will be saved if called prior to calling start(), otherwise returns the list of relationships as they were saved in the contacts store

See also setRelationships().

void QContactRelationshipSaveRequest::setRelationship ( const QContactRelationship & contactRelationship )

Sets the relationship to save to be contactRelationship. Equivalent to calling:

 setRelationships(QList<QContactRelationship>() << contactRelationships);

void QContactRelationshipSaveRequest::setRelationships ( const QList<QContactRelationship> & contactRelationships )

Sets the relationships to save to be contactRelationships

See also relationships().