Home · All Classes · All Functions ·

QContactFilter Class Reference

The QContactFilter class is used to select contacts made available through a QContactManager. More...

    #include <QContactFilter>

Inherited by QContactActionFilter, QContactChangeLogFilter, QContactDetailFilter, QContactDetailRangeFilter, QContactIntersectionFilter, QContactInvalidFilter, QContactLocalIdFilter, QContactRelationshipFilter, and QContactUnionFilter.


Public Types

enum FilterType { InvalidFilter, ContactDetailFilter, ContactDetailRangeFilter, ChangeLogFilter, ..., DefaultFilter }
enum MatchFlag { MatchExactly, MatchContains, MatchStartsWith, MatchEndsWith, ..., MatchPhoneNumber }
flags MatchFlags

Public Functions

QContactFilter ()
QContactFilter ( const QContactFilter & other )
virtual ~QContactFilter ()
FilterType type () const
bool operator!= ( const QContactFilter & other ) const
QContactFilter & operator= ( const QContactFilter & other )
bool operator== ( const QContactFilter & other ) const

Protected Functions

QContactFilter ( QContactFilterPrivate * d )

Detailed Description

The QContactFilter class is used to select contacts made available through a QContactManager.

This class is used as a parameter to various functions offered by QContactManager, to allow selection of contacts which have certain details or properties.


Member Type Documentation

enum QContactFilter::FilterType

Describes the type of the filter

ConstantValueDescription
QContactFilter::InvalidFilter0An invalid filter which matches nothing
QContactFilter::ContactDetailFilter1A filter which matches contacts containing one or more details of a particular definition with a particular value
QContactFilter::ContactDetailRangeFilter2A filter which matches contacts containing one or more details of a particular definition whose values are within a particular range
QContactFilter::ChangeLogFilter3A filter which matches contacts whose timestamps have been updated since some particular date and time
QContactFilter::ActionFilter4A filter which matches contacts for which a particular action is available, or which contain a detail with a particular value for which a particular action is available
QContactFilter::RelationshipFilter5A filter which matches contacts which participate in a particular type of relationship, or relationship with a specified contact
QContactFilter::IntersectionFilter6A filter which matches all contacts that are matched by all filters it includes
QContactFilter::UnionFilter7A filter which matches any contact that is matched by any of the filters it includes
QContactFilter::LocalIdFilter8A filter which matches any contact whose local id is contained in a particular list of contact local ids
QContactFilter::DefaultFilter9A filter which matches everything

enum QContactFilter::MatchFlag
flags QContactFilter::MatchFlags

Describes the semantics of matching followed by the filter

ConstantValueDescription
QContactFilter::MatchExactlyQt::MatchExactlyPerforms QVariant-based matching
QContactFilter::MatchContainsQt::MatchContainsThe search term is contained in the item
QContactFilter::MatchStartsWithQt::MatchStartsWithThe search term matches the start of the item
QContactFilter::MatchEndsWithQt::MatchEndsWithThe search term matches the end of the item
QContactFilter::MatchFixedStringQt::MatchFixedStringPerforms string-based matching. String-based comparisons are case-insensitive unless the MatchCaseSensitive flag is also specified
QContactFilter::MatchCaseSensitiveQt::MatchCaseSensitiveThe search is case sensitive
QContactFilter::MatchPhoneNumber1024The search term is considered to be contained in the item by the platform where the search term is a phone number

The MatchFlags type is a typedef for QFlags<MatchFlag>. It stores an OR combination of MatchFlag values.


Member Function Documentation

QContactFilter::QContactFilter ()

Constructs an empty filter

QContactFilter::QContactFilter ( const QContactFilter & other )

Constructs a new copy of other

QContactFilter::QContactFilter ( QContactFilterPrivate * d )   [protected]

Constructs a new filter from the given data pointer d

QContactFilter::~QContactFilter ()   [virtual]

Cleans up the memory used by this filter

FilterType QContactFilter::type () const

Returns the type of the filter

bool QContactFilter::operator!= ( const QContactFilter & other ) const

Returns true if this filter is not identical to the other filter.

See also operator==().

QContactFilter & QContactFilter::operator= ( const QContactFilter & other )

Assigns this filter to be other

bool QContactFilter::operator== ( const QContactFilter & other ) const

Returns true if the filter has the same type and criteria as other


Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies) Trademarks
Qt Mobility Project 1.0.0 (Technology Preview)