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

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

Разработчик

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

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

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

UIResponder

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

UIResponder класс определяет интерфейс для объектов, отвечающих на и обрабатывающих события. Это - суперкласс UIApplication, UIView и его подклассы (которые включают UIWindow). Экземпляры этих классов иногда упоминаются, поскольку респондент возражает или, просто, респонденты.

Существует два общих вида событий: сенсорные события и события движения. Основные методы обработки событий для касаний touchesBegan:withEvent:, touchesMoved:withEvent:, touchesEnded:withEvent:, и touchesCancelled:withEvent:. Параметры этих касаний партнера методов с их событиями — €” особенно затрагивают, которые являются новыми или изменились — €” и таким образом позволяют объектам респондента отследить и обработать касания, в то время как поставленные события развиваются через фазы мультисенсорной последовательности. Любое время палец касается экрана, перетаскивается на экране или поднимается с экрана, a UIEvent объект сгенерирован. Объект-событие содержит UITouch объекты для всех пальцев на экране или просто снятый с него.

iOS 3.0 представил системные возможности генерации событий движения, в частности движение сотрясения устройства. Методы обработки событий для этих видов событий motionBegan:withEvent:, motionEnded:withEvent:, и motionCancelled:withEvent:. Дополнительно для iOS 3.0, canPerformAction:withSender: метод позволяет респондентам проверять команды в пользовательском интерфейсе в то время как undoManager свойство возвращает самое близкое NSUndoManager объект в цепочке респондента.

В iOS 4.0, UIResponder добавленный remoteControlReceivedWithEvent: метод для обработки событий дистанционного управления.

Управление цепочкой респондента
  • nextResponder () - nextResponder

    Возвращает получатель' €™ s следующий респондент, или nil если это не имеет ни одного.

    Объявление

    Swift

    func nextResponder() -> UIResponder?

    Objective C

    - (UIResponder *)nextResponder

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

    Следующий объект в цепочке респондента, которой подарят событие для обработки.

    Обсуждение

    UIResponder класс не хранит или установить следующего респондента автоматически, вместо этого возвратившись nil по умолчанию. Подклассы должны переопределить этот метод для установки следующего респондента. UIView реализации этот метод путем возврата UIViewController объект, управляющий им (если это имеет один) или его суперпредставление (если это не делает); UIViewController реализует метод путем возврата суперпредставления его представления; UIWindow возвращает объект приложения, и UIApplication возвраты nil.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – isFirstResponder

  • isFirstResponder () - isFirstResponder

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

    Объявление

    Swift

    func isFirstResponder() -> Bool

    Objective C

    - (BOOL)isFirstResponder

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

    YEStrue если получатель является первым респондентом, NOfalse иначе.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – becomeFirstResponder
    – resignFirstResponder

  • canBecomeFirstResponder () - canBecomeFirstResponder

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

    Объявление

    Swift

    func canBecomeFirstResponder() -> Bool

    Objective C

    - (BOOL)canBecomeFirstResponder

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

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

    Обсуждение

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – becomeFirstResponder

  • becomeFirstResponder () - becomeFirstResponder

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

    Объявление

    Swift

    func becomeFirstResponder() -> Bool

    Objective C

    - (BOOL)becomeFirstResponder

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

    YEStrue если получатель принимает состояние первого респондента или NOfalse если это отказывается от этого состояния. Возвраты реализации по умолчанию YEStrue, принятие первого состояния респондента.

    Обсуждение

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

    Объект респондента только становится первым респондентом, если текущий респондент может оставить состояние первого респондента (canResignFirstResponder) и новый респондент может стать первым респондентом.

    Можно вызвать этот метод для создания объекта респондента, такого как представление первый респондент. Однако необходимо только вызвать его на том представлении, если это - часть иерархии представления. Если представление window свойство содержит a UIWindow объект, это было установлено в иерархии представления; если это возвращается nil, представление отсоединяется от любой иерархии.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – isFirstResponder
    – canBecomeFirstResponder

  • canResignFirstResponder () - canResignFirstResponder

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

    Объявление

    Swift

    func canResignFirstResponder() -> Bool

    Objective C

    - (BOOL)canResignFirstResponder

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

    YEStrue если получатель может оставить состояние первого респондента, NOfalse иначе.

    Обсуждение

    Возвраты YEStrue по умолчанию. Как пример, текстовое поле посреди редактирования могло бы хотеть реализовать этот метод для возврата NOfalse сохранить себя активным во время редактирования.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – resignFirstResponder

  • resignFirstResponder () - resignFirstResponder

    Уведомляет получатель, что попросили оставить его состояние как первого респондента в его окне.

    Объявление

    Swift

    func resignFirstResponder() -> Bool

    Objective C

    - (BOOL)resignFirstResponder

    Обсуждение

    Возвраты реализации по умолчанию YEStrue, отставка первого состояния респондента. Подклассы могут переопределить этот метод, чтобы обновить состояние или выполнить некоторое действие, такое как невыделение выбора или возвратиться NOfalse, отказ оставить первое состояние респондента. При переопределении этого метода необходимо вызвать super (реализация суперкласса) в некоторый момент в Вашем коде.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – isFirstResponder
    – canResignFirstResponder

