美文网首页
UIGestureRecognizer,UIGestureRec

UIGestureRecognizer,UIGestureRec

作者: 宝匣技术 | 来源:发表于2018-11-07 13:23 被阅读0次

    转自:https://www.jianshu.com/p/4f83db7e3e31    作者:林大鹏天地    内容排版有更改。

    一. UIGestureRecognizer的定义

    UIGestureRecognizer是一个抽象基类,定义了实现底层手势识别行为的编程接口,使得继承它的子类能处理具体的手势。

    手势状态定义:

    typedef NS_ENUM(NSInteger, UIGestureRecognizerState)
    {
        // 尚未识别是何种手势操作(但可能已经触发了触摸事件),默认状态:
        UIGestureRecognizerStatePossible,
        // 手势已经开始,此时已经被识别,但是这个过程中可能发生变化,手势操作尚未完成:
        UIGestureRecognizerStateBegan,
        // 手势状态发生改变:
        UIGestureRecognizerStateChanged,
        // 手势识别操作完成(此时已经松开手指):
         UIGestureRecognizerStateEnded,
        // 手势被取消,恢复到默认状态:
        UIGestureRecognizerStateCancelled,
        // 手势识别失败,恢复到默认状态:
        UIGestureRecognizerStateFailed,
        // 手势识别完成,同“UIGestureRecognizerStateEnded”:
        UIGestureRecognizerStateRecognized = UIGestureRecognizerStateEnded
    };

    “UIGestureRecognizer”类(接口)定义:

    @interface UIGestureRecognizer : NSObject

    //创建一个手势对象并添加触发事件
    - (instancetype)initWithTarget:(nullable id)target action:(nullable SEL)action NS_DESIGNATED_INITIALIZER;

    //给一个手势对象添加监听事件
    - (void)addTarget:(id)target action:(SEL)action; 

    //移除一个手势的监听事件
    - (void)removeTarget:(nullable id)target action:(nullable SEL)action;

    //获取当前手势状态
    @property(nonatomic,readonly) UIGestureRecognizerState state; 

    //委托
    @property(nullable,nonatomic,weak) id <UIGestureRecognizerDelegate> delegate;

    //手势识别是否可用
    @property(nonatomic, getter=isEnabled) BOOL enabled; 

    //获取手势触摸的View视图 只读
    @property(nullable, nonatomic,readonly) UIView *view;       

    // 是否取消触摸控件的响应
    默认为YES,这种情况下当手势识别器识别到触摸之后,会发送touchesCancelled给触摸到的控件以取消控件view对touch的响应,
    这个时候只有手势识别器响应touch,当设置成NO时,手势识别器识别到触摸之后不会发送touchesCancelled给控件,
    这个时候手势识别器和控件view均响应touch。
    注意:手势识别和触摸事件是同时存在的,只是因为touchesCancelled导致触摸事件失效、
    @property(nonatomic) BOOL cancelsTouchesInView;

    //是否延迟发送触摸事件给触摸到的控件
    默认是NO,这种情况下当发生一个触摸时,手势识别器先捕捉到到触摸,然后发给触摸到的控件,两者各自做出响应。如果设置为YES,手势识别器在识别的过程中(注意是识别过程),不会将触摸发给触摸到的控件,即控件不会有任何触摸事件。只有在识别失败之后才会将触摸事件发给触摸到的控件,这种情况下控件view的响应会延迟约0.15ms。
    @property(nonatomic) BOOL delaysTouchesBegan;   

    //如果触摸识别失败是否立即结束本次手势识别的触摸事件
    @property(nonatomic) BOOL delaysTouchesEnded;       

    //指定一个手势需要另一个手势执行失败才会执行,同时触发多个手势使用其中一个手势的解决办法
    有时手势是相关联的,如单机和双击,点击和长按,点下去瞬间可能只会识别到单击无法识别其他,该方法可以指定某一个 手势,即便自己已经满足条件了,也不会立刻触发,会等到该指定的手势确定失败之后才触发
    - (void)requireGestureRecognizerToFail:(UIGestureRecognizer *)otherGestureRecognizer;

    //获取当前触摸在指定视图上的点
    - (CGPoint)locationInView:(nullable UIView*)view;                             

    //获取触摸手指数
    - (NSUInteger)numberOfTouches;                                       

    //多指触摸的触摸点相对于指定视图的位置
    - (CGPoint)locationOfTouch:(NSUInteger)touchIndex inView:(nullable UIView*)view;

    @end

    二. UIGestureRecognizerDelegate的定义

    @protocol UIGestureRecognizerDelegate <NSObject>

    @optional

    //开始进行手势识别时调用的方法,返回NO则结束识别,不再触发手势,用处:可以在控件指定的位置使用手势识别
    - (BOOL)gestureRecognizerShouldBegin:(UIGestureRecognizer *)gestureRecognizer;

    //是否支持多手势触发,返回YES,则可以多个手势一起触发方法,返回NO则为互斥
    是否允许多个手势识别器共同识别,一个控件的手势识别后是否阻断手势识别继续向下传播,默认返回NO;
    如果为YES,响应者链上层对象触发手势识别后,如果下层对象也添加了手势并成功识别也会继续执行,否则上层对象识别后则不再继续传播
    - (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldRecognizeSimultaneouslyWithGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer;

    // 这个方法返回YES,第一个手势和第二个互斥时,第一个会失效
    // 注意:此处的“ Require ”应当被翻译做依赖,而不是要求。
    - (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldRequireFailureOfGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer NS_AVAILABLE_IOS(7_0);

    // 这个方法返回YES,第一个和第二个互斥时,第二个会失效
    // 注意:此处的“ Require ”应当被翻译做依赖,而不是要求。
    - (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldBeRequiredToFailByGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer NS_AVAILABLE_IOS(7_0);

    //手指触摸屏幕后回调的方法,返回NO则不再进行手势识别,方法触发等
    此方法在window对象在有触摸事件发生时,调用gesture recognizer的touchesBegan:withEvent:方法之前调用,
    如果返回NO,则gesture recognizer不会看到此触摸事件。(默认情况下为YES)
    - (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldReceiveTouch:(UITouch *)touch;

    @end

    作者:林大鹏天地
    链接:https://www.jianshu.com/p/4f83db7e3e31
    來源:简书
    简书著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。

    相关文章

      网友评论

          本文标题:UIGestureRecognizer,UIGestureRec

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