Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

Messaging: Email
Functional Description

Messaging provides support for Email retrieval and sending. Support for retrieval via the POP3 and IMAP4 protocols and support for sending via the SMTP protocol is provided. Additionally support for encrypted and authenticated communications is provided via the SSL and TLS protocols.

Features

• Attachments
• Email Properties
• Encrypted and Authenticated Connections
• Exclusion from synchronization
• Interval Checking
• Receiving an Email
• Reply to an email message
• Sending an Email

Attachments

When composing the user can add attachments to the email being composed. Attachments can comprise any document known to the system, and they can be freely added to, or removed from, the list of attachments.

Email Properties

All email properties supported by RFC2822 are exposed via the messaging library.

The Messaging application supports:

• Message timestamp
• Sender name and address
• To, CC and BCC address lists
• Subject line
• Message body
• Attachments

Encoding is used to support the use of non-ASCII character sets in composing and viewing email messages.

Encrypted and Authenticated Connections

• Encrypted: it is possible to send and receive mail via encrypted SSL/TLS connections.
• Authenticated: POP or IMAP authentication is always attempted. SMTP authentication is supported.

Exclusion from synchronization

This feature is provided as part of the Touchscreen Phone Reference Design.

Qt Extended allows individual email folders to be excluded from mail synchronization, according to the user's selection. An excluded folder is not checked for new mail during synchronization, and any messages already present in the folder are removed when exclusion is selected. Folders nested within an excluded folder are automatically marked as excluded when their parent folder is excluded.

The email folder navigation view in the Messages application allows each folder to be individually marked for exclusion from synchronization, or to be re-included after exclusion. Excluded folders are ghosted to indicate their unsynchronized status.

Interval Checking

This feature is provided as part of the Touchscreen Phone Reference Design.

Qt Extended supports Interval Checking for Email accounts.

User Interface

1) The Email (POP and IMAP) account configuration dialog presents an 'Interval' checkbox, when checked periodic interval checking is enabled for the account. Note the 'Push Enabled' and ' Interval' checkboxes are mutually exclusive options.
2) When the 'Interval' checkbox is checked a numeric spinbox below the checkbox is enabled which allows the user to control the frequency with which the account is checked, in minutes.
3) Additionally when the 'Interval' checkbox is checked a 'Roaming interval checking' checkbox is enabled, and is checked by default. This allows the user to disable interval checking during roaming, to reduce expenses.
4) When new email is retrieved by the interval checking mechanism the user is informed by a GUI new message notification dialog.

API considerations.

The QMailAccount class exposes the following interval checking related methods:

int checkInterval() const;
void setCheckInterval(int i);

bool intervalCheckRoamingEnabled() const;
void setIntervalCheckRoamingEnabled(bool enabled);

A checkInterval of 0 indicates interval checking is disabled.

Receiving an Email

Once a user has created a valid incoming account they can connect to a mail server and download email from their email account to the device.

Messages larger than a preset size can be skipped during mail retrieval; the threshold can be set by the user. A skipped message can be later downloaded or deleted without downloading, at the user's discretion.

For IMAP accounts, the user may specify the top-level mail folder from which to receive messages.

Reply to an email message

The email viewer allows the user to:

• Reply to an email, which adds only the sender to the reply
• Reply to all, which adds the sender and all To and CC recipients to the reply

Sending an Email

It is possible for a user to compose and after creating a valid outgoing account send an email.