//

//  UITouch.h

//  UIKit

//

//  Copyright (c) 2007-2017 Apple Inc. All rights reserved.

//

#import <Foundation/Foundation.h>

#import <CoreGraphics/CoreGraphics.h>

#import <UIKit/UIKitDefines.h>

NS_ASSUME_NONNULL_BEGIN

@class UIWindow, UIView, UIGestureRecognizer;

typedef NS_ENUM(NSInteger, UITouchPhase) {

    UITouchPhaseBegan,             // 开始触摸

    UITouchPhaseMoved,             // 移动

    UITouchPhaseStationary,        // 停留

    UITouchPhaseEnded,             // 结束

    UITouchPhaseCancelled,         // 取消

};

typedef NS_ENUM(NSInteger, UIForceTouchCapability) {

    UIForceTouchCapabilityUnknown = ,          // 3D Touch检测失败

    UIForceTouchCapabilityUnavailable = ,      // 3D Touch不可用

    UIForceTouchCapabilityAvailable =          // 3D Touch可用

};

typedef NS_ENUM(NSInteger, UITouchType) {

    UITouchTypeDirect,                       // 手指和屏幕直接接触

    UITouchTypeIndirect,                     // 间接接触（不直接接触屏幕）

    UITouchTypeStylus NS_AVAILABLE_IOS(9_1), // 笔触

} NS_ENUM_AVAILABLE_IOS(9_0);

typedef NS_OPTIONS(NSInteger, UITouchProperties) {

    UITouchPropertyForce = (1UL << ),      //力度

    UITouchPropertyAzimuth = (1UL << ),    //方位

    UITouchPropertyAltitude = (1UL << ),   //高度

    UITouchPropertyLocation = (1UL << ),   //位置

} NS_AVAILABLE_IOS(9_1);

NS_CLASS_AVAILABLE_IOS(2_0) @interface UITouch : NSObject

@property(nonatomic,readonly) NSTimeInterval      timestamp;    // 时间

@property(nonatomic,readonly) UITouchPhase        phase;        // 状态

@property(nonatomic,readonly) NSUInteger          tapCount;     // 点击次数

@property(nonatomic,readonly) UITouchType         type NS_AVAILABLE_IOS(9_0);   //接触类型

// 接触面积的半径

// 接触半径的误差

@property(nonatomic,readonly) CGFloat majorRadius NS_AVAILABLE_IOS(8_0);

@property(nonatomic,readonly) CGFloat majorRadiusTolerance NS_AVAILABLE_IOS(8_0);

@property(nullable,nonatomic,readonly,strong) UIWindow                        *window;  //触摸所在窗口

@property(nullable,nonatomic,readonly,strong) UIView                          *view;    //触摸所在视图

@property(nullable,nonatomic,readonly,copy)   NSArray <UIGestureRecognizer *> *gestureRecognizers NS_AVAILABLE_IOS(3_2);    //触摸手势

- (CGPoint)locationInView:(nullable UIView *)view;   //在view上的触摸位置

- (CGPoint)previousLocationInView:(nullable UIView *)view;  //记录前一个触摸点的在view上的位置，view为nil就是整个窗口

//现在触摸的精确的坐标

//上一次触摸的精确的坐标

- (CGPoint)preciseLocationInView:(nullable UIView *)view NS_AVAILABLE_IOS(9_1);

- (CGPoint)precisePreviousLocationInView:(nullable UIView *)view NS_AVAILABLE_IOS(9_1);

// 触摸压力值

@property(nonatomic,readonly) CGFloat force NS_AVAILABLE_IOS(9_0);

// 最大触摸压力值

@property(nonatomic,readonly) CGFloat maximumPossibleForce NS_AVAILABLE_IOS(9_0);

//沿着x轴正向的方位角,当与x轴正向方向相同时,该值为0;当view参数为nil时，默认为keyWindow返回触针的方位角（弧度）。

- (CGFloat)azimuthAngleInView:(nullable UIView *)view NS_AVAILABLE_IOS(9_1);

//当前触摸对象的方向上的单位向量当view参数为nil时，默认为keyWindow返回在触针的方位角的方向指向的单位矢量。

- (CGVector)azimuthUnitVectorInView:(nullable UIView *)view NS_AVAILABLE_IOS(9_1);

//当笔平行于平面时,该值为0

//当笔垂直于平面时,该值为Pi / 2

//触针的高度（单位为弧度）。

@property(nonatomic,readonly) CGFloat altitudeAngle NS_AVAILABLE_IOS(9_1);

//当每个触摸对象的触摸特性发生变化时，该值将会单独增加,返回值是NSNumber 索引号，让您关联与原来的触摸更新的联系

@property(nonatomic,readonly) NSNumber * _Nullable estimationUpdateIndex NS_AVAILABLE_IOS(9_1);

//当前触摸对象估计的触摸特性,返回值是UITouchPropertyies一组触摸属性，这些属性将得到更新。

@property(nonatomic,readonly) UITouchProperties estimatedProperties NS_AVAILABLE_IOS(9_1);

//一组期望在未来的更新报文的触摸性能。

@property(nonatomic,readonly) UITouchProperties estimatedPropertiesExpectingUpdates NS_AVAILABLE_IOS(9_1);

@end

NS_ASSUME_NONNULL_END