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

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

Разработчик

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

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

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

UIEvent

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

A UIEvent объект (или, просто, объект-событие) представляет событие в iOS. Существует три общих типа события: сенсорные события, события движения и события дистанционного управления. События дистанционного управления позволяют объекту респондента получить команды от внешнего аксессуара или гарнитуры так, чтобы это могло управлять, управляют аудио и видео — например, играя видео или пропуская к следующему аудиотреку. События движения были представлены в iOS 3.0 и событиях дистанционного управления в iOS 4.0.

Сенсорный тип объекта-события содержит одно или более касаний (т.е. жесты пальца на экране), которые имеют некоторое отношение к событию. Касание представлено a UITouch объект. Когда сенсорное событие имеет место, системные маршруты это соответствующему респонденту и передает в UIEvent объект в вызове a сообщения UIResponder метод такой как touchesBegan:withEvent:. Респондент может тогда оценить касания для события или для определенной фазы события и обработать их соответственно. Методы UIEvent позвольте Вам получать все касания для события (allTouches) или только те для высказанного мнения или окна (touchesForView: или touchesForWindow:). Это может также отличить объект-событие от объектов, представляющих другие события путем запросов объекта в течение времени его создания (timestamp).

A UIEvent объект, представляющий сенсорное событие, является персистентным всюду по мультисенсорной последовательности; UIKit снова использует то же UIEvent экземпляр для каждого события, поставленного приложению. Вы никогда не должны сохранять объект-событие, или любой объект возвратился из объекта-события. Если необходимо утаить информацию от события вокруг от одной фазы до другого, необходимо скопировать ту информацию с UITouch или UIEvent объект.

Можно получить типы событий и подтипы от type и subtype свойства. UIEvent определяет типы событий для касания, движения и событий дистанционного управления. Это также определяет подтип движения для событий "встряски” и серии констант подтипа для событий дистанционного управления, таких как «игра» и “предыдущая дорожка”. Первый респондент или любой респондент в цепочке респондента реализуют связанные с движением методы UIResponder (такой как motionBegan:withEvent:) обработать события встряхивающего движения. Для обработки событий дистанционного управления объект респондента должен реализовать remoteControlReceivedWithEvent: метод UIResponder.

touchesForGestureRecognizer: метод, внедренный в iOS 3.2, позволяет Вам запрашивать объект устройства распознавания жеста (экземпляр подкласса UIGestureRecognizer) для касаний это в настоящее время обрабатывает.

Получение касаний для события
  • allTouches () - allTouches

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

    Объявление

    Swift

    func allTouches() -> Set<NSObject>?

    Objective C

    - (NSSet *)allTouches

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

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – touchesForView:
    – touchesForWindow:

  • touchesForView (_:) - touchesForView:

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

    Объявление

    Swift

    func touchesForView(_ view: UIView) -> Set<NSObject>?

    Objective C

    - (NSSet *)touchesForView:(UIView *)view

    Параметры

    view

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

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – allTouches
    – touchesForWindow:

  • touchesForWindow (_:) - touchesForWindow:

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

    Объявление

    Swift

    func touchesForWindow(_ window: UIWindow) -> Set<NSObject>?

    Objective C

    - (NSSet *)touchesForWindow:(UIWindow *)window

    Параметры

    window

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

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – allTouches
    – touchesForView:

