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

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

Разработчик

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

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

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

UITouch

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

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

A UITouch объект включает методы для доступа к представлению или окну, в котором касание произошло и для получения расположения касания в определенном представлении или окне. это также позволяет Вам узнать, когда касание произошло, коснулся ли пользователь несколько раз, сильно ударен ли палец (и если так, в который направление), и фаза касания — т.е. началось ли это, перемещенный, или закончило жест, или было ли это отменено.

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

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

Получение расположения касаний
  • locationInView (_:) - locationInView:

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

    Объявление

    Swift

    func locationInView(_ view: UIView?) -> CGPoint

    Objective C

    - (CGPoint)locationInView:(UIView *)view

    Параметры

    view

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

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

    Точка, указывающая расположение получателя в view.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – previousLocationInView:

  • previousLocationInView (_:) - previousLocationInView:

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

    Объявление

    Swift

    func previousLocationInView(_ view: UIView?) -> CGPoint

    Objective C

    - (CGPoint)previousLocationInView:(UIView *)view

    Параметры

    view

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

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – locationInView:

  • view Свойство

    Представление, в котором первоначально произошло касание. (только для чтения)

    Объявление

    Swift

    var view: UIView { get }

    Objective C

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

    Обсуждение

    Значение свойства является объектом представления, в котором первоначально произошло касание. Этот объект не мог бы быть представлением, в котором касание в настоящее время находится.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    окно

  • window Свойство

    Окно, в котором первоначально произошло касание. (только для чтения)

    Объявление

    Swift

    var window: UIWindow { get }

    Objective C

    @property(nonatomic, readonly, retain) UIWindow *window

    Обсуждение

    Значение свойства является объектом окна, в котором первоначально произошло касание. Этот объект не мог бы быть окном, в котором касание в настоящее время находится.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    представление

  • majorRadius Свойство

    Радиус (в точках) касания. (только для чтения)

    Объявление

    Swift

    var majorRadius: CGFloat { get }

    Objective C

    @property(nonatomic, readonly) CGFloat majorRadius

    Обсуждение

    Используйте значение в этом свойстве для определения размера касания, о котором сообщили аппаратные средства. Это значение является приближением размера и может варьироваться суммой, указанной в majorRadiusTolerance свойство.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • majorRadiusTolerance Свойство

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

    Объявление

    Swift

    var majorRadiusTolerance: CGFloat { get }

    Objective C

    @property(nonatomic, readonly) CGFloat majorRadiusTolerance

    Обсуждение

    Это значение определяет точность значения в majorRadius свойство. Добавьте это значение к радиусу для получения максимального сенсорного радиуса. Вычтите значение для получения минимального сенсорного радиуса.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

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

    Число раз палец коснулось для этого данного касания. (только для чтения)

    Объявление

    Swift

    var tapCount: Int { get }

    Objective C

    @property(nonatomic, readonly) NSUInteger tapCount

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • timestamp Свойство

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

    Объявление

    Swift

    var timestamp: NSTimeInterval { get }

    Objective C

    @property(nonatomic, readonly) NSTimeInterval timestamp

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • phase Свойство

    Тип касания. (только для чтения)

    Объявление

    Swift

    var phase: UITouchPhase { get }

    Objective C

    @property(nonatomic, readonly) UITouchPhase phase

    Обсуждение

    Значение свойства является константой, указывающей, началось ли касание, переместилось, законченный, или было отменено. Для описаний возможных UITouchPhase значения, посмотрите Сенсорную Фазу.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Получение устройств распознавания жеста сенсорного объекта
  • gestureRecognizers Свойство

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

    Объявление

    Swift

    var gestureRecognizers: [AnyObject] { get }

    Objective C

    @property(nonatomic, readonly, copy) NSArray *gestureRecognizers

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Работа с сенсорными событиями в наборе Sprite
  • locationInNode (_:) - locationInNode:

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

    Объявление

    Swift

    func locationInNode(_ node: SKNode!) -> CGPoint

    Objective C

    - (CGPoint)locationInNode:(SKNode *)node

    Параметры

    node

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

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

    Расположение касания в системе координат узла.

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

    Objective C

    @import SpriteKit;

    Swift

    import SpriteKit

    Доступность

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

  • previousLocationInNode (_:) - previousLocationInNode:

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

    Объявление

    Swift

    func previousLocationInNode(_ node: SKNode!) -> CGPoint

    Objective C

    - (CGPoint)previousLocationInNode:(SKNode *)node

    Параметры

    node

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

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

    Расположение касания в системе координат узла.

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

    Objective C

    @import SpriteKit;

    Swift

    import SpriteKit

    Доступность

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

Константы
  • Сенсорная фаза

    Фаза касания пальца.

    Объявление

    Swift

    enum UITouchPhase : Int { case Began case Moved case Stationary case Ended case Cancelled }

    Objective C

    typedef enum { UITouchPhaseBegan, UITouchPhaseMoved, UITouchPhaseStationary, UITouchPhaseEnded, UITouchPhaseCancelled, } UITouchPhase;

    Константы

    • Began

      UITouchPhaseBegan

      Палец для данного события коснулся экрана.

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

    • Moved

      UITouchPhaseMoved

      Палец для данного события углубил экран.

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

    • Stationary

      UITouchPhaseStationary

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

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

    • Ended

      UITouchPhaseEnded

      Пальцем для данного события пошевелили с экрана.

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

    • Cancelled

      UITouchPhaseCancelled

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

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

    Обсуждение

    Фаза a UITouch экземпляр изменяется в определенном порядке в течение события. Вы получаете доступ к этому значению через phase свойство.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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