Управление входными представлениями
  • inputView Свойство

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

    Объявление

    Swift

    var inputView: UIView? { get }

    Objective C

    @property(nonatomic, readonly, retain) UIView *inputView

    Обсуждение

    Это свойство обычно используется для обеспечения представления для замены предоставленной систему клавиатуры, представленной для UITextField и UITextView объекты.

    Значение этого свойства только для чтения nil. Объект респондента, требующий, чтобы пользовательское представление собрало ввод от пользователя, должен повторно объявить это свойство как чтение-запись и использовать его для управления его пользовательским входным представлением. Когда получатель становится первым респондентом, инфраструктура респондента представляет указанное входное представление автоматически. Точно так же, когда получатель оставляет свое первое состояние респондента, инфраструктура респондента автоматически отклоняет указанное входное представление.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    inputViewController

  • inputViewController Свойство

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

    Объявление

    Swift

    var inputViewController: UIInputViewController? { get }

    Objective C

    @property(nonatomic, readonly, retain) UIInputViewController *inputViewController

    Обсуждение

    Это свойство обычно используется для обеспечения контроллера представления для замены предоставленной систему клавиатуры, представленной для UITextField и UITextView объекты.

    Значение этого свойства только для чтения nil. Если Вы хотите обеспечить пользовательский входной контроллер представления для замены системной клавиатуры в приложении, повторно объявите это свойство как чтение-запись в a UIResponder подкласс.. Можно тогда использовать это свойство для управления пользовательским входным контроллером представления. Когда получатель становится первым респондентом, инфраструктура респондента представляет указанный входной контроллер представления автоматически. Точно так же, когда получатель оставляет свое первое состояние респондента, инфраструктура респондента автоматически отклоняет указанный входной контроллер представления.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    inputView

  • inputAccessoryView Свойство

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

    Объявление

    Swift

    var inputAccessoryView: UIView? { get }

    Objective C

    @property(nonatomic, readonly, retain) UIView *inputAccessoryView

    Обсуждение

    Это свойство обычно используется для присоединения вспомогательного представление к предоставленной систему клавиатуре, представленной для UITextField и UITextView объекты.

    Значение этого свойства только для чтения nil. Если Вы хотите присоединить пользовательские элементы управления к предоставленному систему входному представлению (такие как системная клавиатура) или к пользовательскому входному представлению (один, Вы обеспечиваете в inputView свойство), повторно объявите это свойство как чтение-запись в a UIResponder подкласс. Можно тогда использовать это свойство для управления пользовательским вспомогательным представление. Когда получатель становится первым респондентом, инфраструктура респондента присоединяет вспомогательное представление к надлежащему входному представлению прежде, чем вывести на экран его.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    inputAccessoryViewController

  • inputAccessoryViewController Свойство

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

    Объявление

    Swift

    var inputAccessoryViewController: UIInputViewController? { get }

    Objective C

    @property(nonatomic, readonly, retain) UIInputViewController *inputAccessoryViewController

    Обсуждение

    Это свойство обычно используется для присоединения вспомогательного контроллер представления к предоставленной систему клавиатуре, представленной для UITextField и UITextView объекты.

    Значение этого свойства только для чтения nil. Если Вы хотите присоединить пользовательские элементы управления к предоставленному систему входному контроллеру представления (такие как системная клавиатура) или к пользовательскому входному представлению (один, Вы обеспечиваете в inputViewController свойство), повторно объявите это свойство как чтение-запись в a UIResponder подкласс. Можно тогда использовать это свойство для управления пользовательским вспомогательным представление. Когда получатель становится первым респондентом, инфраструктура респондента присоединяет вспомогательное представление к надлежащему входному представлению прежде, чем вывести на экран его.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    inputAccessoryView

  • reloadInputViews () - reloadInputViews

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

    Объявление

    Swift

    func reloadInputViews()

    Objective C

    - (void)reloadInputViews

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Ответ на сенсорные события
  • touchesBegan (_: withEvent:) - touchesBegan:withEvent:

    Когда один или несколько пальцев приземляются в представлении или окне, говорит получатель.

    Объявление

    Swift

    func touchesBegan(_ touches: Set<NSObject>, withEvent event: UIEvent)

    Objective C

    - (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event

    Параметры

    touches

    Ряд UITouch экземпляры, представляющие касания для стартовой фазы события, представленного event.

    event

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

    Обсуждение

    Реализация по умолчанию этого метода ничего не делает. Однако, непосредственные подклассы UIKit UIResponder, особенно UIView, передайте сообщение цепочка респондента. Для передачи сообщения следующему респонденту отправьте сообщение в super (реализация суперкласса); не отправляйте сообщение непосредственно следующему респонденту. Например,

    Swift

    • super.touchesBegan(touches, withEvent: event)

    Objective C

    • [super touchesBegan:touches withEvent:event];

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

    Многократные касания отключены по умолчанию. Для получения многократных сенсорных событий, необходимо установить a multipleTouchEnabled свойство соответствующего экземпляра представления к YEStrue.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – touchesMoved:withEvent:
    – touchesEnded:withEvent:
    – touchesCancelled:withEvent:

  • touchesMoved (_: withEvent:) - touchesMoved:withEvent:

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

    Объявление

    Swift

    func touchesMoved(_ touches: Set<NSObject>, withEvent event: UIEvent)

    Objective C

    - (void)touchesMoved:(NSSet *)touches withEvent:(UIEvent *)event

    Параметры

    touches

    Ряд UITouch экземпляры, представляющие касания, перемещающиеся во время события, представленного event.

    event

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

    Обсуждение

    Реализация по умолчанию этого метода ничего не делает. Однако, непосредственные подклассы UIKit UIResponder, особенно UIView, передайте сообщение цепочка респондента. Для передачи сообщения следующему респонденту отправьте сообщение в super (реализация суперкласса); не отправляйте сообщение непосредственно следующему респонденту. Например,

    Swift

    • super.touchesMoved(touches, withEvent: event)

    Objective C

    • [super touchesMoved:touches withEvent:event];

    Многократные касания отключены по умолчанию. Для получения многократных сенсорных событий, необходимо установить a multipleTouchEnabled свойство соответствующего экземпляра представления к YEStrue.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – touchesBegan:withEvent:
    – touchesEnded:withEvent:
    – touchesCancelled:withEvent:

  • touchesEnded (_: withEvent:) - touchesEnded:withEvent:

    Когда один или несколько пальцев повышены от представления или окна, говорит получатель.

    Объявление

    Swift

    func touchesEnded(_ touches: Set<NSObject>, withEvent event: UIEvent)

    Objective C

    - (void)touchesEnded:(NSSet *)touches withEvent:(UIEvent *)event

    Параметры

    touches

    Ряд UITouch экземпляры, представляющие касания для конечной фазы события, представленного event.

    event

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

    Обсуждение

    Реализация по умолчанию этого метода ничего не делает. Однако, непосредственные подклассы UIKit UIResponder, особенно UIView, передайте сообщение цепочка респондента. Для передачи сообщения следующему респонденту отправьте сообщение в super (реализация суперкласса); не отправляйте сообщение непосредственно следующему респонденту. Например,

    Swift

    • super.touchesEnded(touches, withEvent: event)

    Objective C

    • [super touchesEnded:touches withEvent:event];

    Когда объект получает a touchesEnded:withEvent: сообщение это должно очистить любую информацию состояния, установленную в touchesBegan:withEvent: реализация.

    Многократные касания отключены по умолчанию. Для получения многократных сенсорных событий, необходимо установить a multipleTouchEnabled свойство соответствующего экземпляра представления к YEStrue.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – touchesBegan:withEvent:
    – touchesMoved:withEvent:
    – touchesCancelled:withEvent:

  • touchesCancelled (_: withEvent:) - touchesCancelled:withEvent:

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

    Объявление

    Swift

    func touchesCancelled(_ touches: Set<NSObject>!, withEvent event: UIEvent!)

    Objective C

    - (void)touchesCancelled:(NSSet *)touches withEvent:(UIEvent *)event

    Параметры

    touches

    Ряд UITouch экземпляры, представляющие касания для конечной фазы события, представленного event.

    event

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

    Обсуждение

    Когда Сенсорная платформа Какао получает системную отмену требования прерывания сенсорного события, этот метод вызывается; для этого это генерирует a UITouch объект с фазой UITouchPhaseCancel. Прерывание - что-то, что могло бы заставить приложение больше не быть активным или представление, которое будет удалено из окна

    Когда объект получает a touchesCancelled:withEvent: сообщение это должно очистить любую информацию состояния, установленную в touchesBegan:withEvent: реализация.

    Реализация по умолчанию этого метода ничего не делает. Однако, непосредственные подклассы UIKit UIResponder, особенно UIView, передайте сообщение цепочка респондента. Для передачи сообщения следующему респонденту отправьте сообщение в super (реализация суперкласса); не отправляйте сообщение непосредственно следующему респонденту. Например,

    Swift

    • super.touchesCancelled(touches, withEvent: event)

    Objective C

    • [super touchesCancelled:touches withEvent:event];

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – touchesBegan:withEvent:
    – touchesMoved:withEvent:
    – motionEnded:withEvent:

Ответ на события движения
  • motionBegan (_: withEvent:) - motionBegan:withEvent:

    Говорит получателю, что началось событие движения.

    Объявление

    Swift

    func motionBegan(_ motion: UIEventSubtype, withEvent event: UIEvent)

    Objective C

    - (void)motionBegan:(UIEventSubtype)motion withEvent:(UIEvent *)event

    Параметры

    motion

    Подтип события постоянное указание вида движения. Общее движение дрожит, который обозначен UIEventSubtypeMotionShake.

    event

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

    Обсуждение

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

    Реализация по умолчанию этого метода ничего не делает. Однако, непосредственные подклассы UIKit UIResponder, особенно UIView, передайте сообщение цепочка респондента.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – motionEnded:withEvent:
    – motionCancelled:withEvent:

  • motionEnded (_: withEvent:) - motionEnded:withEvent:

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

    Объявление

    Swift

    func motionEnded(_ motion: UIEventSubtype, withEvent event: UIEvent)

    Objective C

    - (void)motionEnded:(UIEventSubtype)motion withEvent:(UIEvent *)event

    Параметры

    motion

    Подтип события постоянное указание вида движения. Общее движение дрожит, который обозначен UIEventSubtypeMotionShake.

    event

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

    Обсуждение

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

    Реализация по умолчанию этого метода ничего не делает. Однако, непосредственные подклассы UIKit UIResponder, особенно UIView, передайте сообщение цепочка респондента.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – motionBegan:withEvent:
    – motionCancelled:withEvent:

  • motionCancelled (_: withEvent:) - motionCancelled:withEvent:

    Говорит получателю, что было отменено событие движения.

    Объявление

    Swift

    func motionCancelled(_ motion: UIEventSubtype, withEvent event: UIEvent)

    Objective C

    - (void)motionCancelled:(UIEventSubtype)motion withEvent:(UIEvent *)event

    Параметры

    motion

    Подтип события постоянное указание вида движения связался с event. Общее движение дрожит, который обозначен UIEventSubtypeMotionShake.

    event

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

    Обсуждение

    Когда Сенсорная платформа Какао получает отмену требования прерывания события движения, этот метод вызывается. Это прерывание - что-то, что могло бы заставить приложение больше не быть активным или представление, которое будет удалено из окна. Если сотрясение продолжается слишком долго, метод может также быть вызван. Все респонденты, обрабатывающие события движения, должны реализовать этот метод; в нем они должны очистить любую информацию состояния, установленную в motionBegan:withEvent: реализация.

    Реализация по умолчанию этого метода ничего не делает. Однако, непосредственные подклассы UIKit UIResponder, особенно UIView, передайте сообщение цепочка респондента.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – motionBegan:withEvent:
    – motionEnded:withEvent:

Ответ на события дистанционного управления
  • remoteControlReceivedWithEvent (_:) - remoteControlReceivedWithEvent:

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

    Объявление

    Swift

    func remoteControlReceivedWithEvent(_ event: UIEvent)

    Objective C

    - (void)remoteControlReceivedWithEvent:(UIEvent *)event

    Параметры

    event

    Объект-событие, инкапсулирующий дистанционную команду. События дистанционного управления имеют тип UIEventTypeRemoteControl.

    Обсуждение

    События дистанционного управления происходят как команды из внешних аксессуаров, включая гарнитуры. Приложение реагирует на эти команды путем управления аудио или видео носителями, представленными пользователю. Объект респондента получения должен исследовать subtype из event определить намеченную команду — например, игра (UIEventSubtypeRemoteControlPlay) — и затем продолжиться соответственно.

    Для разрешения поставки событий дистанционного управления необходимо вызвать beginReceivingRemoteControlEvents метод UIApplication; для выключения поставки событий дистанционного управления вызвать endReceivingRemoteControlEvents.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Получение менеджера по отмене
  • undoManager Свойство

    Возвращает самого близкого совместно используемого менеджера по отмене в цепочке респондента. (только для чтения)

    Объявление

    Swift

    var undoManager: NSUndoManager? { get }

    Objective C

    @property(nonatomic, readonly) NSUndoManager *undoManager

    Обсуждение

    По умолчанию каждое окно приложения имеет менеджера по отмене: общий объект для управления отменой и операциями восстановления. Однако класс любого объекта в цепочке респондента может иметь их собственного менеджера по отмене. (Например, экземпляры UITextField имейте их собственного менеджера по отмене, очищенного, когда текстовое поле оставляет состояние первого респондента.), Когда Вы запрашиваете менеджера по отмене, запрос восстанавливает работоспособность цепочка респондента и UIWindow возразите возвращает применимый экземпляр.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Проверка команд
  • canPerformAction (_: withSender:) - canPerformAction:withSender:

    Запрашивает респондента получения включить или отключить указанную команду в пользовательском интерфейсе.

    Объявление

    Swift

    func canPerformAction(_ action: Selector, withSender sender: AnyObject?) -> Bool

    Objective C

    - (BOOL)canPerformAction:(SEL)action withSender:(id)sender

    Параметры

    action

    Селектор, идентифицирующий метод, связанный с командой. Для меню редактирования это - один из методов редактирования, объявленных UIResponderStandardEditActions неофициальный протокол (например, copy:).

    sender

    Объект, вызывая этот метод. Для команд меню редактирования это - совместно используемое UIApplication объект. В зависимости от контекста можно запросить отправителя для получения информации, чтобы помочь Вам определить, должна ли быть включена команда.

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

    YEStrue если команда, идентифицированная action должен быть включен или NOfalse если это должно быть отключено. Возврат YEStrue средние значения, что Ваш класс может обработать команду в текущем контексте.

    Обсуждение

    Эта реализация по умолчанию этого метода возвраты YEStrue если класс респондента реализует требуемое действие и вызывает следующего респондента, если это не делает. Подклассы могут переопределить этот метод для включения команд меню на основе текущего состояния; например, Вы включили бы команду Copy, если существует выбор, или отключите команду Paste, если область монтажа не содержала данные с корректным типом представления области монтажа. Если никакой респондент в возвратах цепочки респондента YEStrue, команда меню отключена. Обратите внимание на то, что, если возвращается Ваш класс NOfalse для команды другой респондент далее может все еще возвратиться цепочка респондента YEStrue, включение команды.

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

    Для получения информации о меню редактирования см. описание UIMenuController класс.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • targetForAction (_: withSender:) - targetForAction:withSender:

    Возвращает целевой объект, реагирующий на действие.

    Объявление

    Swift

    func targetForAction(_ action: Selector, withSender sender: AnyObject?) -> AnyObject?

    Objective C

    - (id)targetForAction:(SEL)action withSender:(id)sender

    Параметры

    action

    Селектор, идентифицирующий метод, связанный с командой.

    sender

    Объект, вызывая этот метод. Для команд меню редактирования это - совместно используемое UIApplication объект. В зависимости от контекста можно запросить отправителя для получения информации, чтобы помочь Вам определить цель команды.

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

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

    Обсуждение

    Этот метод вызывают каждый раз, когда действие должно быть вызвано объектом. Реализация по умолчанию вызывает canPerformAction:withSender: метод, чтобы определить, может ли это вызвать действие. Если объект может вызвать действие, он возвращает себя, иначе он передает запрос цепочка респондента. Ваше приложение должно переопределить этот метод, если это хочет переопределить, как выбрана цель.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Доступ к доступным ключевым командам
  • keyCommands Свойство

    Ключевые команды, инициировавшие действия с этим респондентом. (только для чтения)

    Объявление

    Swift

    var keyCommands: [AnyObject]? { get }

    Objective C

    @property(nonatomic, readonly) NSArray *keyCommands

    Обсуждение

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Управление режимом ввода текста
  • textInputMode Свойство

    Режим ввода текста для этого объекта респондента. (только для чтения)

    Объявление

    Swift

    var textInputMode: UITextInputMode? { get }

    Objective C

    @property(nonatomic, readonly, retain) UITextInputMode *textInputMode

    Обсуждение

    Когда этот респондент активен, режим ввода текста идентифицирует язык и клавиатуру, выведенную на экран.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    textInputContextIdentifier

  • textInputContextIdentifier Свойство

    Идентификатор, показывающий, что респондент должен сохранить его информацию о режиме ввода текста. (только для чтения)

    Объявление

    Swift

    var textInputContextIdentifier: String? { get }

    Objective C

    @property(nonatomic, readonly, retain) NSString *textInputContextIdentifier

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • clearTextInputContextIdentifier (_:) + clearTextInputContextIdentifier:

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

    Объявление

    Swift

    class func clearTextInputContextIdentifier(_ identifier: String)

    Objective C

    + (void)clearTextInputContextIdentifier:(NSString *)identifier

    Параметры

    identifier

    Идентификатор присвоился к textInputContextIdentifier свойство одного из Ваших респондентов.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Поддержка пользовательских действий
  • userActivity Свойство

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

    Объявление

    Swift

    var userActivity: NSUserActivity?

    Objective C

    @property(nonatomic, retain) NSUserActivity *userActivity

    Обсуждение

    Путем установки userActivity свойство на респонденте, NSUserActivity объект становится управляемым UIKit. В подходящее время сохраняются автоматически пользовательские действия, которыми управляет UIKit. Можно лениво добавить данные состояния, представляющие действие пользователя через updateUserActivityState: переопределение. Многократные респонденты могут совместно использовать сингл NSUserActivity экземпляр, когда они все добираются updateUserActivityState: обратный вызов.

    Объект респондента может установить userActivity свойство к nil если это больше не хочет участвовать. Любой NSUserActivity объекты, которыми управляет UIKit, но не имеющие никаких связанных респондентов (или документы) автоматически лишены законной силы.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – restoreUserActivityState:
    – updateUserActivityState:

  • restoreUserActivityState (_:) - restoreUserActivityState:

    Восстановления состояние должны были продолжать данное пользовательское действие.

    Объявление

    Swift

    func restoreUserActivityState(_ activity: NSUserActivity)

    Objective C

    - (void)restoreUserActivityState:(NSUserActivity *)activity

    Параметры

    activity

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

    Обсуждение

    Подклассы переопределяют этот метод для восстановления состояния респондента с данным пользовательским действием. Системные вызовы это на любых объектах передало обработчику восстановления, данному application:continueUserActivity:restorationHandler:. Переопределение должно использовать данные состояния, содержавшиеся в данном пользовательском действии userInfo словарь для восстановления объекта.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    userActivity
    – updateUserActivityState:

  • updateUserActivityState (_:) - updateUserActivityState:

    Обновляет состояние данного пользовательского действия.

    Объявление

    Swift

    func updateUserActivityState(_ activity: NSUserActivity)

    Objective C

    - (void)updateUserActivityState:(NSUserActivity *)activity

    Параметры

    activity

    Пользовательское действие, которое будет обновлено.

    Обсуждение

    Подклассы переопределяют этот метод для обновления состояния данного пользовательского действия. Необходимо добавить состояние, представляющее действие пользователя в NSUserActivity объект с помощью addUserInfoEntriesFromDictionary: метод. Когда состояние грязно, необходимо установить needsSave свойство NSUserActivity к YEStrue, и в подходящее время вызовут этот метод.

    Когда NSUserActivity объект, которым управляет UIKit, обновляется, пустое userInfo словарь дан NSUserActivity объект и все объекты связались с NSUserActivity тогда отправляются updateUserActivityState: сообщение.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    userActivity
    – restoreUserActivityState: