typedef NS_ENUM(NSInteger, UIGestureRecognizerState) { UIGestureRecognizerStatePossible, // 尚未识别是何种手势操作(但可能已经触发了触摸事件),默认状态 UIGestureRecognizerStateBegan, // 手势已经开始 此时已经被识别 但是这个过程中可能发生变化 手势操作尚未完成 UIGestureRecognizerStateChanged, // 手势状态发生改变 UIGestureRecognizerStateEnded, // 手势识别已完成(此时已经松开手指) UIGestureRecognizerStateCancelled, // 手势被取消 恢复到默认状态 UIGestureRecognizerStateFailed, // 手势识别失败 恢复到默认状态 UIGestureRecognizerStateRecognized = UIGestureRecognizerStateEnded // 手势识别完成同end };
UIGestureRecognizer 方法
NS_CLASS_AVAILABLE_ios(3_2) @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; // 手势识别是否可用 @property(nullable, nonatomic,readonly) UIView *view; // 获取手势触摸的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;
//多指触摸的触摸点相对于指定视图的位置
- (CGPoint)locationOfTouch:(NSUInteger)touchIndex inView:(nullable UIView*)view;
UIGestureRecognizer是一个抽象类,定义了所有手势的基本行为,使用它的子类才能处理具体的手势
UITapGestureRecognizer(轻触,点按)
UILongPressGestureRecognizer(长按)
UISwipeGestureRecognizer(轻扫手势)
UIRotationGestureRecognizer(旋转手势)
UIPanGestureRecognizer(拖拽手势)
UIPinchGestureRecognizer(捏合手势,缩放用)
关于UIGestureRecognizerDelegate代理的内容
// 开始进行手势识别的时候调用的方法 返回NO则结束识别 不再触发手势 用处:可以在控件指定的位置使用手势识别 - (BOOL)gestureRecognizerShouldBegin:(UIGestureRecognizer *)gestureRecognizer; // 是否支持多手势触发 返回YES 则可以多个手势一起触发方法 返回NO则为互斥 // 是否允许多个手势识别器共同识别 一个空间的手势识别后是否阻断手势识别继续向下传播 默认返回NO,如果返回YES 响应者链上层对象触发手势识别后,如果下层对象也添加了手势并成功识别也会继续执行,否则上层对象识别后则不再继续传播 - (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); // 手指触摸屏幕后回调的方法 返回NO则不在进行手势识别 方法触发 - (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldReceiveTouch:(UITouch *)touch; // called before pressesBegan:withEvent: is called on the gesture recognizer for a new press. return NO to prevent the gesture recognizer from seeing this press
//返回NO不接受按压事件 - (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldReceivePress:(UIPress *)press;
UITapGestureRecognizer和UIButton的点击事件冲突的解决办法
- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldReceiveTouch:(UITouch *)touch{ if ([touch.view isKindOfClass:[UIButton class]]) { return NO; } return YES; }