iOS UIGestureRecognizer (手势的基本知识介绍)

最新推荐文章于 2025-06-07 13:00:00 发布

00烽火连城00

最新推荐文章于 2025-06-07 13:00:00 发布

阅读量891

点赞数 1

本文详细介绍iOS中的各种手势识别器，包括点按、长按、捏合、旋转、拖动及轻扫手势，并解释如何实现手势的自定义及互斥处理。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

手势识别在 iOS 中非常重要，他极大地提高了移动设备的使用便捷性。iOS 系统在 3.2 以后，他提供了一些常用的手势（UIGestureRecognizer 的子类），开发者可以直接使用他们进行手势操作。
手势类型(他们都继承自UIGestureRecognizer，而UIGestureRecognizer继承自NSObject)

UIPanGestureRecognizer（拖动）
UIPinchGestureRecognizer（捏合）
UIRotationGestureRecognizer（旋转）
UITapGestureRecognizer（点按）
UILongPressGestureRecognizer（长按）
UISwipeGestureRecognizer（轻扫）
 1
2
3
4
5
6
 1
2
3
4
5
6

代码实战的时候，通常继承 UIGestureRecognizer 类，实现自定义手势（手势识别器类)一般设计成单利对象。因为事件传递如果是通过Block或者是代理，那么如果超过识别器的生命周期，手势将不能正常响应（具体看github代码）
-(void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event; -(void)touchesMoved:(NSSet *)touches withEvent:(UIEvent *)event; -(void)touchesEnded:(NSSet *)touches withEvent:(UIEvent *)event; -(void)touchesCancelled:(NSSet *)touches withEvent:(UIEvent *)event;
手势的互斥的原则

1.手势识别是具有互斥的原则的，比如单击和双击，如果它识别出一种手势，其后的手势将不被识别。所以对于关联手势，要做特殊处理以帮助程序甄别，应该把当前手势归结到哪一类手势里面。
2.比如，单击和双击并存时，如果不做处理，它就只能发送出单击的消息。为了能够识别出双击手势，就需要做一个特殊处理逻辑，即先判断手势是否是双击，在双击失效的情况下作为单击手势处理。使用
[A requireGestureRecognizerToFail：B]函数，它可以指定当A手势发生时，即便A已经滿足条件了，也不会立刻触发，会等到指定的手势B确定失败之后才触发。

    //添加双击手势确定监测失败才会触发单击手势的相应操作
    [tapOne requireGestureRecognizerToFail:tapTow];
 1
2
 1
2

如果手势和scrollview一起使用就要防止只相应scrollView事件

    scrollView.canCancelContentTouches=NO;
    scrollView.delaysContentTouches=NO;
 1
2
 1
2

手势的几种状态

 typedef NS_ENUM(NSInteger, UIGestureRecognizerState) {
  // 尚未识别是何种手势操作（但可能已经触发了触摸事件），默认状态
       UIGestureRecognizerStatePossible, 
  // 手势已经开始，此时已经被识别，但是这个过程中可能发生变化，手势操作尚未完成
       UIGestureRecognizerStateBegan,    
 // 手势状态发生转变
       UIGestureRecognizerStateChanged,
 // 手势识别操作完成（此时已经松开手指）   
       UIGestureRecognizerStateEnded,     
// 手势被取消，恢复到默认状态
       UIGestureRecognizerStateCancelled,  
 // 手势识别失败，恢复到默认状态
       UIGestureRecognizerStateFailed,   
// 手势识别完成，同UIGestureRecognizerStateEnded 
       UIGestureRecognizerStateRecognized 
       UIGestureRecognizerStateEnded 
};
 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

手势经常用的属性

//设置代理，具体的协议后面会说
@property(nullable,nonatomic,weak) id <UIGestureRecognizerDelegate> delegate; 
//设置手势是否有效
@property(nonatomic, getter=isEnabled) BOOL enabled;
//获取手势所在的view
@property(nullable, nonatomic,readonly) UIView *view; 
//获取触发触摸的点
-(CGPoint)locationInView:(nullable UIView*)view; 
//设置触摸点数
-(NSUInteger)numberOfTouches; 
//获取某一个触摸点的触摸位置
-(CGPoint)locationOfTouch:(NSUInteger)touchIndex inView:(nullable UIView*)view;
//这个方法中第一个参数是需要时效的手势，第二个是生效的手势。
-(void)requireGestureRecognizerToFail:(UIGestureRecognizer *)otherGestureRecognizer;
//获取到的是手指移动后，在相对坐标中的偏移量
-(CGPoint)translationInView:(nullable UIView *)view;
 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

相对重要的BOOL属性

@property(nonatomic) BOOL cancelsTouchesInView;
当这个属性设置为YES时，如果识别到了手势，
系统将会发送touchesCancelled:withEvent:消息在其时间传递链上，
终止触摸事件的传递，
设置为NO，则不会终止事件的传递
 1
2
3
4
5
 1
2
3
4
5

@property(nonatomic) BOOL delaysTouchesBegan;
这个属性设置手势识别结束后，是立刻发送touchesEnded消息到事件传递链或者等待一个很短的时间后，
如果没有接收到新的手势识别任务，再发送。
 1
2
3
 1
2
3

UIGestureRecognizerDelegate

前面我们提到过关于手势对象的协议代理，通过代理的回调，我们可以进行自定义手势，也可以处理一些复杂的手势关系，其中方法如下：

//手指触摸屏幕后回调的方法，返回NO则不再进行手势识别，方法触发等
- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldReceiveTouch:(UITouch *)touch;
//开始进行手势识别时调用的方法，返回NO则结束，不再触发手势
- (BOOL)gestureRecognizerShouldBegin:(UIGestureRecognizer *)gestureRecognizer;
//是否支持多时候触发，返回YES，则可以多个手势一起触发方法，返回NO则为互斥
- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldRecognizeSimultaneouslyWithGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer;
//下面这个两个方法也是用来控制手势的互斥执行的
//这个方法返回YES，第一个手势和第二个互斥时，第一个会失效
- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldRequireFailureOfGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer NS_AVAILABLE_IOS(7_0);
//这个方法返回YES，第一个和第二个互斥时，第二个会失效
- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldBeRequiredToFailByGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer NS_AVAILABLE_IOS(7_0);
 1
2
3
4
5
6
7
8
9
10
11
 1
2
3
4
5
6
7
8
9
10
11

UIGestureRecognizer的子类介绍
一、UITapGestureRecognizer（tap点按）

点击作为最常用手势，用于按下或选择一个控件或条目（类似于普通的鼠标点击);
tap手势属于离散型手势，特点是：一旦识别就无法取消，而且只会调用一次手势操作事件（初始化手势时指定的回调方法）

代码

    //一次点击
    UITapGestureRecognizer *tapOne = [[UITapGestureRecognizer alloc]initWithTarget:self action:@selector(tapWithOne:)];
    tapOne.delegate = self;
    [self.view addGestureRecognizer:tapOne];
    //设置触控对象的个数（几个手指）
    [tapOne setNumberOfTouchesRequired:1];
    //点击次数
    [tapOne setNumberOfTapsRequired:1];
    //两次点击
    UITapGestureRecognizer *tapTow = [[UITapGestureRecognizer alloc]initWithTarget:self action:@selector(tapWithTow:)];
    tapTow.delegate = self;
    //一根手指操作
    [tapOne setNumberOfTouchesRequired:1];
    //点击两次生效
    tapTow.numberOfTapsRequired = 2;
    [self.view addGestureRecognizer:tapTow];
    //添加双击手势确定监测失败才会触发单击手势的相应操作
    [tapOne requireGestureRecognizerToFail:tapTow];
-(void)tapWithOne: (UITapGestureRecognizer *)tapOne {
    NSLog(@"被点击了一次");
}
-(void)tapWithTow: (UITapGestureRecognizer *)tapTow {
    NSLog(@"被点击了两次");
}
 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

二、 UILongPressGestureRecognizer（长按手势）

1.属性：

//长点击响应前点击次数,默认0；
@property (nonatomic) NSUInteger numberOfTapsRequired;
//__TVOS_PROHIBITED: 用户触摸的手指数，默认1；
@property (nonatomic) NSUInteger numberOfTouchesRequired ;
//长按最低时间，默认0.5秒；
@property (nonatomic) CFTimeInterval minimumPressDuration;
// 手指长按期间可移动的区域，默认10像素。
@property (nonatomic) CGFloat allowableMovement;
 1
2
3
4
5
6
7
8
 1
2
3
4
5
6
7
8

三、UIPinchGestureRecognizer（捏合手势）

1.属性：

//缩放的比例，默认为1；
@property (nonatomic) CGFloat scale;
//缩放的速度，放大为+，缩小为-。
@property (nonatomic,readonly) CGFloat velocity;
 1
2
3
4
 1
2
3
4

四、UILongPressGestureRecognizer（长按）
长按手势一定需要和UIGestureRecognizer类的state属性进行配合使用，即通过不同状态state下，实现不同的功能。
1. 基本属性和方法

 //设置该拖动手势处理器最多支持几个手指拖动。
maximumNumberOfTouches:
//指定用户至少在屏幕上按下多少秒才会触发该长按手势。该默认值为0.5
minimumPressDuration: 
//获取该拖动手势在指定控件上的位移。该方法返回一个CGPoint结构体数据，该结构体中x变量的值代表了水平方向的位移，y变量的值代表了垂直方向的位移。
-translationInView: 
 //获取该拖动手势在指定控件上的拖动速度。该方法返回一个CGPoint结构体数据，该结构体中x变量的值代表了水平方向的速度，y变量的值代表了垂直方向的速度。
-velocityInView:
 1
2
3
4
5
6
7
8
 1
2
3
4
5
6
7
8

五、UIRotationGestureRecognizer（旋转）
属性：

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

**六、UIPanGestureRecognizer（拖动手势）**
属性：

 1
2
3
4
5
6
 1
2
3
4
5
6

//最小的拖动范围
@property (nonatomic) NSUInteger minimumNumberOfTouches __TVOS_PROHIBITED;
//最大拖动范围
@property (nonatomic) NSUInteger maximumNumberOfTouches __TVOS_PROHIBITED;
//获取移动后相对与view的坐标系的偏移量
- (CGPoint)translationInView:(nullable UIView *)view;
//获取移动后的坐标
- (void)setTranslation:(CGPoint)translation inView:(nullable UIView *)view;


**七、UISwipeGestureRecognizer**
>需要注意的是如果想要实现多方向清扫，要创建多个清扫手势对象
属性
 1
2
3
4
 1
2
3
4

//最小的扫动距离
@property(nonatomic) NSUInteger numberOfTouchesRequired;
//轻扫的方向默认UISwipeGestureRecognizerDirectionRight
@property(nonatomic) UISwipeGestureRecognizerDirection direction;
“`

手势相关的基本知识就是这些了，如果有什么问题欢迎大家指正，如果有兴趣，大家可以下载，手势工具类源码查看