美文网首页ios进阶酷fighting~iOS开发专题
iOS-手势UIGestureRecognier详解

iOS-手势UIGestureRecognier详解

作者: xx_cc | 来源:发表于2016-08-17 02:03 被阅读2422次

    一. 手势UIGestureRecognier简介

    iOS 3.2之后,苹果推出了手势识别功能(Gesture Recognizer),在触摸事件处理方面,大大简化了开发者的开发难度。利用UIGestureRecognizer,能轻松识别用户在某个view上面做的一些常见手势。UIGestureRecognizer是一个抽象类,对iOS中的事件传递机制面向应用进行封装,将手势消息的传递抽象为了对象。其中定义了所有手势的基本行为,使用它的子类才能处理具体的手势。

    二. 手势的抽象类——UIGestureRecognizer

    UIGestureRecognizer将一些和手势操作相关的方法抽象了出来,但它本身并不实现什么手势,因此,在开发中,我们一般不会直接使用UIGestureRecognizer的对象,而是通过其子类进行实例化,iOS系统给我们提供了许多用于实例的子类,这些我们后面再说,我们先来看一下,UIGestureRecognizer中抽象出了哪些方法。

    1. 初始化方法

    UIGestureRecognizer类为其子类准备好了一个统一的初始化方法,无论什么样的手势动作,其执行的结果都是一样的:触发一个方法,可以使用下面的方法进行统一的初始化:

    - (instancetype)initWithTarget:(nullable id)target action:(nullable SEL)action
    

    当然,如果我们使用alloc-init的方式,也是可以的,下面的方法可以为手势添加触发的selector:

    - (void)addTarget:(id)target action:(SEL)action;
    

    与之相对应的,我们也可以将一个selector从其手势对象上移除:

    - (void)removeTarget:(nullable id)target action:(nullable SEL)action;
    

    因为addTarget方式的存在,iOS系统允许一个手势对象可以添加多个selector触发方法,并且触发的时候,所有添加的selector都会被执行,我们以点击手势示例如下:

    - (void)viewDidLoad {
        [super viewDidLoad];
        UITapGestureRecognizer *tap1 = [[UITapGestureRecognizer alloc]initWithTarget:self action:@selector(tap1:)];
        [tap1 addTarget:self action:@selector(tap2:)];
        [self.view addGestureRecognizer:tap1];
    }
    -(void)tap1:(UITapGestureRecognizer *)tap
    {
        NSLog(@"%s",__func__);
    }
    -(void)tap2:(UITapGestureRecognizer *)tap
    {
        NSLog(@"%s",__func__);
    }
    

    点击屏幕,打印内容如下,说明两个方法都触发了


    tap打印内容

    2. 手势状态

    UIgestureRecognizer类中有如下一个属性,里面枚举了一些手势的当前状态:

    @property(nonatomic,readonly) UIGestureRecognizerState state;
    

    枚举值如下:

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

    3. 常用属性和方法

    //手势代理 代理中有一些手势触发的方法,后面拿出来详细说明
    @property(nullable,nonatomic,weak) id <UIGestureRecognizerDelegate> delegate; 
    //设置手势是否有效
    @property(nonatomic, getter=isEnabled) BOOL enabled;  
    //获取手势所在的View
    @property(nullable, nonatomic,readonly) UIView *view;          
    //默认是YES。当识别到手势的时候,终止touchesCancelled:withEvent:或pressesCancelled:withEvent:发送的所有触摸事件。
    @property(nonatomic) BOOL cancelsTouchesInView;     
    //默认为NO ,在触摸开始的时候,就会发消息给事件传递链,如果设置为YES,在触摸没有被识别失败前,都不会给事件传递链发送消息。  
    @property(nonatomic) BOOL delaysTouchesBegan;    
    //默认为YES 。这个属性设置手势识别结束后,是立刻发送touchesEnded或pressesEnded消息到事件传递链或者等待一个很短的时间后,如果没有接收到新的手势识别任务,再发送。
    @property(nonatomic) BOOL delaysTouchesEnded;         
    
    @property(nonatomic, copy) NSArray<NSNumber *> *allowedTouchTypes NS_AVAILABLE_IOS(9_0); // Array of UITouchType's as NSNumbers.
    @property(nonatomic, copy) NSArray<NSNumber *> *allowedPressTypes NS_AVAILABLE_IOS(9_0); // Array of UIPressTypes as NSNumbers.
    
    //[A requireGestureRecognizerToFail:B]手势互斥 它可以指定当A手势发生时,即便A已经滿足条件了,也不会立刻触发,会等到指定的手势B确定失败之后才触发。
    - (void)requireGestureRecognizerToFail:(UIGestureRecognizer *)otherGestureRecognizer;
    //获取当前触摸的点
    - (CGPoint)locationInView:(nullable UIView*)view;
    //设置触摸点数
    - (NSUInteger)numberOfTouches;
    //获取某一个触摸点的触摸位置
    - (CGPoint)locationOfTouch:(NSUInteger)touchIndex inView:(nullable UIView*)view; 
    

    3.1 个别属性详解

    其中几个BOOL值的属性,对于手势触发的控制也十分重要,下面我们举个栗子来详细说明一下以下三个方法。

    @property(nonatomic) BOOL cancelsTouchesInView;
    @property(nonatomic) BOOL delaysTouchesBegan;
    @property(nonatomic) BOOL delaysTouchesEnded;
    
    - (void)viewDidLoad {
        [super viewDidLoad];
        UIPanGestureRecognizer *pan = [[UIPanGestureRecognizer alloc]initWithTarget:self action:@selector(pan:)];
        pan.cancelsTouchesInView = NO;
    //    pan.delaysTouchesBegan = YES;
        [self.view addGestureRecognizer:pan];    
    }
    -(void)touchesMoved:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event
    {
        NSLog(@"touchMoved手势触发");
    }
    -(void)pan:(UIPanGestureRecognizer *)pan{
        NSLog(@"pan手势触发");
    }
    

    pan.cancelsTouchesInView属性默认设置为YES,如果识别到了手势,系统将会发送touchesCancelled:withEvent:消息在其时间传递链上,终止触摸事件的传递,也就是说默认当识别到手势时,touch事件传递的方法将被终止而不执行,如果设置为NO,touch事件传递的方法仍然会被执行,上例中我们使用了拖拽手势和touchesMoved两个触发方式,当我们把cancelTouchesInView设置为NO时,在屏幕上滑动,两种方式都在触发,打印如下:

    pan.cancelsTouchesInView = NO;

    而当我们将pan.cancelsTouchesInView = YES属性设置为YES时,打印结果如下

    pan.cancelsTouchesInView = YES

    我们发现touchesMoved的方法仍然被调用了,这是为什么呢?这就涉及到第二个属性delaysTouchesBegan这是因为手势识别是有一个过程的,拖拽手势需要一个很小的手指移动的过程才能被识别为拖拽手势,而在一个手势触发之前,是会一并发消息给事件传递链的,所以才会有最开始的几个touchMoved方法被调用,当识别出拖拽手势以后,就会终止touch事件的传递。
    delaysTouchesBgan属性用于控制这个消息的传递时机,默认这个属性为NO,此时在触摸开始的时候,就会发消息给事件传递链,如果我们设置为YES,在触摸没有被识别失败前,都不会给事件传递链发送消息。
    因此当我们设置pan.delaysTouchesBegan = YES;时打印内容如下

    pan.delaysTouchesBegan = YES;

    因为此时在拖拽手势识别失败之前,都不会给时间传递链发送消息,所以就不会在调用touchesMoved触发事件了

    delaysTouchesEnded属性默认是YES,当设为YES时在手势识别结束后,会等待一个很短的时间,如果没有接收到新的手势识别任务,才会发送touchesEnded消息到事件传递链,设置为NO之后会立刻发送touchesEnded消息到事件传递链我们同样来看一个例子:

    - (void)viewDidLoad {
        [super viewDidLoad];
        UITapGestureRecognizer *tap = [[UITapGestureRecognizer alloc]initWithTarget:self action:@selector(tap:)];
        tap.numberOfTapsRequired = 3;
    // tap.cancelsTouchesInView = NO;
    // tap.delaysTouchesBegan = YES;
        tap.delaysTouchesEnded = NO;
        [self.view addGestureRecognizer:tap];    
    }
    -(void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event{
        NSLog(@"touchBegan手势开始");
    }
    -(void)touchesEnded:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event
    {
        NSLog(@"touchEnd手势触发结束");
    }
    -(void)tap:(UITapGestureRecognizer *)tap
    {
        NSLog(@"tap手势触发");
    }
    

    tap.delaysTouchesEnded = NO;时,轻拍三下屏幕,打印如下

    tap.delaysTouchesEnded = NO;
    我们发现我们每点击一下,都会立即发送touchesEnded消息到事件传递链。
    而当tap.delaysTouchesEnded = YES;时,轻拍三下屏幕,打印如下
    tap.delaysTouchesEnded = YES;
    等三下轻拍手势识别结束后,才会发送消息到事件传递链。

    3.2 重点方法详解-手势间的互斥处理

    同一个View上是可以添加多个手势对象的,默认这些手势是互斥的,一个手势触发了就会默认屏蔽其他相似的手势动作。比如,单击和双击并存时,如果不做处理,它就只能发送出单击的消息。为了能够识别出双击手势,就需要用下面的方法一个特殊处理逻辑,即先判断手势是否是双击,在双击失效的情况下作为单击手势处理。

    - (void)requireGestureRecognizerToFail:(UIGestureRecognizer *)otherGestureRecognizer;
    

    [A requireGestureRecognizerToFail:B] 它可以指定当A手势发生时,即便A已经滿足条件了,也不会立刻触发,会等到指定的手势B确定失败之后才触发。
    看一个例子

    - (void)viewDidLoad {
        [super viewDidLoad];
        UITapGestureRecognizer *tap1 = [[UITapGestureRecognizer alloc]initWithTarget:self action:@selector(tap1:)];
        tap1.numberOfTapsRequired = 1;
        [self.view addGestureRecognizer:tap1];
        UITapGestureRecognizer *tap2 = [[UITapGestureRecognizer alloc]initWithTarget:self action:@selector(tap2:)];
        tap2.numberOfTapsRequired = 2;
        [self.view addGestureRecognizer:tap2];  
       //当tap2手势触发失败时才会触发tap1手势
        [tap1 requireGestureRecognizerToFail:tap2];
    }
    -(void)tap1:(UITapGestureRecognizer *)tap
    {
        NSLog(@"tap1手势触发");
    }
    -(void)tap2:(UITapGestureRecognizer *)tap
    {
        NSLog(@"tap2手势触发");
    }
    

    3.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);
    

    三. UIGestureRecognizer子类及子类属性

    除了UIGestureRecognizer中的方法和属性是所有子类通用的之外,UIGestureRecognizer子类中分别有不同的属性和方法来对应不同的手势。

    1. 点击手势——UITapGestureRecognizer

    点击手势十分简单,支持单击和多次点击,在我们手指触摸屏幕并抬起手指时会进行触发,其中有如下两个属性我们可以进行设置:

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

    2. 捏合手势——UIPinchGestureRecognizer

    捏合手势是当我们双指捏合和扩张会触发动作的手势,我们可以设置的属性如下:

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

    3. 拖拽手势——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;
    

    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
    };
    

    5. 旋转手势——UIRotationGestureRecognizer

    进行旋转动作时触发手势方法。

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

    6. 长按手势——UILongPressGestureRecognizer

    进行长按的时候触发的手势方法。

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

    7. 自定义手势

    自定义手势继承:UIGestureRecognizer,实现下面的方法,在以下方法中判断自定义手势是否实现。

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

    注意.m文件中需要引入#import <UIKit/UIGestureRecognizerSubclass.h>。

    关于iOS-UITouch事件处理过程可以看这篇文章iOS-UITouch事件处理详解
    ✨本文借鉴了很多前辈的文章,如果有不对的地方请指正,欢迎大家一起交流学习 xx_cc 。

    相关文章

      网友评论

      • 杨__:你好,tap1.cancelsTouchesInView=NO;这个状态下依然只触发了selector的方法,并没有出发touches方法。
        代码: UIPanGestureRecognizer *tap1=[[UIPanGestureRecognizer alloc]initWithTarget:self action:@selector(pan:)];
        tap1.delegate=self;
        tap1.cancelsTouchesInView=NO;
        [self.view addGestureRecognizer:tap1];
        -(void)touchesMoved:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event
        {
        NSLog(@"touchesMoved");
        }
        -(void)pan:(UIGestureRecognizer *)tap
        {
        NSLog(@"pan");
        }
        杨__:@杨__ 好吧,我在UIImageView上只出现pan:方法,在uiview上面才能显示这两个方法。
      • 6ea54dc08ca1:这个代码能不能私聊发一下呢 谢谢
        6ea54dc08ca1:@xx_cc 哦好的谢谢
        xx_cc:@天佑love清清 这个的代码?这个没有什么代码 都是一些测试的代码啊。

      本文标题:iOS-手势UIGestureRecognier详解

      本文链接:https://www.haomeiwen.com/subject/zilqsttx.html