QtMobility Reference Documentation

Contents

QML MessageFilter Element

The MessageFilter element specifies a message filter for MessageModel More...

Properties

Detailed Description

This element is part of the QtMobility.messaging 1.1 module.

Logical combinations of MessageFilters can be formed using MessageIntersectionFilter and MessageUnionFilter.

Setting negated to true will negate the filter.

The following example creates a filter which filters for messages less than 1024 bytes in size from martin or don, excluding replies from martin. The messages will be sorted by descending timestamp.

 model: MessageModel {
     sortBy: MessageModel.Timestamp
     sortOrder: MessageModel.DescendingOrder
     filter: MessageIntersectionFilter {
         MessageFilter {
             type: MessageFilter.Size
             value: 1024
             comparator: MessageFilter.LessThan
         }
         MessageUnionFilter {
             MessageIntersectionFilter {
                 MessageFilter {
                     type: MessageFilter.Sender
                     value: "martin"
                     comparator: MessageFilter.Includes
                 }
                 MessageFilter {
                     negated: true
                     type: MessageFilter.Subject
                     value: "re:"
                     comparator: MessageFilter.Includes
                 }
             }
             MessageFilter {
                 type: MessageFilter.Sender
                 value: "don"
                 comparator: MessageFilter.Includes
             }
         }
     }
 }

See also MessageUnionFilter and MessageIntersectionFilter.

Property Documentation

comparator : enumeration

Holds the type of comparison to apply.

comparator may be one of the following:

Note that not all comparators make sense for all filter types. For example the relational comparators (LessThan, GreaterThan, etc.) make sense for Size filters, but the inclusion comprators (Includes, Excludes) do not.

This documentation was introduced in Qt Mobility Mobility 1.1.


read-onlynegated : bool

Setting negated to true will result in the filter being locially negated.

This documentation was introduced in Qt Mobility Mobility 1.1.


Holds the field to filter on.

type may be one of the following:

Filter typevalue type
MessageFilter.AncestorFolderstring
MessageFilter.ParentFolderstring
MessageFilter.Priorityenumeration
MessageFilter.Recipientsstring
MessageFilter.Senderstring
MessageFilter.Sizeint
MessageFilter.StandardFolderenumeration
MessageFilter.Statusenumeration
MessageFilter.Subjectstring
MessageFilter.TimestampDate
MessageFilter.ReceptionTimestampDate
MessageFilter.Typeenumeration

This documentation was introduced in Qt Mobility Mobility 1.1.


value : Variant

Holds the value to filter on.

This documentation was introduced in Qt Mobility Mobility 1.1.