This document just serves as draft for developing a QML Mail API.






Message {



This Composer Api will be exposed through QML. The backend contains the basic functions of a message composer. This will be further extended in future. We already have implemented the following till now:

  • the send function
  • receive from, body, subject
  • receiver model and an attachment model ( which is being re-used from the present kmail composer)

The complete basic Api plan is as follows:


Q_PROPERTY(QString identity ....)
Q_PROPERTY(ReceiverModel *toModel .... CONSTANT)
Q_PROPERTY(ReceiverModel *ccModel .... CONSTANT)
Q_PROPERTY(ReceiverModel *bccModel ... CONSTANT)
Q_PROPERTY(QString subject ....)
Q_PROPERTY(QString body ....)
Q_PROPERTY(QString from ....)
Q_PROPERTY(AttachmentModel *attachmentModel .... CONSTANT)


void subject()

Recieves the text input as QString from the editor in QML for subject

void body()

Recieves the text input as QString from the editor in QML for body.

void replyTo()

Will set the address of receiver. It will also be received as QString. Recepient count will be set.

void from()

Sets the sender's address.

void cc()

Sets the CC field in recepients list.

void bcc()

Sets the BCC field in the recepients list.


void addAttachment()

Adds attachments to the message using KMime content part.

void insertSignature()

Inserts saved signature.

void send()

Will send the message using MessageComposer::MessageSender

void saveDraft()

Saves the created text message as draft.

void sendLater()

Queues the message to be sent later.

void forward()

Forwards a received mail.

void replySender()

Composes mail with the sender's address in reply field

void replyToAll()

Sends the message to multiple selected recipients.

void replyToMailingList()

Sends the message to mailing list.

This page was last edited on 27 June 2014, at 16:08. Content is available under Creative Commons License SA 4.0 unless otherwise noted.