Home · All Classes · Grouped Classes · Annotated · Functions

QMailMessageKey Class Reference

The QMailMessageKey class defines the parameters used for querying a subset of all available mail messages from the mail store. More...

    #include <QMailMessageKey>

This class is under development and is subject to change.

• List of all members, including inherited members

Public Types

• enum Operand { LessThan, LessThanEqual, GreaterThan, GreaterThanEqual, ..., Contains }
• flags Properties
• enum Property { Id, Type, ParentFolderId, Sender, ..., Size }

Public Functions

• QMailMessageKey ()
• QMailMessageKey ( const Property & p, const QVariant & value, const Operand & c = Equal )
• QMailMessageKey ( const QMailIdList & idList )
• QMailMessageKey ( const QMailMessageKey & other )
• virtual ~QMailMessageKey ()
• bool isEmpty () const
• bool operator!= ( const QMailMessageKey & other ) const
• QMailMessageKey operator& ( const QMailMessageKey & other ) const
• QMailMessageKey & operator&= ( const QMailMessageKey & other )
• QMailMessageKey & operator= ( const QMailMessageKey & other )
• bool operator== ( const QMailMessageKey & other ) const
• QMailMessageKey operator| ( const QMailMessageKey & other ) const
• QMailMessageKey & operator|= ( const QMailMessageKey & other )
• QMailMessageKey operator~ () const

Detailed Description

The QMailMessageKey class defines the parameters used for querying a subset of all available mail messages from the mail store.

A QMailMessageKey is composed of a message property, an optional comparison operator and a comparison value. The QMailMessageKey class is used in conjunction with the QMailStore::queryMessages() and QMailStore::countMessages() functions to filter results which meet the criteria defined by the key.

QMailMessageKey's can be combined using the logical operators (&), (|) and (~) to create more refined queries.

For example: To create a query for all message's sent from "joe@user.com" with subject "meeting":

    QMailMessageKey subjectKey(QMailMessageKey::Subject,"meeting");
    QMailMessageKey senderKey(QMailMessageKey::Sender,"joe@user.com")
    QMailIdList results = QMailStore::instance()->queryMessages(subjectKey & senderKey);

To query all unread messages from a specific folder parent:

    \\assuming parent has been retrieved from the mail store.
    QMailFolder parent;
    QMailMessageKey parentFolderKey(QMailMessageKey::ParentFolderId,parent.id())
    QMailMessageKey readKey(QMailMessageKey::Status,QMailMessage::Read,QMailMessageKey::Contains);
    QMailIdList results = QMailStore::instance()->queryMessages(parentFolderKey & ~readKey);

See also QMailStore and QMailFolderKey.

Member Type Documentation

enum QMailMessageKey::Operand

Defines the comparison operators that can be used to comapare QMailMessage::Property elements with user sepecified values.

enum QMailMessageKey::Property
flags QMailMessageKey::Properties

This enum type describes the data query properties of a QMailMessage.

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

Member Function Documentation

QMailMessageKey::QMailMessageKey ()

Create a QMailFolderKey with specifying matching parameters.

A default-constructed key (one for which isEmpty() returns true) matches all messages. The logical negation of an empty key also matches all messages.

The result of combining an empty key with a non-empty key is the same as the original non-empty key. This is true regardless of whether the combination is formed by a logical AND or a logical OR operation.

The result of combining two empty keys is an empty key.

QMailMessageKey::QMailMessageKey ( const Property & p, const QVariant & value, const Operand & c = Equal )

Construct a QMailMessageKey which defines a query parameter where QMailMessage::Property p is compared using comparison operator c with a value value.

QMailMessageKey::QMailMessageKey ( const QMailIdList & idList )

Construct a QMailMessageKey which defines a query parameter where message id's matching those in idList are returned.

QMailMessageKey::QMailMessageKey ( const QMailMessageKey & other )

Create a copy of the QMailMessageKey other.

QMailMessageKey::~QMailMessageKey ()   [virtual]

Destroys the QMailMessageKey

bool QMailMessageKey::isEmpty () const

Returns true if the key remains empty after default construction; otherwise returns false.

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

Returns true if the value of this key is not the same as the key other. Returns false otherwise.

QMailMessageKey QMailMessageKey::operator& ( const QMailMessageKey & other ) const

Returns a key that is the logical AND of this key and the value of key other.

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

Performs a logical AND with this key and the key other and assigns the result to this key.

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

Assign the value of the QMailMessageKey other to this.

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

Returns true if the value of this key is the same as the key other. Returns false otherwise.

QMailMessageKey QMailMessageKey::operator| ( const QMailMessageKey & other ) const

Returns a key that is the logical OR of this key and the value of key other.

QMailMessageKey & QMailMessageKey::operator|= ( const QMailMessageKey & other )

Performs a logical OR with this key and the key other and assigns the result to this key.

QMailMessageKey QMailMessageKey::operator~ () const

Returns a key that is the logical NOT of the value of this key.