Home

QMailMessageMetaData Class Reference

The QMailMessageMetaData class provides information about a message stored by Qtopia. More...

    #include <QMailMessageMetaData>

This class is under development and is subject to change.

Inherits QMailMessageMetaDataFwd.

Inherited by QMailMessage.


Public Functions

QMailMessageMetaData ()
QMailMessageMetaData ( const QMailMessageId & id )
QMailMessageMetaData ( const QString & uid, const QMailAccountId & accountId )
virtual ContentType content () const
virtual bool contentAvailable () const
virtual QString contentIdentifier () const
virtual QString contentScheme () const
QString customField ( const QString & name ) const
const QMap<QString, QString> & customFields () const
virtual QMailTimeStamp date () const
virtual QMailAddress from () const
virtual QMailMessageId id () const
virtual QMailMessageId inResponseTo () const
virtual uint indicativeSize () const
virtual MessageType messageType () const
virtual QMailAccountId parentAccountId () const
virtual QMailFolderId parentFolderId () const
virtual bool partialContentAvailable () const
virtual QMailFolderId previousParentFolderId () const
virtual QMailTimeStamp receivedDate () const
void removeCustomField ( const QString & name )
virtual ResponseType responseType () const
virtual QString serverUid () const
virtual void setContent ( ContentType type )
virtual bool setContentIdentifier ( const QString & identifier )
virtual bool setContentScheme ( const QString & scheme )
void setCustomField ( const QString & name, const QString & value )
virtual void setDate ( const QMailTimeStamp & timeStamp )
virtual void setFrom ( const QMailAddress & from )
virtual void setId ( const QMailMessageId & id )
virtual void setInResponseTo ( const QMailMessageId & id )
virtual void setMessageType ( MessageType type )
virtual void setParentAccountId ( const QMailAccountId & id )
virtual void setParentFolderId ( const QMailFolderId & id )
virtual void setPreviousParentFolderId ( const QMailFolderId & id )
virtual void setReceivedDate ( const QMailTimeStamp & timeStamp )
virtual void setResponseType ( ResponseType type )
virtual void setServerUid ( const QString & server )
virtual void setSize ( uint size )
virtual void setStatus ( quint64 newStatus )
virtual void setStatus ( quint64 mask, bool set )
virtual void setSubject ( const QString & subject )
virtual void setTo ( const QList<QMailAddress> & toList )
virtual void setTo ( const QMailAddress & address )
virtual uint size () const
virtual quint64 status () const
virtual QString subject () const
virtual QList<QMailAddress> to () const

Static Public Members

const quint64 & ContentAvailable
const quint64 & Draft
const quint64 & Forwarded
const quint64 & HasAttachments
const quint64 & HasReferences
const quint64 & HasUnresolvedReferences
const quint64 & HighPriority
const quint64 & Important
const quint64 & ImportantElsewhere
const quint64 & Incoming
const quint64 & Junk
const quint64 & LocalOnly
const quint64 & LowPriority
const quint64 & New
const quint64 & Outbox
const quint64 & Outgoing
const quint64 & PartialContentAvailable
const quint64 & Read
const quint64 & ReadElsewhere
const quint64 & ReadReplyRequested
const quint64 & Removed
const quint64 & Replied
const quint64 & RepliedAll
const quint64 & Sent
const quint64 & Temporary
const quint64 & TransmitFromExternal
const quint64 & Trash
const quint64 & UnloadedData
quint64 statusMask ( const QString & flagName )

Detailed Description

The QMailMessageMetaData class provides information about a message stored by Qtopia.

The QMailMessageMetaData class provides information about messages stored in the Qt Extended system as QMailMessage objects. The meta data is more compact and more easily accessed and manipulated than the content of the message itself. Many messaging-related tasks can be accomplished by manipulating the message meta data, such as listing, filtering, and searching through sets of messages.

QMailMessageMetaData objects can be created as needed, specifying the identifier of the message whose meta data is required. The meta data of a message can be located by specifying the QMailMessageId identifier directly, or by specifying the account and server UID pair needed to locate the message.

The content of the message described by the meta data object can be accessed by creating a QMailMessage object specifying the identifier returned by QMailMessageMetaData::id().

See also QMailStore and QMailMessageId.


Member Function Documentation

QMailMessageMetaData::QMailMessageMetaData ()

Constructs an empty message meta data object.

QMailMessageMetaData::QMailMessageMetaData ( const QMailMessageId & id )

Constructs a message meta data object from data stored in the message store with QMailMessageId id.

QMailMessageMetaData::QMailMessageMetaData ( const QString & uid, const QMailAccountId & accountId )

Constructs a message meta data object from data stored in the message store with the unique identifier uid from the account with id accountId.

ContentType QMailMessageMetaData::content () const   [virtual]

Returns the type of content contained within the message.

