UIGestureRecognizer,UIGestureRecognizerDelegate详解

转自: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
來源:简书
简书著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,377评论 6 496
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,390评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,967评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,344评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,441评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,492评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,497评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,274评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,732评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,008评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,184评论 1 342
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,837评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,520评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,156评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,407评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,056评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,074评论 2 352

推荐阅读更多精彩内容