手势UIGestureRecognizer类详解

前言:官方文档

概述

UIGestureRecognizer类是用于具体手势识别器的基本类。应用在添加手势识别功能时,需要针对特定的手势创建相对应的UIGestureRecognizer子类对象,而不是直接使用UIGestureRecognizer对象。使用UIGestureRecognizer子类对象的时候,除了要设置目标-动作对,还要将该子类对象添加在某个视图上。当该子类对象根据当前加载到的视图所发生的触摸事件识别出相应的手势时,就会向指定的目标对象发送指定的动作消息。由UIGestureRecognizer对象发出的动作消息遵循以下规范:

- (void)gestureRecognizerDetected:(UIGestureRecognizer *)recognizer;

UIGestureRecognizer对象在识别手势时,会截取本应由其附着的视图自行处理的触摸事件(如下图所示),所有,附着了UIGestureRecognizer对象的视图可能不会接收到常规的UIResponder消息,例如响应触摸事件方法- (void)touchesBegan:(NSSet *)touches withEvent:(nullable UIEvent *)event。


UIGestureRecognizer包含以下子类

1、UITapGestureRecognizer(点击手势)

2、UIPinchGestureRecognizer(捏合手势)

3、UIRotationGestureRecognizer(旋转手势)

4、UISwipeGestureRecognizer(滑动手势)

5、UIPanGestureRecognizer(拖动手势)

6、UIScreenEdgePanGestureRecognizer(边缘手势)

7、UILongPressGestureRecognizer(长按手势)

属性方法

1、初始化识别器

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

2、管理手势交互

/*手势识别器委托*/

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

UIGestureRecognizerDelegate

A、手势识别

/*开始触摸*/

- (BOOL)gestureRecognizerShouldBegin:(UIGestureRecognizer *)gestureRecognizer;

/*是否允许手势识别器检查触摸对象,默认为YES*/

- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldReceiveTouch:(UITouch *)touch;

/*是否允许手势识别器检查按压对象,默认为YES,Press表示特定事件的屏幕上按下按钮的存在或移动的对象*/

- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldReceivePress:(UIPress *)press;

B、控制同时手势识别

/*是否允许多个识别器同时识别其对应的手势,默认为NO*/

- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldRecognizeSimultaneouslyWithGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer;

C、设置故障要求(手势的互斥)

/*建立一个动态的故障要求,YES表示第一个手势和第二个互斥时,第一个会失效,默认为NO*/

- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldRequireFailureOfGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer NS_AVAILABLE_IOS(7_0);

/*建立一个动态的故障要求,YES表示第一个手势和第二个互斥时,第二个会失效,默认为NO*/

- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldBeRequiredToFailByGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer NS_AVAILABLE_IOS(7_0);

3、添加和移除

/*添加目标动作*/

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

/*删除指定的目标动作*/

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

4、获取手势的触摸位置

/*获取触发触摸的点*/

- (CGPoint)locationInView:(nullable UIView*)view; 

/*获取指定触摸的点的位置*/

- (CGPoint)locationOfTouch:(NSUInteger)touchIndex inView:(nullable UIView*)view;

/*触摸的次数*/

@property(nonatomic, readonly) NSUInteger numberOfTouches;   

/*返回触摸的次数*/

- (NSUInteger)numberOfTouches;  

5、获取识别器的状态和视图

A、手势状态

/*手势的当前状态*/

@property(nonatomic,readonly) UIGestureRecognizerState state;

/*手势的状态枚举*/

typedef NS_ENUM(NSInteger, UIGestureRecognizerState) {   

/*默认状态,此时识别器尚未识别其手势,但可能正在评估触摸事件*/

UIGestureRecognizerStatePossible,  

/*手势开始识别*/

UIGestureRecognizerStateBegan,    

/*手势识别改变*/     

UIGestureRecognizerStateChanged,   

/*手势识别结束*/

UIGestureRecognizerStateEnded,          

/*手势识别取消*/

UIGestureRecognizerStateCancelled,

/*手势识别失败*/

UIGestureRecognizerStateFailed,

/*手势识别完成,在运行循环的下一个周期发送其动作消息(或消息),并将其状态重置为UIGestureRecognizerStatePossible状态*/

UIGestureRecognizerStateRecognized = UIGestureRecognizerStateEnded

};

B、手势的视图

@property(nullable, nonatomic,readonly) UIView *view;

C、手势是否有效

/*开启和禁用手势,默认为YES*/

@property(nonatomic, getter=isEnabled) BOOL enabled;  

6、取消和延迟触摸

/* 默认为YES,这种情况下当手势识别器识别到touch之后,会发送touchesCancelled:withEvent:消息给视图以取消该视图对touch的响应,这个时候只有手势识别器响应touch。当设置成NO时,手势识别器识别到touch之后不会发送touchesCancelled:withEvent:消息给视图,这个时候手势识别器和视图均响应touch*/

@property(nonatomic) BOOL cancelsTouchesInView;

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

@property(nonatomic) BOOL delaysTouchesBegan;

/*默认为YES,这种情况下发生一个touch时,在手势识别成功后,发送给touchesCancelled:withEvent:消息给视图,手势识别失败时,会延迟大概0.15ms,期间没有接收到别的touch才会发送touchesEnded。如果设置为NO,则不会延迟,即会立即发送touchesEnded以结束当前触摸*/

@property(nonatomic) BOOL delaysTouchesEnded; 

7、指定手势识别器之间的依赖关系

/*设置优先触发的手势,第一个参数是需要失效的手势,第二个是生效的手势,只有在第二个手势失效的情况下才会触发第一个手势*/

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

8、识别不同的手势

/*按压*/

@property(nonatomic, copy) NSArray *allowedPressTypes NS_AVAILABLE_IOS(9_0);

/*触摸*/

@property(nonatomic, copy) NSArray *allowedTouchTypes NS_AVAILABLE_IOS(9_0); 

/*是否考虑不同类型的触摸,默认为YES*/

@property (nonatomic) BOOL requiresExclusiveTouchType NS_AVAILABLE_IOS(9_2);

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

推荐阅读更多精彩内容