#include <mw/miuthdr.h>
class TMsvEmailEntry : public TMsvEntry |
Provides storage for and access to extra email specific information for a message.
To get a TMsvEmailEntry, get the entry's TMsvEntry, e.g. using CMsvEntry::Entry(), and use the constructor that takes a TMsvEntry parameter.
Many of the flags are only used by IMAP4 entries. These can be grouped as follows:
GetIMAP4Flags() and SetIMAP4Flags() handle all the flags as a group
\Seen flag: SetSeenIMAP4Flag(), SeenIMAP4Flag().
\Answered flag: SetAnsweredIMAP4Flag(), AnsweredIMAP4Flag()
\Flagged flag: SetFlaggedIMAP4Flag(), FlaggedIMAP4Flag()
\Deleted flag: SetDeletedIMAP4Flag(), DeletedIMAP4Flag()
\Draft flag: SetDraftIMAP4Flag(), DraftIMAP4Flag()
\Recent flag: SetRecentIMAP4Flag(), RecentIMAP4Flag()
The following flags are set only by the IMAP MTM. They indicate if the message contains a vCard, vCalendar (http://www.imc.org), or iCalendar (RFC 2445) attachment.
The following flags apply to all email protocols:
Receipt requested: Receipt(), SetReceipt()
MHTML content: MHTMLEmail(), SetMHTMLEmail()
Note that the email specific data is stored in the reserved data members iMtmData1, iMtmData2 and iMtmData3 of the TMsvEntry base class. These public data members must not be directly altered by clients.
See also: CImap4ClientMtm
IMPORT_C | TMsvEmailEntry | ( | ) |
IMPORT_C | TMsvEmailEntry | ( | const TMsvEntry & | aGenericEntry | ) |
TBool | AnsweredIMAP4Flag | ( | ) | const [inline] |
Gets the state of the \Answered IMAP4 flag.
This indicates if the message has been answered. It is described in RFC3501, 2.3.2. Flags Message Attribute.
TBool | BodyTextComplete | ( | ) | const [inline] |
Tests if body text is complete.
TBool | DeletedIMAP4Flag | ( | ) | const [inline] |
Gets the state of the \Deleted IMAP4 flag.
This indicates if the message is marked as deleted for removal later. It is described in RFC3501, 2.3.2. Flags Message Attribute.
IMPORT_C TImDisconnectedOperationType | DisconnectedOperation | ( | ) | const |
TBool | DraftIMAP4Flag | ( | ) | const [inline] |
Gets the state of the \Draft IMAP4 flag.
This indicates if the message has not completed composition. It is described in RFC3501, 2.3.2. Flags Message Attribute.
TBool | Encrypted | ( | ) | const [inline] |
Tests whether encryption is used.
Not currently used.
TBool | FlaggedIMAP4Flag | ( | ) | const [inline] |
Gets the state of the \Flagged IMAP4 flag.
This indicates if the message is flagged for urgent/special attention. It is described in RFC3501, 2.3.2. Flags Message Attribute.
IMPORT_C void | GetIMAP4Flags | ( | TBool & | rUnread, |
TBool & | rSeen, | |||
TBool & | rAnswered, | |||
TBool & | rFlagged, | |||
TBool & | rDeleted, | |||
TBool & | rDraft, | |||
TBool & | rRecent | |||
) |
TBool | ICalendar | ( | ) | const [inline] |
Tests if the message contains an iCalendar attachment.
TBool | LocalSubscription | ( | ) | const [inline] |
Gets the IMAP4 local subscription state for the specified folder.
TBool | MHTMLEmail | ( | ) | const [inline] |
Returns the flag indicating if the message has an HTML body part.
Note: the flag is for HTML and not only MHTML.
Use CImEmailMessage to retrieve the HTML body part.
See also: CImEmailMessage
TBool | Mailbox | ( | ) | const [inline] |
Tests if the specified folder is the IMAP4 Mailbox.
IMPORT_C TImEmailFolderType | MessageFolderType | ( | ) | const |
TBool | Orphan | ( | ) | const [inline] |
Gets the IMAP4 orphaned state for the specified message/folder.
The concept of an orphan is no longer used, so this function should not be used.
IMPORT_C TBool | PartialDownloaded | ( | ) | const |
TBool | Receipt | ( | ) | const [inline] |
Tests if the email message requests a receipt.
TBool | RecentIMAP4Flag | ( | ) | const [inline] |
Gets the state of the \Recent IMAP4 flag.
This indicates if the message is "recently" arrived in this mailbox. This session is the first session to have been notified about this message. For more details, see see RFC3501, 2.3.2. Flags Message Attribute.
TInt | RemoteFolderEntries | ( | ) | const [inline] |
Gets the number of messages stored in the remote folder.
TBool | SeenIMAP4Flag | ( | ) | const [inline] |
Gets the state of the \Seen IMAP4 flag.
This indicates if the message has been read. It is described in RFC3501, 2.3.2. Flags Message Attribute.
Note that the server MTM creates messages with the TMsvEntry::Unread() flag set. If on synchronisation a folder contains new messages, the Unread flag will also be set on the folder.
See also: CImImap4Settings::UpdatingSeenFlags()
void | SetAnsweredIMAP4Flag | ( | TBool | aAnswered | ) | [inline] |
Sets the state of the \Answered IMAP4 flag.
Parameters | |
---|---|
aAnswered | \Answered IMAP4 flag |
void | SetBodyTextComplete | ( | TBool | aFlag | ) | [inline] |
Sets if body text is complete.
Parameters | |
---|---|
aFlag | True if body text is complete. |
void | SetDeletedIMAP4Flag | ( | TBool | aDeleted | ) | [inline] |
Sets the state of the \Deleted IMAP4 flag.
Parameters | |
---|---|
aDeleted | \Deleted IMAP4 flag |
IMPORT_C void | SetDisconnectedOperation | ( | TImDisconnectedOperationType | aDisconnectedOperationType | ) |
void | SetDraftIMAP4Flag | ( | TBool | aDraft | ) | [inline] |
Sets the state of the \Draft IMAP4 flag.
Parameters | |
---|---|
aDraft | \Draft IMAP4 flag |
void | SetEncrypted | ( | TBool | aEncrypt | ) | [inline] |
Sets whether encryption is used.
Not currently used.
Parameters | |
---|---|
aEncrypt | True if encryption is used |
void | SetFlaggedIMAP4Flag | ( | TBool | aFlagged | ) | [inline] |
Sets the state of the \Flagged IMAP4 flag.
Parameters | |
---|---|
aFlagged | \Flagged IMAP4 flag |
void | SetICalendar | ( | TBool | aICal | ) | [inline] |
Sets a flag that the message contains an iCalendar attachment.
Parameters | |
---|---|
aICal | True if the message contains an iCalendar attachment |
IMPORT_C void | SetIMAP4Flags | ( | TBool | aUnread, |
TBool | aSeen, | |||
TBool | aAnswered, | |||
TBool | aFlagged, | |||
TBool | aDeleted, | |||
TBool | aDraft, | |||
TBool | aRecent | |||
) |
void | SetLocalSubscription | ( | TBool | aLocal | ) | [inline] |
Sets the IMAP4 local subscription state for the specified folder.
Depending on other settings, setting a folder to be locally subscribed can mean:
that the folder is synchronised as part of synchronisation operations (depending on the value of CImImap4Settings::Synchronise())
that the folder will be set as subscribed on the remote server (depending on the value of CImImap4Settings::SetSuscribe())
Note that clients can use the #KIMAP4MTMLocalSubscribe command to set this flag and save the change to the entry.
Parameters | |
---|---|
aLocal | IMAP4 local subscription state |
void | SetMHTMLEmail | ( | TBool | aMhtml | ) | [inline] |
Sets the flag indicating if the message has an HTML body part.
Note: the flag is for HTML and not only MHTML.
Use CImEmailMessage to retrieve the HTML body part.
See also: CImEmailMessage
Parameters | |
---|---|
aMhtml | True if the message has an HTML body part |
void | SetMailbox | ( | TBool | aMailbox | ) | [inline] |
Sets if the specified folder is the IMAP4 Mailbox.
Parameters | |
---|---|
aMailbox | True if the specified folder is the Mailbox |
IMPORT_C void | SetMessageFolderType | ( | TImEmailFolderType | aFolderType | ) |
void | SetOrphan | ( | TBool | aOrphan | ) | [inline] |
Sets the IMAP4 orphaned state for the specified message/folder.
The concept of an orphan is no longer used, so this function should not be used.
Parameters | |
---|---|
aOrphan | True if the specified entry is orphaned |
IMPORT_C void | SetPartialDownloaded | ( | TBool | aPartialDownloaded | ) |
void | SetReceipt | ( | TBool | aReceipt | ) | [inline] |
Sets a flag that the email message requests a receipt.
Parameters | |
---|---|
aReceipt | True if the email message requests a receipt |
void | SetRecentIMAP4Flag | ( | TBool | aRecent | ) | [inline] |
Sets the state of the \Recent IMAP4 flag.
Parameters | |
---|---|
aRecent | \Recent IMAP4 flag |
void | SetRemoteFolderEntries | ( | TInt | aEntries | ) | [inline] |
Sets the number of messages stored in the remote folder.
Parameters | |
---|---|
aEntries | Number of messages |
void | SetSeenIMAP4Flag | ( | TBool | aSeen | ) | [inline] |
Sets the state of the \Seen IMAP4 flag.
Parameters | |
---|---|
aSeen | \Seen IMAP4 flag |
void | SetSigned | ( | TBool | aSignature | ) | [inline] |
Sets whether signing is used.
Not currently used.
Parameters | |
---|---|
aSignature | True if signing is used |
void | SetSubscribed | ( | TBool | aSubscribed | ) | [inline] |
Sets the IMAP4 subscription state for the specified folder.
Parameters | |
---|---|
aSubscribed | IMAP4 subscription state |
void | SetUID | ( | TUint32 | aUid | ) | [inline] |
Sets the IMAP4 UID (unique identifier) for the specified message/folder.
Parameters | |
---|---|
aUid | IMAP4 UID |
void | SetUnreadIMAP4Flag | ( | TBool | aUnread | ) | [inline] |
Sets the state of the unread messages IMAP4 flag.
Parameters | |
---|---|
aUnread | Unread messages IMAP4 flag |
void | SetVCalendar | ( | TBool | aVCal | ) | [inline] |
Sets a flag that the message contains a VCal attachment.
Parameters | |
---|---|
aVCal | True if the message contains a VCal attachment |
void | SetVCard | ( | TBool | aVCard | ) | [inline] |
Sets a flag that the message contains a VCard attachment.
Parameters | |
---|---|
aVCard | True if the message contains a VCard attachment |
void | SetValidUID | ( | TBool | aValid | ) | [inline] |
Sets the IMAP4 UID (unique identifier) validity for the specified folder.
Parameters | |
---|---|
aValid | True if IMAP4 UID validity is set |
TBool | Signed | ( | ) | const [inline] |
Tests whether signing is used.
Not currently used.
TBool | Subscribed | ( | ) | const [inline] |
Gets the IMAP4 subscription state for the specified folder.
TUint32 | UID | ( | ) | const [inline] |
Gets the IMAP4 UID (unique identifier) for the specified message/folder.
TBool | UnreadIMAP4Flag | ( | ) | const [inline] |
Gets the state of the unread messages IMAP4 flag.
This flag is set on a folder if the folder contains any messages with the IMAP \Seen flag set.
See also: TMsvEmailEntry::SeenIMAP4Flag()
TBool | VCalendar | ( | ) | const [inline] |
Tests if the message contains a VCal attachment.
TBool | VCard | ( | ) | const [inline] |
Tests if the message contains a VCard attachment.
TBool | ValidUID | ( | ) | const [inline] |
Gets the IMAP4 UID (unique identifier) validity for the specified folder.