15 (OC)* UIGesture

前言

本文主要内容如下：

1. UIGestureRecognizer 属性、方法、代理和七个子类详解。

2. 讲讲 UIGestureRecognizer 和 UITouch 事件的关系。

3. 讲讲如何自定义手势？

一、手势识别器-UIGestureRecognizer

1.1 简介

UIGestureRecognizer是苹果在iOS 3.2之后，推出的手势识别功能。UIGestureRecognizer是一个抽象类，将触摸事件封装成了手势对象，大大简化了开发者的开发难度，同时也提升了用户的交互体验。UIGestureRecognizer有七个子类，它们具体实现了不同手势的功能。

 

手势结构关系图.png

1.2 属性、方法、代理

UIGestureRecognizer 是一个抽象类，所以它会提供很多共有的属性和方法给子类用，这也是抽象父类的作用。

1.2.1 初始化、添加target、移除target

//初始化方法 且 添加 target的方法
- (instancetype)initWithTarget:(nullable id)target action:(nullable SEL)action
//单独添加target的方法
- (void)addTarget:(id)target action:(SEL)action;
//移除target的方法
- (void)removeTarget:(nullable id)target action:(nullable SEL)action;

addTarget方法，允许一个手势对象可以添加多个selector方法，并且触发的时候，所有添加的selector都会被执行，我们以点击手势示例如下：

