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

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

Разработчик

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

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

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

UIActionSheet

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

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

В приложениях, что целевые версии iOS до iOS 8, используйте UIActionSheet класс для подарить пользователю ряд альтернатив для того, как продолжить с данной задачей. Можно также использовать листы действия, чтобы предложить пользователю подтверждать потенциально опасное действие. Лист действия содержит дополнительный заголовок и одну или более кнопок, каждая из которых соответствует действию для взятия.

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

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

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

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

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

UIActionSheet не разработан, чтобы быть разделенным на подклассы, и при этом Вы не должны добавлять представления к его иерархии. Если необходимо подарить листу больше настройки, чем предоставленный UIActionSheet API, можно создать собственное и представить его модально с presentViewController:animated:completion:.

Создание листов действия
  • init (title:delegate:cancelButtonTitle:destructiveButtonTitle:) - initWithTitle:delegate:cancelButtonTitle:destructiveButtonTitle:otherButtonTitles:

    Инициализирует лист действия с помощью указанных стартовых параметров.

    Объявление

    Swift

    init(title title: String?, delegate delegate: UIActionSheetDelegate?, cancelButtonTitle cancelButtonTitle: String?, destructiveButtonTitle destructiveButtonTitle: String?)

    Objective C

    - (instancetype)initWithTitle:(NSString *)title delegate:(id<UIActionSheetDelegate>)delegate cancelButtonTitle:(NSString *)cancelButtonTitle destructiveButtonTitle:(NSString *)destructiveButtonTitle otherButtonTitles:(NSString *)otherButtonTitles, ...

    Параметры

    title

    Строка для отображения в области заголовка листа действия. Передача nil если Вы не хотите отображать какой-либо текст в области заголовка.

    delegate

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

    cancelButtonTitle

    Заголовок кнопки отмены. Эта кнопка добавляется к листу действия автоматически и присвоила надлежащий индекс, который доступен от cancelButtonIndex свойство. Эта кнопка выведена на экран в черном цвете, чтобы указать, что это представляет действие отмены. Указать nil если Вы не хотите кнопку отмены или представляете лист действия на iPad.

    destructiveButtonTitle

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

    otherButtonTitles, ...

    Заголовки любых дополнительных кнопок Вы хотите добавить. Этот параметр состоит из a nil- завершенный, список разделенных запятой значений строк. Например, для указания двух дополнительных кнопок Вы могли указать значение @"Button 1", @"Button 2", nil.

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

    Недавно инициализированный лист действия.

    Обсуждение

    Лист действия автоматически устанавливает появление разрушительного и кнопок отмены. Если лист действия содержит только одну кнопку, он не применяет пользовательские цвета, связанные с разрушительным и кнопками отмены.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

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

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

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

    Объявление

    Swift

    unowned(unsafe) var delegate: UIActionSheetDelegate?

    Objective C

    @property(nonatomic, assign) id< UIActionSheetDelegate > delegate

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • title Свойство

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

    Объявление

    Swift

    var title: String

    Objective C

    @property(nonatomic, copy) NSString *title

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

    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 и позже.

  • actionSheetStyle Свойство

    Стиль презентации получателя.

    Объявление

    Swift

    var actionSheetStyle: UIActionSheetStyle

    Objective C

    @property(nonatomic) UIActionSheetStyle actionSheetStyle

    Обсуждение

    Это свойство определяет, как лист действия смотрит, когда это представлено. Для списка возможных значений посмотрите UIActionSheetStyle константы.

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

    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 и позже.

    См. также

    UIActionSheet

  • 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 и позже.

    См. также

    – showInView:

  • cancelButtonIndex Свойство

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

    Объявление

    Swift

    var cancelButtonIndex: Int

    Objective C

    @property(nonatomic) NSInteger cancelButtonIndex

    Обсуждение

    Индексы кнопки запускаются в 0. Значение по умолчанию этого свойства обычно -1, который указывает, что не была установлена никакая кнопка отмены. Однако кнопка отмены может быть создана и установлена автоматически initWithTitle:delegate:cancelButtonTitle:destructiveButtonTitle:otherButtonTitles: метод. При использовании того метода для создания кнопки отмены, Вы не должны изменять значение этого свойства.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • destructiveButtonIndex Свойство

    Индекс разрушительной кнопки.

    Объявление

    Swift

    var destructiveButtonIndex: Int

    Objective C

    @property(nonatomic) NSInteger destructiveButtonIndex

    Обсуждение

    Индексы кнопки запускаются в 0. Значение по умолчанию этого свойства обычно -1, который указывает, что не была установлена никакая разрушительная кнопка. Однако разрушительная кнопка может быть создана и установлена автоматически initWithTitle:delegate:cancelButtonTitle:destructiveButtonTitle:otherButtonTitles: метод. При использовании того метода для создания разрушительной кнопки, Вы не должны изменять значение этого свойства.

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

    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, который указывает, что нет никаких других пользовательских кнопок.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Представление листа действия
  • showFromTabBar (_:) - showFromTabBar:

    Выводит на экран лист действия, происходящий из указанной панели вкладок.

    Объявление

    Swift

    func showFromTabBar(_ view: UITabBar!)

    Objective C

    - (void)showFromTabBar:(UITabBar *)view

    Параметры

    view

    Панель вкладок, из которой происходит лист действия.

    Обсуждение

    Появление листа действия анимировано.

    На iPad этот метод центрирует лист действия посреди экрана. Обычно, если Вы хотите представить лист действия относительно панели вкладок в приложении для iPad, необходимо использовать showFromRect:inView:animated: метод вместо этого.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – showFromToolbar:

  • showFromToolbar (_:) - showFromToolbar:

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

    Объявление

    Swift

    func showFromToolbar(_ view: UIToolbar!)

    Objective C

    - (void)showFromToolbar:(UIToolbar *)view

    Параметры

    view

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

    Обсуждение

    Появление листа действия анимировано.

    На iPad этот метод центрирует лист действия посреди экрана. Обычно, если Вы хотите представить лист действия относительно панели инструментов на приложении для iPad, необходимо использовать showFromBarButtonItem:animated: метод вместо этого.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – showFromTabBar:

  • showInView (_:) - showInView:

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

    Объявление

    Swift

    func showInView(_ view: UIView!)

    Objective C

    - (void)showInView:(UIView *)view

    Параметры

    view

    Представление, из которого происходит лист действия.

    Обсуждение

    Появление листа действия анимировано.

    На iPad этот метод центрирует лист действия посреди экрана. Обычно, если Вы хотите представить лист действия в приложении для iPad, необходимо использовать showFromRect:inView:animated: метод для отображения листа действия вместо этого.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • showFromBarButtonItem (_: анимированный:) - showFromBarButtonItem:animated:

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

    Объявление

    Swift

    func showFromBarButtonItem(_ item: UIBarButtonItem!, animated animated: Bool)

    Objective C

    - (void)showFromBarButtonItem:(UIBarButtonItem *)item animated:(BOOL)animated

    Параметры

    item

    Элемент кнопки панели, из которого происходит лист действия.

    animated

    Указать YEStrue анимировать представление листа действия или NOfalse представить его сразу без любых эффектов анимации.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • showFromRect (_: inView:animated:) - showFromRect:inView:animated:

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

    Объявление

    Swift

    func showFromRect(_ rect: CGRect, inView view: UIView!, animated animated: Bool)

    Objective C

    - (void)showFromRect:(CGRect)rect inView:(UIView *)view animated:(BOOL)animated

    Параметры

    rect

    Часть view из которого можно породить лист действия.

    view

    Представление, из которого можно породить лист действия.

    animated

    Указать YEStrue анимировать представление листа действия или NOfalse представить его сразу без любых эффектов анимации.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Отклонение листа действия
  • 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 и позже.

Типы данных

  • UIActionSheetStyle

    Указывает стиль листа действия.

    Объявление

    Swift

    enum UIActionSheetStyle : Int { case Automatic case Default case BlackTranslucent case BlackOpaque }

    Objective C

    typedef enum { UIActionSheetStyleAutomatic = -1, UIActionSheetStyleDefault = UIBarStyleDefault, UIActionSheetStyleBlackTranslucent = UIBarStyleBlackTranslucent, UIActionSheetStyleBlackOpaque = UIBarStyleBlackOpaque, } UIActionSheetStyle;

    Константы

    • Automatic

      UIActionSheetStyleAutomatic

      Берет появление нижней панели, если указано; иначе, то же как UIActionSheetStyleDefault.

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

    • Default

      UIActionSheetStyleDefault

      Стиль по умолчанию.

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

    • BlackTranslucent

      UIActionSheetStyleBlackTranslucent

      Черный полупрозрачный стиль.

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

    • BlackOpaque

      UIActionSheetStyleBlackOpaque

      Черный непрозрачный стиль.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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