Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка класса MFMailComposeViewController

Опции
Развертывание Target:

На этой странице
Язык:

MFMailComposeViewController

Наследование

Соответствует

Оператор импорта

Swift

import MessageUI

Objective C

@import MessageUI;

Доступность

Доступный в iOS 3.0 и позже.

MFMailComposeViewController класс обеспечивает стандартный интерфейс, управляющий редактированием и отправкой электронного письма. Можно использовать этот контроллер представления, чтобы вывести на экран стандартное почтовое представление в приложении и заполнить поля того представления с начальными значениями, такими как предмет, почтовые получатели, основной текст и присоединения. Пользователь может отредактировать начальное содержание, которое Вы указываете и принимаете решение послать электронное письмо или отменить работу.

Используя этот интерфейс не гарантирует срочную поставку соответствующего электронного письма. Пользователь может отменить создание сообщения, и если пользователь действительно принимает решение отправить сообщение, сообщение только ставится в очередь в Почтовом ящике исходящих сообщений приложения. Это позволяет Вам генерировать электронные письма даже в ситуациях, где у пользователя нет доступа к сети, такой как в авиарежиме. Этот интерфейс не обеспечивает способ для Вас проверить, были ли фактически посланы электронные письма.

Перед использованием этого класса необходимо всегда проверять, чтобы видеть, сконфигурировано ли текущее устройство для отправки электронного письма на все использование canSendMail метод. Если устройство пользователя не устанавливается для поставки электронной почты, можно уведомить пользователя или просто отключить почтовые опции отгрузки в приложении. Вы не должны пытаться использовать этот интерфейс если canSendMail возвраты метода NOfalse.

Для отображения представления, которым управляет этот контроллер представления, можно использовать любой из стандартных методов для отображения контроллеров представления. Однако наиболее распространенный способ представить этот интерфейс, делают так модально использование presentModalViewController:animated: метод. Рисунок 1 показывает представление, выведенное на экран, когда Вы представляете почтовый интерфейс состава с некоторыми полями, уже заполненными. Для получения дополнительной информации об отображении представлений, связанных с контроллерами представления, см. Руководство по программированию Контроллера Представления для iOS.

Почтовый интерфейс состава рисунка 1The image: ../Art/mail_interface.jpg

Определение почтовой доступности
  • canSendMail () + canSendMail

    Возвращает булевскую переменную, указывающую, в состоянии ли текущее устройство послать электронное письмо.

    Объявление

    Swift

    class func canSendMail() -> Bool

    Objective C

    + (BOOL)canSendMail

    Возвращаемое значение

    YEStrue если устройство сконфигурировано для отправки электронного письма или NOfalse если это не.

    Обсуждение

    Необходимо вызвать этот метод прежде, чем попытаться вывести на экран почтовый интерфейс состава. Если это возвращается NOfalse, Вы не должны отображать почтовый интерфейс состава.

    Оператор импорта

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

    Доступный в iOS 3.0 и позже.

