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

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

Разработчик

Ссылка платформы MessageUI ссылка класса MFMessageComposeViewController

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

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

MFMessageComposeViewController

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


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


Swift

import MessageUI

Objective C

@import MessageUI;

Доступность


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

MFMessageComposeViewController класс обеспечивает стандартный интерфейс пользователя системы для создания текстовых сообщений. Используйте этот класс, чтобы сконфигурировать начальных получателей и организацию сообщения при желании и сконфигурировать объект делегата реагировать на конечный результат действия пользователя — приняли ли они решение отменить или отправить сообщение. После конфигурирования начальных значений представьте контроллер представления модально с помощью presentModalViewController:animated: метод. Когда сделано, отклоните его с помощью dismissModalViewControllerAnimated: метод.

Прежде, чем представить представление состава сообщения, вызовите canSendText метод класса гарантировать, что соответственно сконфигурировано устройство пользователя. Не пытайтесь представить представление состава сообщения если canSendText возвраты метода NOfalse. Если ни iMessage, ни SMS/MMS (Служба коротких сообщений / Служба обмена мультимедийными сообщениями) поставка доступна, можно уведомить пользователя или просто отключить обменивающиеся сообщениями опции в приложении.

Можно зарегистрироваться, чтобы быть уведомленными относительно изменений в доступности сообщения, отправляющего посредством MFMessageComposeViewControllerTextMessageAvailabilityDidChangeNotification уведомление.

Ваш объект делегата ответственен за отклонение сообщения, составляют контроллер представления в messageComposeViewController:didFinishWithResult: метод. Для получения дополнительной информации о реализации этого метода, посмотрите Ссылку на протокол MFMessageComposeViewControllerDelegate.

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

    Объявление

    Swift

    class func canSendText() -> Bool

    Objective C

    + (BOOL)canSendText

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

    YEStrue если устройство может отправить текстовые сообщения или NOfalse если это не может.

    Обсуждение

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

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

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

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

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

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

    Объявление

    Swift

    class func canSendAttachments() -> Bool

    Objective C

    + (BOOL)canSendAttachments

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

    YEStrue если устройство может отправить присоединения в MMS или сообщениях iMessage, или NOfalse иначе.

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

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

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

  • Указывает, могут ли сообщения включать строки темы, согласно конфигурации пользователя в Настройках.

    Объявление

    Swift

    class func canSendSubject() -> Bool

    Objective C

    + (BOOL)canSendSubject

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

    YEStrue если устройство может включать строки темы в сообщения, или NOfalse иначе.

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

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

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

  • Указывает, может ли сообщение принять файл, с указанным UTI, как присоединение.

    Объявление

    Swift

    class func isSupportedAttachmentUTI(_ uti: String!) -> Bool

    Objective C

    + (BOOL)isSupportedAttachmentUTI:(NSString *)uti

    Параметры

    uti

    UTI (Универсальный Идентификатор типа) рассматриваемый. Посмотрите Универсальную Ссылку Идентификаторов типов

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

    YEStrue если файл с указанным UTI может быть присоединен к сообщению, или NOfalse иначе.

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

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

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

  • messageComposeDelegate Свойство

    Делегат, в которого должны быть отправлены связанные с сообщением уведомления.

    Объявление

    Swift

    unowned(unsafe) var messageComposeDelegate: MFMessageComposeViewControllerDelegate!

    Objective C

    @property(nonatomic, assign) id< MFMessageComposeViewControllerDelegate > messageComposeDelegate

    Обсуждение

    Когда пользователь касается кнопки, чтобы отправить или отменить сообщение, Ваш делегат уведомляется и должен ответить путем отклонения интерфейса состава сообщения. Для получения дополнительной информации о реализации методов Вашего объекта делегата, посмотрите Ссылку на протокол MFMessageComposeViewControllerDelegate.

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

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

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

  • recipients Свойство

    Массив строк, содержащих начальных получателей сообщения.

    Объявление

    Swift

    var recipients: [AnyObject]!

    Objective C

    @property(nonatomic, copy) NSArray *recipients

    Обсуждение

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

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

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

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

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

  • subject Свойство

    Начальный предмет сообщения.

    Объявление

    Swift

    var subject: String!

    Objective C

    @property(nonatomic, copy) NSString *subject

    Обсуждение

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

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

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

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

  • body Свойство

    Начальное содержание сообщения.

    Объявление

    Swift

    var body: String!

    Objective C

    @property(nonatomic, copy) NSString *body

    Обсуждение

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

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

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

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

  • attachments Свойство

    Возвращает массив словарей, что каждый описывает свойства присоединения. (только для чтения)

    Объявление

    Swift

    var attachments: [AnyObject]! { get }

    Objective C

    @property(nonatomic, copy, readonly) NSArray *attachments

    Обсуждение

    Каждое присоединение описано NSDictionary объект в attachments массив. Для получения альтернативного имени файла для присоединения из его словаря используйте MFMessageComposeViewControllerAttachmentAlternateFilename ключ.

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

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

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

  • Присоединяет указанный файл к сообщению.

    Объявление

    Swift

    func addAttachmentURL(_ attachmentURL: NSURL!, withAlternateFilename alternateFilename: String!) -> Bool

    Objective C

    - (BOOL)addAttachmentURL:(NSURL *)attachmentURL withAlternateFilename:(NSString *)alternateFilename

    Параметры

    attachmentURL

    Файл URL для присоединения. Не должен быть nil.

    alternateFilename

    При предоставлении строки здесь, сообщение, UI использует его для присоединения. Используйте альтернативное имя файла, чтобы лучше описать присоединение или сделать более читаемое имя.

    OK для использования a nil значение, когда фактическое имя файла присоединения выведено на экран в сообщении UI.

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

    YEStrue если присоединение в указанном URL было успешно добавлено к сообщению, или NOfalse иначе.

    Обсуждение

    Можно добавить нуль или больше присоединений к сообщению перед отображением сообщения пользователю. К информации о доступе о присоединениях сообщения получите доступ attachments свойство.

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

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

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

  • Присоединяет произвольное содержание к сообщению.

    Объявление

    Swift

    func addAttachmentData(_ attachmentData: NSData!, typeIdentifier uti: String!, filename filename: String!) -> Bool

    Objective C

    - (BOOL)addAttachmentData:(NSData *)attachmentData typeIdentifier:(NSString *)uti filename:(NSString *)filename

    Параметры

    attachmentData

    Содержание в форме NSData возразите для присоединения к сообщению. Не должен быть nil.

    uti

    Допустимый Uniform Type Identifier (UTI), подходящий для присоединяемых данных. Посмотрите Универсальную Ссылку Идентификаторов типов. Не должен быть nil.

    filename

    Имя для представления пользователю, в сообщении UI, для присоединения данных.

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

    YEStrue если присоединяемые данные были успешно добавлены к сообщению, или NOfalse иначе.

    Обсуждение

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

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

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

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

  • Отключает кнопку камеры/присоединения в представлении состава сообщения.

    Объявление

    Swift

    func disableUserAttachments()

    Objective C

    - (void)disableUserAttachments

    Обсуждение

    В iOS 7.0 и позже, вызовите этот метод для отключения кнопки камеры/присоединения в представлении состава сообщения. В приложении, соединенном против более старой версии iOS, кнопка камеры/присоединения не доступна в любом случае.

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

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

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

