MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QML RelationshipModel Element

The RelationshipModel provides a model of contact relationships from the contacts store. More...

This element was introduced in Mobility 1.1.

Properties

Methods

Detailed Description

This element is part of the QtMobility.contacts 1.1 module.

The contents of the model can be specified with participantId, role and relationshipType properties. Whether the model is automatically updated when the store or filter changes, can be controlled with RelationshipModel::autoUpdate property.

There are two ways of accessing the relationship data: through model by using views and delegates, or alternatively via relationships list property.

At the moment only data role provided by the model is relationship (Relationship). Through that one can access any data provided by the Relationship element.

See also Relationship and QContactRelationship.

Property Documentation

autoUpdate : bool

This property indicates whether or not the relationship model should be updated automatically, default value is true.

This property group was introduced in Mobility 1.1.


read-onlyerror : string

This property holds the latest error code returned by the contact manager.

This property is read only.

This property group was introduced in Mobility 1.1.


manager : string

This property holds the manager uri of the contact backend engine.

This property group was introduced in Mobility 1.1.


participantId : int

This property holds the participant id which the list of relationships returned by RelationshipModel should contain.

This property group was introduced in Mobility 1.1.

See also RelationshipFilter::relatedContactId and RelationshipModel::role.


relationshipType : variant

This property holds the relationship type which the list of relationships returned by RelationshipModel should contain.

This property group was introduced in Mobility 1.1.

See also Relationship::type.


read-onlyrelationships : list<Relationship>

This property holds a list of relationships.

This property group was introduced in Mobility 1.1.

See also Relationship.


role : enumeration

This property holds the relationship role which the list of relationships returned by RelationshipModel should contain.

This property group was introduced in Mobility 1.1.

See also RelationshipFilter::relatedContactRole.


Method Documentation

RelationshipModel::addRelationship ( relationship )

Adds the given relationship to the backend store.

This documentation was introduced in Mobility 1.1.


RelationshipModel::removeRelationship ( relationship )

Removes the given relationship from the backend store.

This documentation was introduced in Mobility 1.1.