Advertise here

Advertise here

Howdy, Stranger!

It looks like you're new here. If you want to get involved, click one of these buttons!

Quick Tutorial on how to add MFMailComposeViewController

iamsgtyangiamsgtyang Posts: 25Registered Users @
edited December 2011 in Tutorial Discussion
This process is fairly simple. The SDK includes the MessageUI.framework which simplifies this process to a few lines of code; don't know why you would want to send an email from the iPhone in another way.

1. Create a new View-Based Application and name it MailTutorial.

2. Import the framework “MessageUI.framework” into the project.

3. Add these lines into the MailTutorialViewController.h file.
#import <UIKit/UIKit.h>
#import <MessageUI/MessageUI.h>
#import <MessageUI/MFMailComposeViewController.h>

@interface MailTutorialViewController : UIViewController <MFMailComposeViewControllerDelegate>{

- (IBAction)actionEmailComposer;


Here we need to import <MessageUI/MessageUI.h> and the <MessageUI/MFMailComposeViewController.h>. We added the MessageUI.framework and we needed to import these two files from the framework into our viewcontrollers header. We also need to add the < MFMailComposeViewControllerDelegate>.

Now, the IBAction class method named actionEmailComposer is what’s important. You can call this method however you want in your program. Here we’re going to call this method with the UIButton created in Interface Builder to simplify it. (Save all files. Open up MailTutorialViewController.xib with Interface Builder. Drag a UIButton onto the view. Give the UIButton a title called “Mail Composer” and then click on the Connections Inspector tab. Drag “Did Touch Up Inside” to File’s Owner in the Document window and link it to actionMailComposer. Save and quit.)

4. Now add these lines into the MailTutorialViewController.m file.
#import “MailTutorialViewController.h”

@implementation MailTutorialViewController

- (void)viewDidLoad {

[super viewDidLoad];


- (IBAction)actionEmailComposer {

if ([MFMailComposeViewController canSendMail]) {

MFMailComposeViewController *mailViewController = [[MFMailComposeViewController alloc] init];
mailViewController.mailComposeDelegate = self;
[mailViewController setSubject:@"Subject Goes Here."];
[mailViewController setMessageBody:@"Your message goes here." isHTML:NO];

[self presentModalViewController:mailViewController animated:YES];
[mailViewController release];


else {

NSLog(@”Device is unable to send email in its current state.”);



-(void)mailComposeController:(MFMailComposeViewController*)controller didFinishWithResult MFMailComposeResult)result error  NSError*)error {

[self dismissModalViewControllerAnimated:YES];


- (void)didReceiveMemoryWarning {

[super didReceiveMemoryWarning];


- (void)viewDidUnload {


- (void)dealloc {

[super dealloc];


Here we added the IBAction method code. First we wanted to check if the current device’s state is able to send email so we are using a *if* function here to simply test it. MFMailComposeViewController has a method called canSendMail that returns a boolean value of YES if the device is configured for sending email or NO if it is not.

If the device is able to send emails, we created mailViewController by initializing and allocating MFMailComposeViewController and delegating the mailComposeDelegate to self.

To set the subject and body of the e-mail message, we used the setSubject and setMessageBody instance method. The class reference for the MFMailComposeViewController can be found here iPhone Dev Center: MFMailComposeViewController Class Reference

I set the isHTML for the message body to NO. You can use HTML if you want by setting it to YES.

We are presenting the mailViewController, the MFMailComposeViewController allocated, with as a modal view with presentModalViewController so when the button is clicked the mailViewController slides up to fill the screen.

The MFMailComposeViewControllerDelegate protocol has a call-back method “mailComposeController:didFinishWithResult:error:” and this method indicates if the user is finished with the mailComposerView, the MFMailComposeViewController. MFMailComposeResult provides the vales of the action of the email composer: MFMailComposeResultSent, MFMailComposeResultSaved, MFMailComposeResultCancelled and MFMailComposeResultFailed. To get more information about any failures, you can retrieve the error parameter.

Here I just want to dismiss the ModalViewController and nothing else so I’m just calling dismissModalViewControllerAnimated.

Build and Run and check it out. This is pretty simple for sending a e-mail with your iPhone with just a subject and message. Check out the class reference for MFMailComposeViewController for additional goodies.

I have the source and same step on my site here.

I haven't worked much outside of basic email on the iPhone because I haven't needed to. If you know more or can help improve this, let me know. Thanks.
Post edited by iamsgtyang on


  • ZunePodZunePod Posts: 1,031Registered Users
    edited March 2010
    You might want to do it manually if you have a bug report thing, or support thing isnide your app.
    <div align="center">Will code for food</div>
  • iamsgtyangiamsgtyang Posts: 25Registered Users @
    edited March 2010
    Ah, I never had to work in those situations before. I would just present the user with the same information filled out in the body. This gives them the option to send the report or feedback and look through the message to see what they are actually sending.

    I think I might look into sending without MFMail...
  • finefinfinefin Posts: 258Registered Users
    edited April 2010
    iamsgtyang wrote: »

    Thank you very much! It works like a charm -- although I had to take a look to your source code to find the error the compiler kept on throwing at me:
    -(void)mailComposeController:(MFMailComposeViewController*)controller didFinishWithResult MFMailComposeResult)result error  NSError*)error {
            [self dismissModalViewControllerAnimated:YES];

    naturally should be:
    -(void)mailComposeController:(MFMailComposeViewController*)controller didFinishWithResult[COLOR="Red"]:([/COLOR]MFMailComposeResult)result error[COLOR="Red"]:([/COLOR]NSError*)error {
    	[self dismissModalViewControllerAnimated:YES];

    Looks like the forum misinterpreted the ": (" for a sad smiley ---
    but look at me, I am totally :) now

    <a href=""; target="_blank">[SIGPIC][/SIGPIC]</a><br />
    I <font color="SeaGreen">help</font> you, you <font color="Orange">buy</font> my app - <font color="SeaGreen">you</font> help me, I buy <font color="Orange">your</f
  • swarnavaswarnava Posts: 1New Users
    edited July 2010
    that was ok,but my prob is i want to make that 'cc row' hidden from the screen,what should i do???i need this urgent!![:)]
  • cwiedelcwiedel Posts: 16Registered Users
    edited July 2010
    I've run into a strange problem with this and I'm hoping someone can shed some light on it.

    I set up my app to allow sending e-mail just like this. It works perfectly in the iPhone Simulator. However, when using an actual device (iPod running 3.1.3 in this case), the app winds up sort of stuck. The e-mail view comes up with the subject set, but the body isn't set, and the view is unresponsive. After a few minutes, it can detect a click on the cancel button and I can escape. Aside from that, I can't do anything.

    Any ideas?
  • HopeMediaHopeMedia Leitchfield, KY Posts: 16Registered Users *
    edited August 2010
    I have a program i have made it has a UIview and browses to a website with a few steps the onloine program creates a .pdf file and i want an iphone to be able to email that pdf that is displayed on the webpage is there a way to do that easily?
  • Roland9Roland9 Posts: 3New Users
    edited August 2010
    thanks for sharing, this is a very helpful tutorial, works like a charm :)
  • IphoneSdkIphoneSdk Posts: 1,394Registered Users @ @ @ @
    edited August 2010
    Nice Tutorial!
    <b> <a href=""; target="_blank">iOS Apps</a> | <a href=""; target="_blank">Website</a> | <a href=""; target="_blank">Twitter</a> | <a href=""; target="_blank">Facebook</a>
  • raptor85raptor85 Posts: 74Registered Users
    edited December 2011
    IphoneSdk wrote: »
    Nice Tutorial!

    i want to create something similar to this
    hi i am creating an app where there is an email label( by pressing that label a pop over will come where it asks for user to enter his email id , subject (textview) , after user enters the details there will be submit button ,when the user clicks the submit button ,( will receive the email. i wanted to know how to do it ,any help would be helpful
Sign In or Register to comment.