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

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

Разработчик

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

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

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

UIMenuController

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

Одиночный элемент UIMenuController экземпляр представляет интерфейс меню для Сокращения, Копии, Вставки, Выбора, Выберите All и команды Delete.

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

UIResponderStandardEditActions неофициальный протокол объявляет методы, вызывающиеся, когда пользователь касается команды меню. canPerformAction:withSender: метод UIResponder также связан с меню редактирования. Респондент реализует этот метод, чтобы включить и отключить команды меню редактирования непосредственно перед тем, как меню выведено на экран. Можно вызвать это обновление включенного состояния команд меню путем вызова update метод.

Можно также обеспечить собственные пункты меню через menuItems свойство. При изменении пунктов меню можно использовать update метод, чтобы вынудить меню обновить свой дисплей.

Получение экземпляра контроллера меню
  • sharedMenuController () + sharedMenuController

    Возвращает контроллер меню.

    Объявление

    Swift

    class func sharedMenuController() -> UIMenuController

    Objective C

    + (UIMenuController *)sharedMenuController

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

    Совместно используемое NSMenuController экземпляр.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Показ и сокрытие меню
  • menuVisible Свойство

    Видимость меню редактирования.

    Объявление

    Swift

    var menuVisible: Bool

    Objective C

    @property(nonatomic, getter=isMenuVisible) BOOL menuVisible

    Обсуждение

    Установка этого свойства выводит на экран или сразу скрывает меню без анимации. Для анимации показа или сокрытия меню, используйте setMenuVisible:animated: метод. Прежде, чем показать меню, убеждаться расположить его относительно выбора.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

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

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

    Объявление

    Swift

    func setMenuVisible(_ menuVisible: Bool, animated animated: Bool)

    Objective C

    - (void)setMenuVisible:(BOOL)menuVisible animated:(BOOL)animated

    Параметры

    menuVisible

    YEStrue если меню должно быть показано, NOfalse если это должно быть скрыто.

    animated

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

    Обсуждение

    Прежде, чем показать меню, убеждаться расположить его относительно выбора. Посмотрите setTargetRect:inView: для подробных данных. Если Вы не ставите цель rect прежде, чем вывести на экран меню, это появляется в координатах экрана (0.0, 0.0).

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    menuVisible

Расположение меню
  • setTargetRect (_: inView:) - setTargetRect:inView:

    Устанавливает область в представлении, выше или ниже которого расположено меню редактирования.

    Объявление

    Swift

    func setTargetRect(_ targetRect: CGRect, inView targetView: UIView)

    Objective C

    - (void)setTargetRect:(CGRect)targetRect inView:(UIView *)targetView

    Параметры

    targetRect

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

    targetView

    Представление то, в который targetRect появляется.

    Обсуждение

    Этот целевой прямоугольник (targetRect) обычно ограничительный прямоугольник выбора. UIMenuController располагает меню редактирования выше этого прямоугольника; если существует недостаточно пространства для меню там, это располагает его ниже прямоугольника. Указатель меню помещается в центр вершины или нижнюю часть целевого прямоугольника как надлежащий. Обратите внимание на то, что, если Вы делаете ширину или высоту целевого прямоугольного нуля, UIMenuController обрабатывает целевую область как строку или точку для расположения (например, каретка вставки или единственная точка).

    Как только это установлено, целевой прямоугольник не отслеживает представление; если бы представление перемещается (те, которые произошли бы в представлении прокрутки), необходимо обновить целевой прямоугольник соответственно.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    menuFrame

  • menuFrame Свойство

    Возвращает кадр меню редактирования. (только для чтения)

    Объявление

    Swift

    var menuFrame: CGRect { get }

    Objective C

    @property(nonatomic, readonly) CGRect menuFrame

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – setTargetRect:inView:

  • arrowDirection Свойство

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

    Объявление

    Swift

    var arrowDirection: UIMenuControllerArrowDirection

    Objective C

    @property(nonatomic) UIMenuControllerArrowDirection arrowDirection

    Обсуждение

    Можно установить точки стрелки меню редактирования направления путем присвоения a UIMenuControllerArrowDirection перечислимая константа к этому свойству. Поведение по умолчанию (UIMenuControllerArrowDefault) должен подчеркнуть или вниз в объекте фокуса на основе его расположения на экране.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Обновление меню
  • обновление () - обновление

    Обновляет появление и включил состояние команд меню.

    Объявление

    Swift

    func update()

    Objective C

    - (void)update

    Обсуждение

    По умолчанию, UIMenuController вызовы этот метод как раз перед меню редактирования сделан видимым и когда касания происходят в меню. В результате объект респондента в приложении включает или отключает команды меню в зависимости от контекста; например, если бы область монтажа не содержит данных совместимого типа, команда Paste была бы отключена. Можно вызвать этот метод для принуждения обновления меню редактирования. Можно также переопределить этот метод для добавления любого пользовательского поведения.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Настройка пунктов меню
  • menuItems Свойство

    Пользовательские элементы меню для меню редактирования.

    Объявление

    Swift

    var menuItems: [AnyObject]?

    Objective C

    @property(nonatomic, copy) NSArray *menuItems

    Обсуждение

    Значение по умолчанию nil (никакие пользовательские элементы меню). Каждый пункт меню является экземпляром класса UIMenuItem. Можно создать собственные пункты меню, каждого с его собственным заголовком и селектором действия, и добавить их к меню редактирования через это свойство. Пользовательские элементы появляются в меню после любых пунктов меню системы.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Типы данных

  • UIMenuControllerArrowDirection

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

    Объявление

    Swift

    enum UIMenuControllerArrowDirection : Int { case Default case Up case Down case Left case Right }

    Objective C

    typedef enum { UIMenuControllerArrowDefault, UIMenuControllerArrowUp, UIMenuControllerArrowDown, UIMenuControllerArrowLeft, UIMenuControllerArrowRight, } UIMenuControllerArrowDirection;

    Константы

    • Default

      UIMenuControllerArrowDefault

      Стрелка подчеркивает или вниз в объекте фокуса на основе его расположения на экране.

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

    • Up

      UIMenuControllerArrowUp

      Стрелка подчеркивает в объекте фокуса.

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

    • Down

      UIMenuControllerArrowDown

      Стрелка показывает вниз на объект фокуса.

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

    • Left

      UIMenuControllerArrowLeft

      Стрелка показывает покинутая на объект фокуса.

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

    • Right

      UIMenuControllerArrowRight

      Стрелка показывает прямо на объект фокуса.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Уведомления
  • UIMenuControllerWillShowMenuNotification UIMenuControllerWillShowMenuNotification

    Отправленный контроллером меню непосредственно перед тем, как это показывает меню.

    Существует нет userInfo словарь.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • UIMenuControllerDidShowMenuNotification UIMenuControllerDidShowMenuNotification

    Отправленный контроллером меню сразу после того, как это показывает меню.

    Существует нет userInfo словарь.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • UIMenuControllerWillHideMenuNotification UIMenuControllerWillHideMenuNotification

    Отправленный контроллером меню непосредственно перед тем, как это скрывает меню.

    Существует нет userInfo словарь.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • UIMenuControllerDidHideMenuNotification UIMenuControllerDidHideMenuNotification

    Отправленный контроллером меню сразу после того, как это скрывает меню.

    Существует нет userInfo словарь.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • UIMenuControllerMenuFrameDidChangeNotification UIMenuControllerMenuFrameDidChangeNotification

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

    Существует нет userInfo словарь.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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