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

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

Разработчик

Ссылка платформы UIKit ссылка класса UIAlertController

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

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

UIAlertController

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

A UIAlertController отображения объекта предупредительное сообщение пользователю. Этот класс заменяет UIActionSheet и UIAlertView классы для отображения предупреждений. После конфигурирования предупредительного контроллера с действиями и стилем Вы хотите, представляете его с помощью presentViewController:animated:completion: метод.

В дополнение к отображению сообщения пользователю можно связать действия с предупредительным контроллером, чтобы дать пользователю способ ответить. Для каждого действия Вы добавляете использование addAction: метод, предупредительный контроллер конфигурирует кнопку с подробными данными действия. Когда пользователь касается того действия, предупредительный контроллер выполняет блок, который Вы обеспечили при создании объекта действия. Перечисление 1 показывает, как сконфигурировать предупреждение с единственным действием.

Перечисление 1Configuring и представление предупреждения
  • UIAlertController* alert = [UIAlertController alertControllerWithTitle:@"My Alert"
  • message:@"This is an alert."
  • preferredStyle:UIAlertControllerStyleAlert];
  • UIAlertAction* defaultAction = [UIAlertAction actionWithTitle:@"OK" style:UIAlertActionStyleDefault
  • handler:^(UIAlertAction * action) {}];
  • [alert addAction:defaultAction];
  • [self presentViewController:alert animated:YES completion:nil];

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

Разделение на подклассы примечаний

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

Создание предупредительного контроллера
  • init (title:message:preferredStyle:) + alertControllerWithTitle:message:preferredStyle:

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

    Объявление

    Swift

    convenience init(title title: String?, message message: String?, preferredStyle preferredStyle: UIAlertControllerStyle)

    Objective C

    + (instancetype)alertControllerWithTitle:(NSString *)title message:(NSString *)message preferredStyle:(UIAlertControllerStyle)preferredStyle

    Параметры

    title

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

    message

    Описательный текст, предоставляющий дополнительную подробную информацию о причине предупреждения.

    preferredStyle

    Стиль для использования при представлении предупредительного контроллера. Используйте этот параметр для конфигурирования предупредительного контроллера как листа действия или как модальное предупреждение.

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

    Инициализированный предупредительный объект контроллера.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Конфигурирование предупреждения
  • title Свойство

    Заголовок предупреждения.

    Объявление

    Swift

    var title: String?

    Objective C

    @property(nonatomic, copy) NSString *title

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • message Свойство

    Описательный текст, предоставляющий больше подробную информацию о причине предупреждения.

    Объявление

    Swift

    var message: String?

    Objective C

    @property(nonatomic, copy) NSString *message

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • preferredStyle Свойство

    Стиль предупредительного контроллера. (только для чтения)

    Объявление

    Swift

    var preferredStyle: UIAlertControllerStyle { get }

    Objective C

    @property(nonatomic, readonly) UIAlertControllerStyle preferredStyle

    Обсуждение

    Значение этого свойства установлено в значение, которое Вы указали в alertControllerWithTitle:message:preferredStyle: метод. Это значение определяет, как предупреждение выведено на экран на экране.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Конфигурирование пользовательских действий
  • addAction (_:) - addAction:

    Присоединяет объект действия к листу действия или предупреждению.

    Объявление

    Swift

    func addAction(_ action: UIAlertAction)

    Objective C

    - (void)addAction:(UIAlertAction *)action

    Параметры

    action

    Объект действия для отображения как часть предупреждения. Действия выведены на экран как кнопки на предупреждении. Объект действия обеспечивает текст кнопки и действие, которое будет выполняться, когда касается та кнопка.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • actions Свойство

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

    Объявление

    Swift

    var actions: [AnyObject] { get }

    Objective C

    @property(nonatomic, readonly) NSArray *actions

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Конфигурирование текстовых полей
  • addTextFieldWithConfigurationHandler (_:) - addTextFieldWithConfigurationHandler:

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

    Объявление

    Swift

    func addTextFieldWithConfigurationHandler(_ configurationHandler: ((UITextField!) -> Void)!)

    Objective C

    - (void)addTextFieldWithConfigurationHandler:(void (^)(UITextField *textField))configurationHandler

    Параметры

    configurationHandler

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

    Обсуждение

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

    Можно добавить текстовое поле только если preferredStyle свойство установлено в UIAlertControllerStyleAlert.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • textFields Свойство

    Массив текстовых полей выведен на экран предупреждением. (только для чтения)

    Объявление

    Swift

    var textFields: [AnyObject]? { get }

    Objective C

    @property(nonatomic, readonly) NSArray *textFields

    Обсуждение

    Используйте это свойство для доступа к текстовым полям, выведенным на экран предупреждением. Текстовые поля находятся в порядке, в котором Вы добавили их к предупредительному контроллеру. Этот порядок также соответствует порядку, в котором они выведены на экран на предупреждении.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – addTextFieldWithConfigurationHandler:

Константы
  • UIAlertControllerStyle

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

    Объявление

    Swift

    enum UIAlertControllerStyle : Int { case ActionSheet case Alert }

    Objective C

    typedef enum UIAlertControllerStyle: NSInteger { UIAlertControllerStyleActionSheet = 0, UIAlertControllerStyleAlert } UIAlertControllerStyle;

    Константы

    • ActionSheet

      UIAlertControllerStyleActionSheet

      Лист действия вывел на экран в контексте контроллера представления, представившего его.

      Используйте лист действия для подарить пользователю ряд альтернатив для того, как продолжить с данной задачей. Можно также использовать этот стиль, чтобы предложить пользователю подтверждать потенциально опасное действие.

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

    • Alert

      UIAlertControllerStyleAlert

      Предупреждение, выведенное на экран модально для приложения.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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