MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QContactTag Class Reference

The QContactTag class contains a tag associated with a contact. More...

 #include <QContactTag>

Inherits: QContactDetail.

This class was introduced in Qt Mobility 1.0.

Public Functions

void setTag ( const QString & tag )
QString tag () const

Static Public Members

const QLatin1Constant DefinitionName
const QLatin1Constant FieldTag
QContactFilter match ( const QString & subString )

Detailed Description

The QContactTag class contains a tag associated with a contact.

Typically the tags associated with a contact will be distinct, although this is usually only enforced when the contact is saved in the manager.

Here is an example of retrieving all the tags for a contact:

 QSet<QString> tags;
 foreach(const QContactTag& tag, contact.details<QContactTag>()) {
      tags.insert(tag.tag());
 }

Here is an example of checking for a specific tag value:

 if (contact.details<QContactTag>(QContactTag::FieldTag, "MyTag").count() > 0) {
     // Do something with it
 }

This leaf-class has been part of the default schema since version 1.0 of the Qt Mobility project.

Member Function Documentation

QContactFilter QContactTag::match ( const QString & subString ) [static]

Returns a filter suitable for finding contacts which have a tag which contains the specified subString.

void QContactTag::setTag ( const QString & tag )

Sets the tag associated with a contact which is stored in this detail to tag.

This function was introduced in Qt Mobility 1.0.

See also tag().

QString QContactTag::tag () const

Returns the tag associated with a contact which is stored in this detail.

This function was introduced in Qt Mobility 1.0.

See also setTag().

Member Variable Documentation

const QLatin1Constant QContactTag::DefinitionName

The string constant for the definition name of QContactTag details.

const QLatin1Constant QContactTag::FieldTag

The field key constant for the value containing the tag.

See also tag() and setTag().