Установка почтовых полей программно
  • setSubject (_:) - setSubject:

    Устанавливает первоначальный текст для строки темы электронной почты.

    Объявление

    Swift

    func setSubject(_ subject: String!)

    Objective C

    - (void)setSubject:(NSString *)subject

    Параметры

    subject

    Текст для отображения в строке темы.

    Обсуждение

    Этот метод заменяет предыдущий подчиненный текст новым текстом. Необходимо вызвать этот метод перед отображением почтового интерфейса состава только. Не вызывайте его после представления интерфейса пользователю.

    Оператор импорта

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

    Доступный в iOS 3.0 и позже.

  • setToRecipients (_:) - setToRecipients:

    Устанавливает начальных получателей для включения в поле «To» электронной почты.

    Объявление

    Swift

    func setToRecipients(_ toRecipients: [AnyObject]!)

    Objective C

    - (void)setToRecipients:(NSArray *)toRecipients

    Параметры

    toRecipients

    Массив NSString объекты, каждый из которых содержит адрес электронной почты единственного получателя.

    Обсуждение

    Этот метод заменяет предыдущих получателей новыми, перечисленными в toRecipients параметр. Этот метод не отфильтровывает двойные адреса электронной почты, поэтому если копии являются существующими, многократными копиями электронного письма, может быть отправлен в тот же адрес.

    Необходимо вызвать этот метод перед отображением почтового интерфейса состава только. Не вызывайте его после представления интерфейса пользователю.

    Оператор импорта

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

    Доступный в iOS 3.0 и позже.

  • setCcRecipients (_:) - setCcRecipients:

    Устанавливает начальных получателей для включения в поле «Cc» электронной почты.

    Объявление

    Swift

    func setCcRecipients(_ ccRecipients: [AnyObject]!)

    Objective C

    - (void)setCcRecipients:(NSArray *)ccRecipients

    Параметры

    ccRecipients

    Массив NSString объекты, каждый из которых содержит адрес электронной почты единственного получателя.

    Обсуждение

    Этот метод заменяет предыдущих похожих получателей новыми, перечисленными в ccRecipients параметр. Этот метод не отфильтровывает двойные адреса электронной почты, поэтому если копии являются существующими, многократными копиями электронного письма, может быть отправлен в тот же адрес.

    Необходимо вызвать этот метод перед отображением почтового интерфейса состава только. Не вызывайте его после представления интерфейса пользователю.

    Оператор импорта

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

    Доступный в iOS 3.0 и позже.

  • setBccRecipients (_:) - setBccRecipients:

    Устанавливает начальных получателей для включения в поле «Bcc» электронной почты.

    Объявление

    Swift

    func setBccRecipients(_ bccRecipients: [AnyObject]!)

    Objective C

    - (void)setBccRecipients:(NSArray *)bccRecipients

    Параметры

    bccRecipients

    Массив NSString объекты, каждый из которых содержит адрес электронной почты единственного получателя.

    Обсуждение

    Этот метод заменяет предыдущих получателей слепой копии новыми, перечисленными в bccRecipients параметр. Этот метод не отфильтровывает двойные адреса электронной почты, поэтому если копии являются существующими, многократными копиями электронного письма, может быть отправлен в тот же адрес.

    Необходимо вызвать этот метод перед отображением почтового интерфейса состава только. Не вызывайте его после представления интерфейса пользователю.

    Оператор импорта

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

    Доступный в iOS 3.0 и позже.

  • setMessageBody (_: isHTML:) - setMessageBody:isHTML:

    Устанавливает первоначальный основной текст для включения в электронную почту.

    Объявление

    Swift

    func setMessageBody(_ body: String!, isHTML isHTML: Bool)

    Objective C

    - (void)setMessageBody:(NSString *)body isHTML:(BOOL)isHTML

    Параметры

    body

    Первоначальный основной текст сообщения. Текст интерпретируется или как простой текст или как HTML в зависимости от значения isHTML параметр.

    isHTML

    Указать YEStrue если параметр организации содержит содержимое HTML, или указать NOfalse если это содержит простой текст.

    Обсуждение

    Этот метод заменяет предыдущее содержание организации новым содержанием. Если у пользователя есть файл подписи, содержание организации сразу вставляется перед подписью. Если Вы хотите включать изображения со своим содержанием, необходимо присоединить изображения отдельно с помощью addAttachmentData:mimeType:fileName: метод.

    Необходимо вызвать этот метод перед отображением почтового интерфейса состава только. Не вызывайте его после представления интерфейса пользователю.

    Оператор импорта

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

    Доступный в iOS 3.0 и позже.

  • addAttachmentData (_: mimeType:fileName:) - addAttachmentData:mimeType:fileName:

    Добавляют указанные данные как присоединение к сообщению.

    Объявление

    Swift

    func addAttachmentData(_ attachment: NSData!, mimeType mimeType: String!, fileName filename: String!)

    Objective C

    - (void)addAttachmentData:(NSData *)attachment mimeType:(NSString *)mimeType fileName:(NSString *)filename

    Параметры

    attachment

    Данные для присоединения. Как правило, это - содержание файла, который Вы хотите включать. Этот параметр не должен быть nil.

    mimeType

    Тип MIME указанных данных. (Например, тип MIME для изображения JPEG image/jpeg.) Для списка допустимых типов MIME, посмотрите http://www .iana.org/assignments/media-types/. Этот параметр не должен быть nil.

    filename

    Предпочтительное имя файла для соединения с данными. Это - имя по умолчанию, применился к файлу, когда это передается его месту назначения. Любой разделитель пути (/) символы в имени файла преобразовываются в подчеркивание (_) символы до передачи. Этот параметр не должен быть nil.

    Обсуждение

    Этот метод присоединяет указанные данные после тела сообщения, но перед подписью пользователя. Вы можете присоединить многократные файлы (использующий различные имена файлов), но должны сделать так до отображения почтового интерфейса состава. Не вызывайте этот метод после представления интерфейса пользователю.

    Оператор импорта

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

    Доступный в iOS 3.0 и позже.