See also setContent().

bool QMailMessageMetaData::contentAvailable () const   [virtual]

Returns true if the entire content of this message is available; otherwise returns false.

QString QMailMessageMetaData::contentIdentifier () const   [virtual]

Returns the identifer used to locate the content of this message.

See also setContentIdentifier().

QString QMailMessageMetaData::contentScheme () const   [virtual]

Returns the scheme used to store the content of this message.

See also setContentScheme().

QString QMailMessageMetaData::customField ( const QString & name ) const

Returns the value recorded in the custom field named name.

See also setCustomField() and customFields().

const QMap<QString, QString> & QMailMessageMetaData::customFields () const

Returns the map of custom fields stored in the message.

See also customField() and setCustomField().

QMailTimeStamp QMailMessageMetaData::date () const   [virtual]

Returns the timestamp contained in the origination date header field of the message, if present; otherwise returns an empty timestamp.

See also setDate().

QMailAddress QMailMessageMetaData::from () const   [virtual]

Returns the originating address of the message.

See also setFrom().

QMailMessageId QMailMessageMetaData::id () const   [virtual]

Returns the Qt Extended unique QMailMessageId of the message.

See also setId().

QMailMessageId QMailMessageMetaData::inResponseTo () const   [virtual]

Returns the identifier of the message that this message was created in response to.

See also setInResponseTo().

uint QMailMessageMetaData::indicativeSize () const   [virtual]

Returns an indication of the size of the message. This measure should be used only in comparing the relative size of messages with respect to transmission.

MessageType QMailMessageMetaData::messageType () const   [virtual]

Returns the MessageType of the message.

See also setMessageType().

QMailAccountId QMailMessageMetaData::parentAccountId () const   [virtual]

Returns the id of the originating account for the message.

See also setParentAccountId().

QMailFolderId QMailMessageMetaData::parentFolderId () const   [virtual]

Return the QMailFolderId of the folder that contains the message.

See also setParentFolderId().

bool QMailMessageMetaData::partialContentAvailable () const   [virtual]

Returns true if some portion of the content of this message is available; otherwise returns false.

QMailFolderId QMailMessageMetaData::previousParentFolderId () const   [virtual]

Return the QMailFolderId of the folder that contained the message before it was moved into the current parent folder.

See also setPreviousParentFolderId().

QMailTimeStamp QMailMessageMetaData::receivedDate () const   [virtual]

Returns the timestamp placed in the message during reception by the messageserver, if present; otherwise returns an empty timestamp.

See also setReceivedDate().

void QMailMessageMetaData::removeCustomField ( const QString & name )

Removes the custom field named name.

See also customField() and customFields().

ResponseType QMailMessageMetaData::responseType () const   [virtual]

Returns the type of response that this message was created as.

See also setResponseType() and inResponseTo().

QString QMailMessageMetaData::serverUid () const   [virtual]

Returns the identifier for the message on the originating server.

See also setServerUid().

void QMailMessageMetaData::setContent ( ContentType type )   [virtual]

Sets the type of content contained within the message to type. It is the caller's responsibility to ensure that this value matches the actual content.

See also content().

bool QMailMessageMetaData::setContentIdentifier ( const QString & identifier )   [virtual]

Sets the identifer used to locate the content of this message to identifier, and returns true if successful. Once set, the identifier cannot be modified.

The identifier specified should be unique within the scheme returned by contentScheme().

See also contentIdentifier().

bool QMailMessageMetaData::setContentScheme ( const QString & scheme )   [virtual]

Sets the scheme used to store the content of this message to scheme, and returns true if successful. Once set, the scheme cannot be modified.

See also contentScheme().

void QMailMessageMetaData::setCustomField ( const QString & name, const QString & value )

Sets the value of the custom field named name to value.

See also customField() and customFields().

void QMailMessageMetaData::setDate ( const QMailTimeStamp & timeStamp )   [virtual]

Sets the origination date header field specifying the timestamp of the message to timeStamp.

See also date().

void QMailMessageMetaData::setFrom ( const QMailAddress & from )   [virtual]

Sets the from address, that is the originating address of the message to from.

See also from().

void QMailMessageMetaData::setId ( const QMailMessageId & id )   [virtual]

Sets the QMailMessageId of the message to id. id should be different for each message known to Qtopia.

See also id().

void QMailMessageMetaData::setInResponseTo ( const QMailMessageId & id )   [virtual]

Sets the identifier of the message that this message was created in response to, to id.

See also inResponseTo().

void QMailMessageMetaData::setMessageType ( MessageType type )   [virtual]

Sets the MessageType of the message to type.

See also messageType().

void QMailMessageMetaData::setParentAccountId ( const QMailAccountId & id )   [virtual]

Sets the id of the originating account for the message to id.

See also parentAccountId().

