MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QContactRelationshipFilter Class Reference

The QContactRelationshipFilter class provides a filter based around relationship criteria. More...

 #include <QContactRelationshipFilter>

Inherits: QContactFilter.

This class was introduced in Qt Mobility 1.0.

Public Functions

QContactRelationshipFilter ()
QContactRelationshipFilter ( const QContactFilter & other )
QContactId relatedContactId () const
QContactRelationship::Role relatedContactRole () const
QString relationshipType () const
void setRelatedContactId ( const QContactId & relatedContactId )
void setRelatedContactRole ( QContactRelationship::Role relatedContactRole )
void setRelationshipType ( const QString & relationshipType )

Detailed Description

The QContactRelationshipFilter class provides a filter based around relationship criteria.

It may be used to select contacts which are involved in relationships which are of a certain type, or which involve certain contacts.

One common use-case might be to select the contacts which are a member of a particular group. This use-case may be met with the following filter:

 QContactRelationshipFilter groupFilter;                               // select all contacts which are involved
 groupFilter.setRelationshipType(QContactRelationship::HasMember);     // in a group relationship
 groupFilter.setRelatedContactId(groupContact.id());                   // with the group contact
 groupFilter.setRelatedContactRole(QContactRelationship::First); // where the group contact is the first participant

Another common use-case might be to select the groups which a particular contact is a member of. This use-case may be met with the following filter:

 QContactRelationshipFilter whichGroupsFilter;                                 // select all contacts which are involved
 whichGroupsFilter.setRelationshipType(QContactRelationship::HasMember); // in a group relationship
 whichGroupsFilter.setRelatedContactId(particularContact.id());                // with the particular contact
 whichGroupsFilter.setRelatedContactRole(QContactRelationship::Second);  // where the particular contact is the second participant

Member Function Documentation

QContactRelationshipFilter::QContactRelationshipFilter ()

Constructs a new relationship filter

QContactRelationshipFilter::QContactRelationshipFilter ( const QContactFilter & other )

Constructs a copy of other if possible, else constructs a new QContactRelationshipFilter. *

This function was introduced in Qt Mobility 1.0.

QContactId QContactRelationshipFilter::relatedContactId () const

Returns the id of the contact with whom the tested contact must have a relationship in order for the tested contact to match this filter

This function was introduced in Qt Mobility 1.0.

See also setRelatedContactId().

QContactRelationship::Role QContactRelationshipFilter::relatedContactRole () const

Returns the role in the relationship with the tested contact that the related contact must play in order for the tested contact to match this filter

This function was introduced in Qt Mobility 1.0.

See also setRelatedContactRole().

QString QContactRelationshipFilter::relationshipType () const

Returns the type of relationship that a contact must have in order to match the filter

This function was introduced in Qt Mobility 1.0.

See also setRelationshipType().

void QContactRelationshipFilter::setRelatedContactId ( const QContactId & relatedContactId )

Sets the id of the contact with whom the tested contact must have a relationship in order for the tested contact to match this filter to be relatedContactId

This function was introduced in Qt Mobility 1.0.

See also relatedContactId().

void QContactRelationshipFilter::setRelatedContactRole ( QContactRelationship::Role relatedContactRole )

Sets the role in the relationship with the tested contact that the related contact must play in order for the tested contact to match this filter to be relatedContactRole

This function was introduced in Qt Mobility 1.0.

See also relatedContactRole().

void QContactRelationshipFilter::setRelationshipType ( const QString & relationshipType )

Sets the type of relationship which a contact must have in order to match this filter to relationshipType

This function was introduced in Qt Mobility 1.0.

See also relationshipType().