QtMobility Reference Documentation

QContactDetailFilter Class Reference

The QContactDetailFilter class provides a filter based around a detail value criterion More...

 #include <QContactDetailFilter>

Inherits: QContactFilter.

This class was introduced in Qt Mobility 1.0.

Public Functions

QContactDetailFilter ()
QContactDetailFilter ( const QContactFilter & other )
QString detailDefinitionName () const
QString detailFieldName () const
QContactFilter::MatchFlags matchFlags () const
void setDetailDefinitionName ( const QString & definitionName, const QString & fieldName = QString() )
void setMatchFlags ( QContactFilter::MatchFlags flags )
void setValue ( const QVariant & value )
QVariant value () const

Detailed Description

The QContactDetailFilter class provides a filter based around a detail value criterion

It may be used to select contacts which contain a detail of a particular definition with a particular value

Member Function Documentation

QContactDetailFilter::QContactDetailFilter ()

Constructs a new detail filter

QContactDetailFilter::QContactDetailFilter ( const QContactFilter & other )

Constructs a copy of other if possible, otherwise constructs a new detail filter

This function was introduced in Qt Mobility 1.0.

QString QContactDetailFilter::detailDefinitionName () const

Returns the definition name of the details which will be inspected for matching values

This function was introduced in Qt Mobility 1.0.

See also setDetailDefinitionName().

QString QContactDetailFilter::detailFieldName () const

Returns the name of the field which contains the value which will be matched against the value criterion

This function was introduced in Qt Mobility 1.0.

See also setDetailDefinitionName().

QContactFilter::MatchFlags QContactDetailFilter::matchFlags () const

Returns the semantics of the value matching criterion

This function was introduced in Qt Mobility 1.0.

See also setMatchFlags().

void QContactDetailFilter::setDetailDefinitionName ( const QString & definitionName, const QString & fieldName = QString() )

Sets the name of the detail definition of which details will be matched to definitionName, and the name of the field in details of that definition which will contain the value criterion to fieldName. If definitionName is empty, the detail filter will match no contacts. If fieldName is empty, the detail filter acts like a "detail exists" filter; if any detail of the specified definition is present in a contact, that contact will match the filter, regardless of what values might be stored in that detail.

This function was introduced in Qt Mobility 1.0.

See also detailDefinitionName().

void QContactDetailFilter::setMatchFlags ( QContactFilter::MatchFlags flags )

Sets the semantics of the value matching criterion to those defined in flags

This function was introduced in Qt Mobility 1.0.

See also matchFlags().

void QContactDetailFilter::setValue ( const QVariant & value )

Sets the value criterion of the filter to value. Note that if the field name criterion (set via setDetailDefinitionName()) of the filter is an empty string, this value will be ignored.

This function was introduced in Qt Mobility 1.0.

See also value() and setDetailDefinitionName().

QVariant QContactDetailFilter::value () const

Returns the value criterion of the detail filter

This function was introduced in Qt Mobility 1.0.

See also setValue().

X

Thank you for giving your feedback.

Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.