void QMailMessageMetaData::setParentFolderId ( const QMailFolderId & id )   [virtual]

Sets the QMailFolderId of the folder that contains the message to id.

See also parentFolderId().

void QMailMessageMetaData::setPreviousParentFolderId ( const QMailFolderId & id )   [virtual]

Sets the QMailFolderId of the folder that contained the message before it was moved into the current parent folder to id.

See also previousParentFolderId().

void QMailMessageMetaData::setReceivedDate ( const QMailTimeStamp & timeStamp )   [virtual]

Sets the timestamp indicating the time of message reception by the messageserver to timeStamp.

See also receivedDate().

void QMailMessageMetaData::setResponseType ( ResponseType type )   [virtual]

Sets the type of response that this message was created as to type.

See also responseType() and setInResponseTo().

void QMailMessageMetaData::setServerUid ( const QString & server )   [virtual]

Sets the originating server identifier for the message to server. The identifier specified should be unique.

See also serverUid().

void QMailMessageMetaData::setSize ( uint size )   [virtual]

Sets the complete size of the message as found on the server to size.

See also size().

void QMailMessageMetaData::setStatus ( quint64 newStatus )   [virtual]

Sets the status value for the message to newStatus.

See also status() and statusMask().

void QMailMessageMetaData::setStatus ( quint64 mask, bool set )   [virtual]

Sets the status flags indicated in mask to set.

See also status() and statusMask().

void QMailMessageMetaData::setSubject ( const QString & subject )   [virtual]

Sets the subject of the message to subject.

See also subject().

void QMailMessageMetaData::setTo ( const QList<QMailAddress> & toList )   [virtual]

Sets the list of primary recipients for the message to toList.

See also to().

void QMailMessageMetaData::setTo ( const QMailAddress & address )   [virtual]

Sets the list of primary recipients for the message to contain address.

uint QMailMessageMetaData::size () const   [virtual]

Returns the complete size of the message as indicated on the originating server.

See also setSize().

quint64 QMailMessageMetaData::status () const   [virtual]

Returns the status value for the message.

See also setStatus() and statusMask().

quint64 QMailMessageMetaData::statusMask ( const QString & flagName )   [static]

Returns the status bitmask needed to test the result of QMailMessageMetaData::status() against the QMailMessageMetaData status flag registered with the identifier flagName.

See also status() and QMailStore::messageStatusMask().

QString QMailMessageMetaData::subject () const   [virtual]

Returns the subject of the message, if present; otherwise returns an empty string.

See also setSubject().

QList<QMailAddress> QMailMessageMetaData::to () const   [virtual]

Returns the list of primary recipients for the message.

See also setTo() and QMailAddress.


Member Variable Documentation

const quint64 & QMailMessageMetaData::ContentAvailable

The status mask needed for testing the value of the registered status flag named "ContentAvailable" against the result of QMailMessage::status().

This flag indicates that the entire content of the message has been retrieved from the originating server, excluding any sub-parts of the message.

See also QMailMessagePartContainer::contentAvailable().

const quint64 & QMailMessageMetaData::Draft

The status mask needed for testing the value of the registered status flag named "Draft" against the result of QMailMessage::status().

This flag indicates that the message has been marked as a draft, and should be considered subject to further composition.

const quint64 & QMailMessageMetaData::Forwarded

The status mask needed for testing the value of the registered status flag named "Forwarded" against the result of QMailMessage::status().

This flag indicates that a message forwarding the content of this message has been created.

const quint64 & QMailMessageMetaData::HasAttachments

The status mask needed for testing the value of the registered status flag named "HasAttachments" against the result of QMailMessage::status().

This flag indicates that the message contains at least one sub-part with 'Attachment' disposition.

See also QMailMessageContentDisposition.

const quint64 & QMailMessageMetaData::HasReferences

The status mask needed for testing the value of the registered status flag named "HasReferences" against the result of QMailMessage::status().

This flag indicates that the message contains at least one sub-part which is a reference to an external message element.

See also QMailMessagePart::referenceType().

const quint64 & QMailMessageMetaData::HasUnresolvedReferences

The status mask needed for testing the value of the registered status flag named "HasUnresolvedReferences" against the result of QMailMessage::status().

This flag indicates that the message contains at least one sub-part which is a reference, that has no corresponding resolution value.

See also QMailMessagePart::referenceType() and QMailMessagePart::referenceResolution().

const quint64 & QMailMessageMetaData::HighPriority

The status mask needed for testing the value of the registered status flag named "HighPriority" against the result of QMailMessage::status().

This flag indicates that the message has a header field specifying that the message is high priority. This flag is set only during message parsing.

See also QMailMessage::fromRfc2822().

const quint64 & QMailMessageMetaData::Important

The status mask needed for testing the value of the registered status flag named "Important" against the result of QMailMessage::status().