Получение атрибутов события
  • timestamp Свойство

    Время, когда событие имело место. (только для чтения)

    Объявление

    Swift

    var timestamp: NSTimeInterval { get }

    Objective C

    @property(nonatomic, readonly) NSTimeInterval timestamp

    Обсуждение

    Значение свойства является числом секунд начиная с системного запуска. Для описания этой временной стоимости см. описание systemUptime метод NSProcessInfo класс.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Получение типа события
  • type Свойство

    Возвращает тип события. (только для чтения)

    Объявление

    Swift

    var type: UIEventType { get }

    Objective C

    @property(nonatomic, readonly) UIEventType type

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    подтип

  • subtype Свойство

    Возвращает подтип события. (только для чтения)

    Объявление

    Swift

    var subtype: UIEventSubtype { get }

    Objective C

    @property(nonatomic, readonly) UIEventSubtype subtype

    Обсуждение

    UIEventSubtype постоянный возвращенный этим свойством указывает подтип события в связи с общим типом, возвращающимся из type свойство.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Получение касаний для устройства распознавания жеста
  • touchesForGestureRecognizer (_:) - touchesForGestureRecognizer:

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

    Объявление

    Swift

    func touchesForGestureRecognizer(_ gesture: UIGestureRecognizer) -> Set<NSObject>?

    Objective C

    - (NSSet *)touchesForGestureRecognizer:(UIGestureRecognizer *)gesture

    Параметры

    gesture

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

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Типы данных

  • UIEventType

    Указывает общий тип события

    Объявление

    Swift

    enum UIEventType : Int { case Touches case Motion case RemoteControl }

    Objective C

    typedef enum { UIEventTypeTouches, UIEventTypeMotion, UIEventTypeRemoteControl, } UIEventType;

    Константы

    • Touches

      UIEventTypeTouches

      Событие связано с касаниями к экрану.

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

    • Motion

      UIEventTypeMotion

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

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

    • RemoteControl

      UIEventTypeRemoteControl

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

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • UIEventSubtype

    Указывает подтип события в связи с его общим типом.

    Объявление

    Swift

    enum UIEventSubtype : Int { case None case MotionShake case RemoteControlPlay case RemoteControlPause case RemoteControlStop case RemoteControlTogglePlayPause case RemoteControlNextTrack case RemoteControlPreviousTrack case RemoteControlBeginSeekingBackward case RemoteControlEndSeekingBackward case RemoteControlBeginSeekingForward case RemoteControlEndSeekingForward }

    Objective C

    typedef enum { UIEventSubtypeNone = 0, UIEventSubtypeMotionShake = 1, UIEventSubtypeRemoteControlPlay = 100, UIEventSubtypeRemoteControlPause = 101, UIEventSubtypeRemoteControlStop = 102, UIEventSubtypeRemoteControlTogglePlayPause = 103, UIEventSubtypeRemoteControlNextTrack = 104, UIEventSubtypeRemoteControlPreviousTrack = 105, UIEventSubtypeRemoteControlBeginSeekingBackward = 106, UIEventSubtypeRemoteControlEndSeekingBackward = 107, UIEventSubtypeRemoteControlBeginSeekingForward = 108, UIEventSubtypeRemoteControlEndSeekingForward = 109, } UIEventSubtype;

    Константы

    • None

      UIEventSubtypeNone

      Событие не имеет никакого подтипа. Это - подтип для событий UIEventTypeTouches общий тип.

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

    • MotionShake

      UIEventSubtypeMotionShake

      Событие связано с пользователем, встряхивающим устройство. Это - подтип для UIEventTypeMotion общий тип события.

      Доступный в iOS 3.0.

    • RemoteControlPlay

      UIEventSubtypeRemoteControlPlay

      Событие дистанционного управления для игры аудио или видео. Это - подтип UIEventTypeRemoteControl общий тип события.

      Доступный в iOS 4.0.

    • RemoteControlPause

      UIEventSubtypeRemoteControlPause

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

      Доступный в iOS 4.0.

    • RemoteControlStop

      UIEventSubtypeRemoteControlStop

      Событие дистанционного управления для того, чтобы мешать аудио или видео играть. Это - подтип UIEventTypeRemoteControl общий тип события.

      Доступный в iOS 4.0.

    • RemoteControlTogglePlayPause

      UIEventSubtypeRemoteControlTogglePlayPause

      Событие дистанционного управления для переключения аудио или видео между игрой и паузой. Это - подтип UIEventTypeRemoteControl общий тип события.

      Доступный в iOS 4.0.

    • RemoteControlNextTrack

      UIEventSubtypeRemoteControlNextTrack

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

      Доступный в iOS 4.0.

    • RemoteControlPreviousTrack

      UIEventSubtypeRemoteControlPreviousTrack

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

      Доступный в iOS 4.0.

    • RemoteControlBeginSeekingBackward

      UIEventSubtypeRemoteControlBeginSeekingBackward

      Событие дистанционного управления, чтобы начать искать назад через аудио или видео носитель. Это - подтип UIEventTypeRemoteControl общий тип события.

      Доступный в iOS 4.0.

    • RemoteControlEndSeekingBackward

      UIEventSubtypeRemoteControlEndSeekingBackward

      Событие дистанционного управления для окончания поиска назад через аудио или видео носитель. Это - подтип UIEventTypeRemoteControl общий тип события.

      Доступный в iOS 4.0.

    • RemoteControlBeginSeekingForward

      UIEventSubtypeRemoteControlBeginSeekingForward

      Событие дистанционного управления, чтобы начать искать вперед через аудио или видео носитель. Это - подтип UIEventTypeRemoteControl общий тип события.

      Доступный в iOS 4.0.

    • RemoteControlEndSeekingForward

      UIEventSubtypeRemoteControlEndSeekingForward

      Событие дистанционного управления для окончания поиска передает через аудио или видео носитель. Это - подтип UIEventTypeRemoteControl общий тип события.

      Доступный в iOS 4.0.

    Обсуждение

    Можно получить подтип события от subtype свойство.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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