- (void)addTapGesture
{
    UITapGestureRecognizer *tap = [[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(tapHandler:)];
    [tap addTarget:self action:@selector(tap1Handler:)];
    [self.view addGestureRecognizer:tap];
}

- (void)tapHandler:(UITapGestureRecognizer *)sender
{
    NSLog(@"tapHandler 点击了。。。");
}

- (void)tap1Handler:(UITapGestureRecognizer *)sender
{
    NSLog(@"tapHandler1 点击了。。。");
}

点击屏幕，打印内容如下：
2018-07-26 00:46:10.161513+0800 UIGestureRecognizerDemo[4004:479521] tapHandler 点击了。。。
2018-07-26 00:46:10.162740+0800 UIGestureRecognizerDemo[4004:479521] tapHandler1 点击了。。。

1.2.2 属性和方法

先把所有的属性和方法列举出来说说作用的，有的属性是很常用的，就不展开说了，有的属性不常用，但是比较重要，我就单独拿出来详细说一下。

//手势的状态
@property(nonatomic,readonly) UIGestureRecognizerState state;
//手势代理
@property(nullable,nonatomic,weak) id <UIGestureRecognizerDelegate> delegate;
//手势是否有效  默认YES
@property(nonatomic, getter=isEnabled) BOOL enabled;
//获取手势所在的view
@property(nullable, nonatomic,readonly) UIView *view;
//取消view上面的touch事件响应  default  YES **下面会详解该属性**
@property(nonatomic) BOOL cancelsTouchesInView;
//延迟touch事件开始 default  NO   **下面会详解该属性**
@property(nonatomic) BOOL delaysTouchesBegan;
//延迟touch事件结束 default  YES  **下面会详解该属性**
@property(nonatomic) BOOL delaysTouchesEnded;
//允许touch的类型数组，**下面会详解该属性**
@property(nonatomic, copy) NSArray<NSNumber *> *allowedTouchTypes
//允许按压press的类型数组
@property(nonatomic, copy) NSArray<NSNumber *> *allowedPressTypes
//是否只允许一种touchType 类型，**下面会详解该属性**
@property (nonatomic) BOOL requiresExclusiveTouchType
//手势依赖（手势互斥）方法，**下面会详解该方法**
- (void)requireGestureRecognizerToFail:(UIGestureRecognizer *)otherGestureRecognizer;
//获取在传入view的点击位置的信息方法
- (CGPoint)locationInView:(nullable UIView*)view;
//获取触摸点数
@property(nonatomic, readonly) NSUInteger numberOfTouches;
 //（touchIndex 是第几个触摸点）用来获取多触摸点在view上位置信息的方法
- (CGPoint)locationOfTouch:(NSUInteger)touchIndex inView:(nullable UIView*)view;
// 给手势加一个名字，以方便调式（iOS11 or later可以用）
@property (nullable, nonatomic, copy) NSString *name API_AVAILABLE(ios(11.0)

先来说说requiresExclusiveTouchType这个属性
是不是有很多人和我之前一样，把它理解成了设置为NO，就可以同时响应几种手势点击了呢？
这个属性的意思：是否同时只接受一种触摸类型，而不是是否同时只接受一种手势。默认是YES。设置成NO，它会同时响应 allowedTouchTypes这个数组里的所有触摸类型。这个数组里面装的touchType类型如下：

//目前touchType有三种
typedef NS_ENUM(NSInteger, UITouchType) {
    UITouchTypeDirect,                       // 手指直接接触屏幕
    UITouchTypeIndirect,                     // 不是手指直接接触屏幕（例如：苹果TV遥控设置屏幕上的按钮）
    UITouchTypeStylus NS_AVAILABLE_IOS(9_1), // 触控笔接触屏幕
}

如果把requiresExclusiveTouchType设置为NO，假设view上添加了tapGesture手势，你同时用手点击和用触控笔点击该view，这个tapGesture手势的方法都会响应。

接下来说说cancelsTouchesInView、delaysTouchesBegan、delaysTouchesEnd这三个属性。

• cancelsTouchesInView属性默认设置为YES，如果识别到了手势，系统将会发送touchesCancelled:withEvent:消息，终止触摸事件的传递。也就是说默认当识别到手势时，touch事件传递的方法将被终止，如果设置为NO，touch事件传递的方法仍然会被执行。

---

• delaysTouchesBegan用于控制事件的开始响应的时机，"是否延迟响应触摸事件"。设置为NO，不会延迟响应触摸事件，如果我们设置为YES，在手势没有被识别失败前，都不会给事件传递链发送消息。

---

• delaysTouchesEnd用于控制事件结束响应的时机，"是否延迟结束触摸事件"，设置为NO，则会立马调用touchEnd:withEvent这个方法（如果需要调用的话）。设置为YES，会等待一个很短的时间，如果没有接收到新的手势识别任务，才会发送touchesEnded消息到事件传递链。

举栗子

cancelsTouchesInView栗子

- (void)addPanGesture
{
    UIPanGestureRecognizer *pan = [[UIPanGestureRecognizer alloc] initWithTarget:self action:@selector(panHandler:)];
    pan.cancelsTouchesInView = YES;
    [self.view addGestureRecognizer:pan];
}
- (void)panHandler:(UIPanGestureRecognizer *)sender
{
    NSLog(@"panHandler 调用了");
}

//tap.cancelsTouchesInView = YES; 控制台输出如下：
2018-07-26 15:31:13.034236+0800 GestureDemo[82008:1643784] touchesMoved调用了
2018-07-26 15:31:13.042147+0800 GestureDemo[82008:1643784] touchesMoved调用了
2018-07-26 15:31:13.042685+0800 GestureDemo[82008:1643784] touchesMoved调用了
2018-07-26 15:31:13.051290+0800 GestureDemo[82008:1643784] touchesMoved调用了
2018-07-26 15:31:13.051290+0800 GestureDemo[82008:1643784] touchesCancel调用了
2018-07-26 15:31:13.082702+0800 GestureDemo[82008:1643784] panHandler 调用了
2018-07-26 15:31:13.083552+0800 GestureDemo[82008:1643784] panHandler 调用了
2018-07-26 15:31:13.083918+0800 GestureDemo[82008:1643784] panHandler 调用了
2018-07-26 15:31:13.090601+0800 GestureDemo[82008:1643784] panHandler 调用了
2018-07-26 15:31:13.098323+0800 GestureDemo[82008:1643784] panHandler 调用了

//pan.cancelsTouchesView = NO;控制台输出如下：
2018-07-26 15:38:00.895361+0800 GestureDemo[82069:1649256] touchesMoved调用了
2018-07-26 15:38:00.903074+0800 GestureDemo[82069:1649256] panHandler 调用了
2018-07-26 15:38:00.903316+0800 GestureDemo[82069:1649256] touchesMoved调用了
2018-07-26 15:38:00.903696+0800 GestureDemo[82069:1649256] panHandler 调用了
2018-07-26 15:38:00.903962+0800 GestureDemo[82069:1649256] touchesMoved调用了
2018-07-26 15:38:00.911393+0800 GestureDemo[82069:1649256] panHandler 调用了

栗子中，pan.cancelsTouchesInView = YES时，为什么会打印"touchesMoved调用了"呢？这就涉及到第二个属性delaysTouchesBegan,这是因为手势识别是有一个过程的，拖拽手势需要一个很小的手指移动的过程才能被识别为拖拽手势，而在一个手势触发之前，是会一并发消息给事件传递链的，所以才会有最开始的几个touchMoved方法被调用，当识别出拖拽手势以后，就会终止touch事件的传递。当pan.cancelsTouchsInView = NO，touchesMoved和panHandler依次被打印出来，touch事件继续响应。

delaysTouchesBegan的栗子

- (void)addPanGesture
{
    UIPanGestureRecognizer *pan = [[UIPanGestureRecognizer alloc] initWithTarget:self action:@selector(panHandler:)];
    pan.cancelsTouchesInView = YES;
    pan.delaysTouchesBegan = YES;
    [self.view addGestureRecognizer:pan];
}
- (void)panHandler:(UIPanGestureRecognizer *)sender
{
    NSLog(@"panHandler 调用了");
}

//pan.delaysTouchesBegan = YES;  控制台输出如下：
2018-07-26 16:06:59.682302+0800 GestureDemo[82294:1669777] panHandler 调用了
2018-07-26 16:06:59.689734+0800 GestureDemo[82294:1669777] panHandler 调用了
2018-07-26 16:06:59.689973+0800 GestureDemo[82294:1669777] panHandler 调用了
2018-07-26 16:06:59.697302+0800 GestureDemo[82294:1669777] panHandler 调用了
2018-07-26 16:06:59.697675+0800 GestureDemo[82294:1669777] panHandler 调用了

当delaysTouchesBegan设置为YES时，手势识别成功之前都不会调用touches相关方法，因为手势识别成功了，所以控制台只打印了"panHandler 调用了"的信息。如果手势识别失败了，就会打印touchesMoved方法里的信息。

delaysTouchesEnd的栗子

- (void)addTapGesture
{
    UITapGestureRecognizer *tap = [[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(tapHandler:)];
    tap.numberOfTapsRequired = 3;
    tap.delaysTouchesEnded = YES;
    [self.view addGestureRecognizer:tap];
}
- (void)tapHandler:(UITapGestureRecognizer *)sender
{
    NSLog(@"tapHandler 点击了");
}

// tap.delaysTouchesEnded = YES 时，控制台输出如下：
2018-07-26 16:58:05.101085+0800 GestureDemo[88344:1715678] touchesBegan调用了
2018-07-26 16:58:05.614449+0800 GestureDemo[88344:1715678] tapHandler 点击了
2018-07-26 16:58:05.614961+0800 GestureDemo[88344:1715678] touchesCancel调用了

//tap.delaysTouchesEnded = NO 时，控制台输出如下：
2018-07-26 16:48:15.722280+0800 GestureDemo[88254:1708453] touchesBegan调用了
2018-07-26 16:48:15.815430+0800 GestureDemo[88254:1708453] touchesEnded调用了
2018-07-26 16:48:15.896287+0800 GestureDemo[88254:1708453] touchesBegan调用了
2018-07-26 16:48:15.984245+0800 GestureDemo[88254:1708453] touchesEnded调用了
2018-07-26 16:48:16.057009+0800 GestureDemo[88254:1708453] touchesBegan调用了
2018-07-26 16:48:16.154256+0800 GestureDemo[88254:1708453] tapHandler 点击了
2018-07-26 16:48:16.154643+0800 GestureDemo[88254:1708453] touchesCancel调用了

就像上面对这个属性的分析一样 设置为NO，则会立马调用touchEnd:withEvent这个方法。设置为YES，会等待一个很短的时间，如果没有接收到新的手势识别任务，才会发送touchesEnded消息到事件传递链。

手势依赖方法-requireGestureRecognizerToFail

用法：[A requireGestureRecognizerToFail：B] 当A、B两个手势同时满足响应手势方法的条件时，B优先响应，A不响应。如果B不满足条件，A满足响应手势方法的条件，则A响应。其实这就是一个设置响应手势优先级的方法。
如果一个view上添加了多个手势对象的，默认这些手势是互斥的，一个手势触发了就会默认屏蔽其他手势动作。比如，单击和双击手势并存时，如果不做处理，它就只能发送出单击的消息。为了能够优先识别双击手势，我们就可以用requireGestureRecognizerToFail：这个方法设置优先响应双击手势。

1.2.3 UIGestureRecognizerDelegate代理方法

//开始进行手势识别时调用的方法，返回NO，则手势识别失败
- (BOOL)gestureRecognizerShouldBegin:(UIGestureRecognizer *)gestureRecognizer;

//手指触摸屏幕后回调的方法，返回NO则手势识别失败
- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer
shouldReceiveTouch:(UITouch *)touch;

//是否支持同时多个手势触发
//返回YES，则可以多个手势一起触发方法，返回NO则为互斥
- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer
shouldRecognizeSimultaneouslyWithGestureRecognizer:(UIGestureRecognizer *)
otherGestureRecognizer;

//下面这个两个方法也是用来控制手势的互斥执行的
//这个方法返回YES，第二个手势的优先级高于第一个手势
- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer
shouldRequireFailureOfGestureRecognizer:(UIGestureRecognizer *)
otherGestureRecognizer 

//这个方法返回YES，第一个手势的优先级高于第二个手势
- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer
shouldBeRequiredToFailByGestureRecognizer:(UIGestureRecognizer *)
otherGestureRecognizer

1.3 UIGestureRecognizer 子类

手势可以分为："离散手势"和"连续手势"
"离散手势"：比如tapGesture、swipeGesture等
"连续手势": 比如：panGesture,rotationGesture等。
对于连续手势，手势识别器可能使状态转换更多，如下图所示：
可能---->开始----> [已更改] ---->已取消
可能---->开始----> [已更改] ---->结束

//手势状态枚举值
typedef NS_ENUM(NSInteger, UIGestureRecognizerState) {
    UIGestureRecognizerStatePossible,   // 默认的状态，这个时候的手势并没有具体的情形状态
    UIGestureRecognizerStateBegan,      // 手势开始被识别的状态
    UIGestureRecognizerStateChanged,    // 手势识别发生改变的状态
    UIGestureRecognizerStateEnded,      // 手势识别结束，将会执行触发的方法
    UIGestureRecognizerStateCancelled,  // 手势识别取消
    UIGestureRecognizerStateFailed,     // 识别失败，方法将不会被调用
    UIGestureRecognizerStateRecognized = UIGestureRecognizerStateEnded
};

1.3.1 点击手势——UITapGestureRecognizer

在视图上点击视图的手势------常用度五颗星

//设置点击次数，默认为单击
@property (nonatomic) NSUInteger  numberOfTapsRequired;
//设置同时点击的手指数
@property (nonatomic) NSUInteger  numberOfTouchesRequired;

1.3.2 捏合手势——UIPinchGestureRecognizer

在视图上手指进行缩放的手势------常用度三颗星

//设置缩放比例
@property (nonatomic)          CGFloat scale;
//设置捏合速度,只读
@property (nonatomic,readonly) CGFloat velocity;

1.3.3 旋转手势——UIRotationGestureRecognizer

在视图上手指旋转的手势------常用度三颗星

//设置旋转角度
@property (nonatomic)          CGFloat rotation;
//设置旋转速度
@property (nonatomic,readonly) CGFloat velocity;

1.3.4 滑动手势——UISwipeGestureRecognizer

在视图上用手指进行有方向滑动的手势------常用度三颗星

/设置触发滑动手势的触摸点数
@property(nonatomic) NSUInteger                        numberOfTouchesRequired;
//设置滑动方向
@property(nonatomic) UISwipeGestureRecognizerDirection direction;
//枚举如下
typedef NS_OPTIONS(NSUInteger, UISwipeGestureRecognizerDirection) {
    UISwipeGestureRecognizerDirectionRight = 1 << 0,
    UISwipeGestureRecognizerDirectionLeft  = 1 << 1,
    UISwipeGestureRecognizerDirectionUp    = 1 << 2,
    UISwipeGestureRecognizerDirectionDown  = 1 << 3
};

1.3.5 长按手势——UILongPressGestureRecognizer

在视图上用手指进行长按的手势------常用度三颗星

//设置触发前的点击次数
@property (nonatomic) NSUInteger numberOfTapsRequired;
//设置触发的触摸点数
@property (nonatomic) NSUInteger numberOfTouchesRequired;
//设置最短的长按时间
@property (nonatomic) CFTimeInterval minimumPressDuration;
//设置在按触时时允许移动的最大距离 默认为10像素
@property (nonatomic) CGFloat allowableMovement;

1.3.6 平移手势——UIPanGestureRecognzer

在视图上用手指进行平移的手势------常用度四颗星

//设置触发拖拽的最少触摸点，默认为1
@property (nonatomic)          NSUInteger minimumNumberOfTouches;
//设置触发拖拽的最多触摸点
@property (nonatomic)          NSUInteger maximumNumberOfTouches;
//获取当前位置
- (CGPoint)translationInView:(nullable UIView *)view;
//设置当前位置
- (void)setTranslation:(CGPoint)translation inView:(nullable UIView *)view;
//设置获取平移速度
- (CGPoint)velocityInView:(nullable UIView *)view;

1.3.7 屏幕边缘平移手势——UIScreenEdgePanGestureRecognzer

手指在屏幕四个边缘平移的手势------常用度三颗星

//设置在屏幕哪个边缘触发手势
@property (readwrite, nonatomic, assign) UIRectEdge edges;
typedef NS_OPTIONS(NSUInteger, UIRectEdge) {
    UIRectEdgeNone   = 0,
    UIRectEdgeTop    = 1 << 0,
    UIRectEdgeLeft   = 1 << 1,
    UIRectEdgeBottom = 1 << 2,
    UIRectEdgeRight  = 1 << 3,
    UIRectEdgeAll    = UIRectEdgeTop | UIRectEdgeLeft | UIRectEdgeBottom | UIRectEdgeRight
} NS_ENUM_AVAILABLE_IOS(7_0);

二、UIGestureRecognizer 和 UITouch 事件的关系

从runLoop底层看事件响应和手势的关系：

事件响应

苹果使用RunLoop注册了一个 Source1 (基于 mach port 的) 用来接收系统事件，其回调函数为 __IOHIDEventSystemClientQueueCallback()。

当一个硬件事件(触摸/锁屏/摇晃等)发生后，首先由 IOKit.framework 生成一个
IOHIDEvent 事件并由 SpringBoard 接收。这个过程的详细情况可以参考这里。SpringBoard 只接收按键(锁屏/静音等)，触摸，加速，接近传感器等几种 Event，随后用 mach port 转发给需要的App进程。随后苹果注册的那个 Source1 就会触发回调，并调用 _UIApplicationHandleEventQueue() 进> 行应用内部的分发。

_UIApplicationHandleEventQueue() 会把 IOHIDEvent 处理并包装成 UIEvent 进行处理或> 分发，其中包括识别 UIGesture/处理屏幕旋转/发送给 UIWindow 等。通常事件比如 >UIButton 点击、touchesBegin/Move/End/Cancel 事件都是在这个回调中完成的。

手势识别

当上面的 _UIApplicationHandleEventQueue() 识别了一个手势时，其首先会调用 Cancel > 将当前的 touchesBegin/Move/End 系列回调打断。随后系统将对应的 UIGestureRecognizer 标记为待处理。

苹果注册了一个 Observer 监测 BeforeWaiting (Loop即将进入休眠) 事件，这个Observer的回调函数是 _UIGestureRecognizerUpdateObserver()，其内部会获取所有刚被标记为待> 处理的 GestureRecognizer，并执行GestureRecognizer的回调。

当有 UIGestureRecognizer 的变化(创建/销毁/状态改变)时，这个回调都会进行相应处理。

三、自定义手势

如果系统提供的手势不能满足你，你也可以自定义手势。自定义手势需要继承：UIGestrureRecognizer,并且需要导入头文件#import <UIKit/UIGestureRecognizerSubclass.h>，实现以下四个方法：

– touchesBegan:withEvent:
– touchesMoved:withEvent:
– touchesEnded:withEvent:
- touchesCancelled:withEvent:

更多自定义手势内容请看这里

关于iOS-UITouch事件处理请看 UITouch事件处理-原理篇