Типы данных

  • Эти константы описывают результат интерфейса состава сообщения.

    Объявление

    Swift

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

    Objective C

    enum MessageComposeResult { MessageComposeResultCancelled, MessageComposeResultSent, MessageComposeResultFailed }; typedef enum MessageComposeResult MessageComposeResult;

    Константы

    • MessageComposeResultCancelled

      Пользователь отменил состав.

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

    • MessageComposeResultSent

      Пользователь успешно поставил в очередь или отправил сообщение.

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

    • MessageComposeResultFailed

      Попытка пользователя сохранить или отправить сообщение была неуспешна.

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

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

    Objective C

    @import MessageUI;

    Swift

    import MessageUI

    Доступность

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

  • A userInfo ключ словаря для MFMessageComposeViewControllerTextMessageAvailabilityDidChangeNotification уведомление.

    Объявление

    Swift

    let MFMessageComposeViewControllerTextMessageAvailabilityKey: String

    Objective C

    NSString *const MFMessageComposeViewControllerTextMessageAvailabilityKey;

    Константы

    • MFMessageComposeViewControllerTextMessageAvailabilityKey

      Значение этого ключа NSNumber объект, содержащий булево значение. Это значение соответствует результат canSendText метод класса.

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

  • URL для элемента, присоединенного к сообщению.

    Объявление

    Swift

    let MFMessageComposeViewControllerAttachmentURL: String

    Objective C

    NSString *const MFMessageComposeViewControllerAttachmentURL;

    Константы

    • MFMessageComposeViewControllerAttachmentURL

      URL для элемента, присоединенного к сообщению.

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

  • Ключ для альтернативного имени файла для основанного на файле элемента, присоединенного к сообщению.

    Объявление

    Swift

    let MFMessageComposeViewControllerAttachmentAlternateFilename: String

    Objective C

    NSString *const MFMessageComposeViewControllerAttachmentAlternateFilename;

    Константы

    • MFMessageComposeViewControllerAttachmentAlternateFilename

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

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