QContactTag Class Reference

Public Functions
Static Public Members
Detailed Description

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

 #include <QContactTag>

Inherits QContactDetail.

List of all members, including inherited members

Public Functions

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

29 public functions inherited from QContactDetail

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.

QString QContactTag::tag () const

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

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.