Доступ к делегату
  • mailComposeDelegate Свойство

    Почтовый состав просматривает делегата контроллера.

    Объявление

    Swift

    unowned(unsafe) var mailComposeDelegate: MFMailComposeViewControllerDelegate!

    Objective C

    @property(nonatomic, assign) id< MFMailComposeViewControllerDelegate > mailComposeDelegate

    Обсуждение

    Объект делегата ответственен за отклонение представления, представленного этим контроллером представления в подходящее время. Поэтому необходимо всегда предоставлять делегату и что объект должен реализовать методы MFMailComposeViewControllerDelegate протокол.

    Оператор импорта

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

    Доступный в iOS 3.0 и позже.

Константы
  • MFMailComposeResult

    Когда почтовый интерфейс состава отклонен, коды результата возвратились.

    Объявление

    Swift

    struct MFMailComposeResult { init(_ value: UInt32) var value: UInt32 }

    Objective C

    enum MFMailComposeResult { MFMailComposeResultCancelled, MFMailComposeResultSaved, MFMailComposeResultSent, MFMailComposeResultFailed }; typedef enum MFMailComposeResult MFMailComposeResult;

    Константы

    • MFMailComposeResultCancelled

      Пользователь отменил работу. Никакое электронное письмо не было поставлено в очередь.

      Доступный в iOS 3.0 и позже.

    • MFMailComposeResultSaved

      Электронное письмо было сохранено в Папке черновиков пользователя.

      Доступный в iOS 3.0 и позже.

    • MFMailComposeResultSent

      Электронное письмо было поставлено в очередь в ящике исходящих сообщений пользователя. Это готово отправить в следующий раз, когда пользователь соединяется с электронной почтой.

      Доступный в iOS 3.0 и позже.

    • MFMailComposeResultFailed

      Электронное письмо не было сохранено или поставлено в очередь, возможно вследствие ошибки.

      Доступный в iOS 3.0 и позже.

    Оператор импорта

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

    Доступный в iOS 3.0 и позже.

  • Ошибочный домен сообщения электронной почты

    Домен, используемый для NSError объекты связались с почтовым интерфейсом состава.

    Объявление

    Swift

    let MFMailComposeErrorDomain: String

    Objective C

    NSString *const MFMailComposeErrorDomain;

    Константы

    • MFMailComposeErrorDomain

      Ошибочный домен связался с NSError объекты.

      Доступный в iOS 3.0 и позже.

  • MFMailComposeErrorCode

    Коды ошибки для NSError объекты связались с почтовым интерфейсом состава.

    Объявление

    Swift

    struct MFMailComposeErrorCode { init(_ value: UInt32) var value: UInt32 }

    Objective C

    enum MFMailComposeErrorCode { MFMailComposeErrorCodeSaveFailed, MFMailComposeErrorCodeSendFailed }; typedef enum MFMailComposeErrorCode MFMailComposeErrorCode;

    Константы

    • MFMailComposeErrorCodeSaveFailed

      Ошибка произошла, пытаясь сохранить электронное письмо к Папке черновиков.

      Доступный в iOS 3.0 и позже.

    • MFMailComposeErrorCodeSendFailed

      Ошибка произошла при попытке поставить в очередь или отправить электронное письмо.

      Доступный в iOS 3.0 и позже.

    Оператор импорта

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

    Доступный в iOS 3.0 и позже.