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

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

Разработчик

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

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

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

UIAlertView

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

Важный: UIAlertView осуждается в iOS 8. (Обратите внимание на то, что UIAlertViewDelegate также осуждается.), Чтобы создать и управлять предупреждениями в iOS 8 и позже, вместо этого используйте UIAlertController с a preferredStyle из UIAlertControllerStyleAlert.

В приложениях, работающих в версиях iOS до iOS 8, используйте UIAlertView класс для отображения предупредительного сообщения пользователю. Предупредительное представление функционирует подобное, но отличается по внешности от листа действия (экземпляр UIActionSheet).

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

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

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

Для получения дополнительной информации о появлении и конфигурации поведения, посмотрите Предупредительные Представления.

Создание предупредительных представлений
  • init (title:message:delegate:cancelButtonTitle:) - initWithTitle:message:delegate:cancelButtonTitle:otherButtonTitles:

    Удобный метод для инициализации предупредительного представления.

    Объявление

    Swift

    init(title title: String?, message message: String?, delegate delegate: AnyObject?, cancelButtonTitle cancelButtonTitle: String?)

    Objective C

    - (instancetype)initWithTitle:(NSString *)title message:(NSString *)message delegate:(id)delegate cancelButtonTitle:(NSString *)cancelButtonTitle otherButtonTitles:(NSString *)otherButtonTitles,, ...

    Параметры

    title

    Строка, появляющаяся в строке заголовка получателя.

    message

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

    delegate

    Делегат получателя или nil если это не имеет делегата.

    cancelButtonTitle

    Заголовок кнопки отмены или nil если нет никакой кнопки отмены.

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

    otherButtonTitles,

    Заголовок другой кнопки.

    Используя этот параметр эквивалентно вызову addButtonWithTitle: с этим заголовком для добавления большего количества кнопок.

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

    ...

    Заголовки дополнительных кнопок для добавления к получателю, завершенному с nil.

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

    Недавно инициализированное предупредительное представление.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    Не доступный в расширениях приложения.

    См. также

    – addButtonWithTitle:

Установка свойств
  • delegate Свойство

    Делегат получателя или nil если это не имеет делегата.

    Объявление

    Swift

    unowned(unsafe) var delegate: AnyObject?

    Objective C

    @property(nonatomic, assign) id delegate

    Обсуждение

    Посмотрите Ссылку на протокол UIAlertViewDelegate для методов, которые должен реализовать этот делегат.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • alertViewStyle Свойство

    Вид предупреждения, выведенного на экран пользователю.

    Объявление

    Swift

    var alertViewStyle: UIAlertViewStyle

    Objective C

    @property(nonatomic, assign) UIAlertViewStyle alertViewStyle

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • title Свойство

    Строка, появляющаяся в строке заголовка получателя.

    Объявление

    Swift

    var title: String

    Objective C

    @property(nonatomic, copy) NSString *title

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • message Свойство

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

    Объявление

    Swift

    var message: String?

    Objective C

    @property(nonatomic, copy) NSString *message

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • visible Свойство

    Булево значение, указывающее, выведен ли получатель на экран. (только для чтения)

    Объявление

    Swift

    var visible: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isVisible) BOOL visible

    Обсуждение

    Если YEStrue, получатель выведен на экран; иначе, NOfalse.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Конфигурирование кнопок
  • addButtonWithTitle (_:) - addButtonWithTitle:

    Добавляет кнопка к получателю с данным заголовком.

    Объявление

    Swift

    func addButtonWithTitle(_ title: String) -> Int

    Objective C

    - (NSInteger)addButtonWithTitle:(NSString *)title

    Параметры

    title

    Заголовок новой кнопки.

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

    Индекс новой кнопки. Индексы кнопки запускаются в 0 и увеличение порядка они добавляются.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    сообщение

  • numberOfButtons Свойство

    Число кнопок начеку просматривает. (только для чтения)

    Объявление

    Swift

    var numberOfButtons: Int { get }

    Objective C

    @property(nonatomic, readonly) NSInteger numberOfButtons

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • buttonTitleAtIndex (_:) - buttonTitleAtIndex:

    Возвращает заголовок кнопки в данном индексе.

    Объявление

    Swift

    func buttonTitleAtIndex(_ buttonIndex: Int) -> String!

    Objective C

    - (NSString *)buttonTitleAtIndex:(NSInteger)buttonIndex

    Параметры

    buttonIndex

    Индекс кнопки. Индексы кнопки запускаются в 0.

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

    Заголовок кнопки указан индексом buttonIndex.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    «Отображение»

  • textFieldAtIndex (_:) - textFieldAtIndex:

    Возвращает текстовое поле в данном индексе

    Объявление

    Swift

    func textFieldAtIndex(_ textFieldIndex: Int) -> UITextField?

    Objective C

    - (UITextField *)textFieldAtIndex:(NSInteger)textFieldIndex

    Параметры

    textFieldIndex

    Индекс текстового поля. Индексы текстового поля запускаются в 0.

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

    Текстовое поле указано индексом textFieldIndex.

    Обсуждение

    Число настоящего текстовых полей на предупреждении зависит от стиля предупреждения.

    Предупредительный стиль

    Текстовые поля

    UIAlertViewStyleDefault

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

    UIAlertViewStyleSecureTextInput

    Единственное текстовое поле в индексе 0.

    UIAlertViewStylePlainTextInput

    Единственное текстовое поле в индексе 0.

    UIAlertViewStyleLoginAndPasswordInput

    Поле входа в систему в индексе 0. Поле пароля в индексе 1.

    Если Ваше приложение пытается получить текстовое поле с индексом, выходящим за пределы, предупреждение повышает NSRangeException.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • cancelButtonIndex Свойство

    Индекс кнопки отмены.

    Объявление

    Swift

    var cancelButtonIndex: Int

    Objective C

    @property(nonatomic) NSInteger cancelButtonIndex

    Обсуждение

    Индексы кнопки запускаются в 0. Если -1, тогда индекс не установлен.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • firstOtherButtonIndex Свойство

    Индекс первой другой кнопки. (только для чтения)

    Объявление

    Swift

    var firstOtherButtonIndex: Int { get }

    Objective C

    @property(nonatomic, readonly) NSInteger firstOtherButtonIndex

    Обсуждение

    Индексы кнопки запускаются в 0. Если -1, тогда индекс не установлен. Если нет никаких других кнопок, это свойство проигнорировано. Значение по умолчанию -1.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Отображение
  • покажите () - показать

    Выводит на экран получатель с помощью анимации.

    Объявление

    Swift

    func show()

    Objective C

    - (void)show

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Отклонение
  • dismissWithClickedButtonIndex (_: анимированный:) - dismissWithClickedButtonIndex:animated:

    Отклоняет получатель, дополнительно с анимацией.

    Объявление

    Swift

    func dismissWithClickedButtonIndex(_ buttonIndex: Int, animated animated: Bool)

    Objective C

    - (void)dismissWithClickedButtonIndex:(NSInteger)buttonIndex animated:(BOOL)animated

    Параметры

    buttonIndex

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

    animated

    YEStrue если получатель должен быть демонтирован путем анимации его сначала; иначе, NOfalse если это должно быть сразу удалено без анимации.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Константы
  • UIAlertViewStyle

    Стиль презентации предупреждения.

    Объявление

    Swift

    enum UIAlertViewStyle : Int { case Default case SecureTextInput case PlainTextInput case LoginAndPasswordInput }

    Objective C

    typedef enum { UIAlertViewStyleDefault = 0, UIAlertViewStyleSecureTextInput, UIAlertViewStylePlainTextInput, UIAlertViewStyleLoginAndPasswordInput } UIAlertViewStyle;

    Константы

    • Default

      UIAlertViewStyleDefault

      Стандартное предупреждение.

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

    • SecureTextInput

      UIAlertViewStyleSecureTextInput

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

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

    • PlainTextInput

      UIAlertViewStylePlainTextInput

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

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

    • LoginAndPasswordInput

      UIAlertViewStyleLoginAndPasswordInput

      Предупреждение, позволяющее пользователю вводить идентификатор для входа в систему и пароль.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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