Platforms to show: All Mac Windows Linux Cross-Platform

MFMailComposeViewControllerMBS class

Type Topic Plugin Version macOS Windows Linux iOS Targets
class Messages MBS iOS Plugin 24.2 ❌ No ❌ No ❌ No ✅ Yes iOS only
A standard view controller, whose interface lets the user manage, edit, and send email messages.

Use this view controller to display a standard email interface inside your app. Before presenting the interface, populate the fields with initial values for the subject, email recipients, body text, and attachments of the email. After presenting the interface, the person can edit your initial values before sending the email.

The composition interface doesn’t guarantee the delivery of your email message; it only lets you construct the initial message and present it for user approval. The person may opt to cancel the composition interface which discards the message and its contents. If the person opts to send the message, the message queues in the user’s Mail app outbox. The Mail app is ultimately responsible for sending the message.

An alternate way to compose emails is to create and open a URL that uses the mailto scheme. URLs of that type go directly to the built-in Mail app, which uses your URL to configure a message. For information about the structure of mailto URLs, see Apple URL Scheme Reference.

Error Codes

Constant Value Description
MailComposeErrorCodeSaveFailed 0 An error occurred while trying to save the email message to the Drafts folder.
MailComposeErrorCodeSendFailed 1 An error occurred while trying to queue or send the email message.

Result Codes

Constant Value Description
MailComposeResultCancelled 0 The user canceled the operation.
MailComposeResultFailed 3 The email message was not saved or queued, possibly due to an error.
MailComposeResultSaved 1 The email message was saved in the user’s drafts folder.
MailComposeResultSent 2 The email message was queued in the user’s outbox.

This class has no sub classes.

Blog Entries

Release notes

Some examples using this class:

Some related classes:


The items on this page are in the following plugins: MBS iOS Plugin.


MemoryStorageMBS   -   MFMessageComposeViewControllerMBS


The biggest plugin in space...