This flag indicates that the message is marked as important.

const quint64 & QMailMessageMetaData::ImportantElsewhere

The status mask needed for testing the value of the registered status flag named "ImportantElsewhere" against the result of QMailMessage::status().

This flag indicates that the message has been reported as having been marked as important by some other client.

const quint64 & QMailMessageMetaData::Incoming

The status mask needed for testing the value of the registered status flag named "Incoming" against the result of QMailMessage::status().

This flag indicates that the message has been sent from an external source to an account whose messages are retrieved to Qt Extended.

const quint64 & QMailMessageMetaData::Junk

The status mask needed for testing the value of the registered status flag named "Junk" against the result of QMailMessage::status().

This flag indicates that the message has been marked as junk, and should be considered unsuitable for standard listings.

const quint64 & QMailMessageMetaData::LocalOnly

The status mask needed for testing the value of the registered status flag named "LocalOnly" against the result of QMailMessage::status().

This flag indicates that the message exists only on the local device, and has no representation on any external server.

const quint64 & QMailMessageMetaData::LowPriority

The status mask needed for testing the value of the registered status flag named "LowPriority" against the result of QMailMessage::status().

This flag indicates that the message has a header field specifying that the message is low priority. This flag is set only during message parsing.

See also QMailMessage::fromRfc2822().

const quint64 & QMailMessageMetaData::New

The status mask needed for testing the value of the registered status flag named "New" against the result of QMailMessage::status().

This flag indicates that the meta data of the message has not yet been displayed to the user.

const quint64 & QMailMessageMetaData::Outbox

The status mask needed for testing the value of the registered status flag named "Outbox" against the result of QMailMessage::status().

This flag indicates that the message has been marked as ready for transmission.

const quint64 & QMailMessageMetaData::Outgoing

The status mask needed for testing the value of the registered status flag named "Outgoing" against the result of QMailMessage::status().

This flag indicates that the message originates within Qt Extended, for transmission to an external message sink.

const quint64 & QMailMessageMetaData::PartialContentAvailable

The status mask needed for testing the value of the registered status flag named "PartialContentAvailable" against the result of QMailMessage::status().

This flag indicates that some portion of the content of the message has been retrieved from the originating server.

See also QMailMessagePartContainer::contentAvailable().

const quint64 & QMailMessageMetaData::Read

The status mask needed for testing the value of the registered status flag named "Read" against the result of QMailMessage::status().

This flag indicates that the content of this message has been displayed to the user.

const quint64 & QMailMessageMetaData::ReadElsewhere

The status mask needed for testing the value of the registered status flag named "ReadElsewhere" against the result of QMailMessage::status().

This flag indicates that the content of this message has been reported as having been displayed to the user by some other client.

const quint64 & QMailMessageMetaData::ReadReplyRequested

The status mask needed for testing the value of the registered status flag named "ReadReplyRequested" against the result of QMailMessage::status().

This flag indicates that the message has requested that a read confirmation reply be returned to the sender.

const quint64 & QMailMessageMetaData::Removed

The status mask needed for testing the value of the registered status flag named "Removed" against the result of QMailMessage::status().

This flag indicates that the message has been deleted from or moved on the originating server.

const quint64 & QMailMessageMetaData::Replied

The status mask needed for testing the value of the registered status flag named "Replied" against the result of QMailMessage::status().

This flag indicates that a message replying to the source of this message has been created, in response to this message.

const quint64 & QMailMessageMetaData::RepliedAll

The status mask needed for testing the value of the registered status flag named "RepliedAll" against the result of QMailMessage::status().

This flag indicates that a message replying to the source of this message and all its recipients, has been created in response to this message.

const quint64 & QMailMessageMetaData::Sent

The status mask needed for testing the value of the registered status flag named "Sent" against the result of QMailMessage::status().

This flag indicates that the message has been delivered to an external message sink.

const quint64 & QMailMessageMetaData::Temporary

The status mask needed for testing the value of the registered status flag named "Temporary" against the result of QMailMessage::status().

This flag indicates that the message will not exist permanently and should be removed at a later time.

const quint64 & QMailMessageMetaData::TransmitFromExternal

The status mask needed for testing the value of the registered status flag named "TransmitFromExternal" against the result of QMailMessage::status().

This flag indicates that the message should be transmitted by reference to its external server location.

const quint64 & QMailMessageMetaData::Trash

The status mask needed for testing the value of the registered status flag named "Trash" against the result of QMailMessage::status().

This flag indicates that the message has been marked as trash, and should be considered logically deleted.

const quint64 & QMailMessageMetaData::UnloadedData

The status mask needed for testing the value of the registered status flag named "UnloadedData" against the result of QMailMessage::status().

This flag indicates that the meta data of the message is not loaded in entirety.


Copyright © 2010 QtSoftware
Messaging Framework