ios delaysContentTouches和canCancelContentTouches属性的含义和应用场景-优快云博客

本文深入探讨了UIScrollView的delaysContentTouches和canCancelContentTouches属性。这两个属性影响着用户触摸事件如何处理，特别是涉及到滚动与子视图交互的情况。delaysContentTouches决定是否等待150ms再传递触摸事件，而canCancelContentTouches控制是否允许内容视图的触摸启动滚动。在快速滑动新闻类App顶部菜单栏时，这两个属性决定了按钮是否响应触摸。当UITableView出现手势延迟导致子视图无法完成两次绘制的问题时，可以通过调整这两个属性来解决。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

@property(nonatomic) BOOL delaysContentTouches;
A Boolean value that determines whether the scroll view delays the handling of touch-down gestures.

@property(nonatomic) BOOL canCancelContentTouches;
Description A Boolean value that controls whether touches in the content view always lead to tracking.
If the value of this property is YES and a view in the content has begun tracking a finger touching it, and if the user drags the finger enough to initiate a scroll, the view receives a touchesCancelled:withEvent: message and the scroll view handles the touch as a scroll. If the value of this property is NO, the scroll view does not scroll regardless of finger movement once the content view starts tracking.

UIScrollView有一个BOOL类型的tracking属性，用来返回用户是否已经触及内容并打算开始滚动，我们从这个属性开始探究UIScrollView的工作原理：

一、UIScrollView原理，以时间为轴线：
从你的手指touch屏幕开始，scrollView开始一个timer，如果：
1. 150ms内如果你的手指没有任何动作，消息就会传给subView。
2. 150ms内手指有明显的滑动（一个swipe动作），scrollView就会滚动，消息不会传给subView。
3. 150ms内手指没有滑动，scrollView将消息传给subView，但是之后手指开始滑动，scrollView传送touchesCancelled消息给subView，然后开始滚动。

二、UIScrollView原理，以tracking属性为轴线：
当手指触摸到UIScrollView内容的一瞬间，会产生下面的动作：

拦截触摸事件
tracking属性变为YES
一个内置的计时器开始生效，用来监控在极短的事件间隔内是否发生了手指移动

case1：当检测到时间间隔内手指发生了移动，UIScrollView自己触发滚动，tracking属性变为NO，手指触摸下即使有(可以响应触摸事件的)内部控件也不会再响应触摸事件。

case2：当检测到时间间隔内手指没有移动，tracking属性保持YES，手指触摸下如果有(可以响应触摸事件的)内部控件，则将触摸事件传递给控件进行处理。

delaysContentTouches原理（时间为轴线）

**
有很多新闻类的App顶部都有一个滑动菜单栏，主要模型可能是由一个UIScrollView包含多个UIButton控件组成；当你操作的时候，手指如果是很迅速的在上面划过，会发现即使手指触摸的地方有UIButton，但是并没有触发该UIButton的任何触摸事件，这就是上面提到的case1；当你手指是缓慢划过或根本就没动，才会触发UIButton的触摸事件，这是case2的情况。

上面的工作原理其实有一个属性开关来控制：delaysContentTouches。默认值为YES；如果设置为NO，则无论手指移动的多么快，始终都会将触摸事件传递给内部控件；设置为NO可能会影响到UIScrollView的滚动功能。

delaysContentTouches的作用：
这个标志默认是YES，使用上面的150ms的timer，如果设置为NO，touch事件立即传递给subView，不会有150ms的等待。

默认YES；如果设置为NO，会马上执行touchesShouldBegin:withEvent:inContentView:

- (BOOL)touchesShouldBegin:(NSSet<UITouch *> *)touches
             withEvent:(UIEvent *)event 
            inContentView:(UIView *)view

Discussion
The default behavior of UIScrollView is to invoke the UIResponder event-handling methods of the target subview that the touches occur in.

系统默认是允许UIScrollView，按照消息响应链向子视图传递消息的。（即返回YES）
Return Value
Return NO if you don’t want the scroll view to send event messages to view. If you want view to receive those messages, return YES (the default).

如果你不想UIScrollView的子视图接受消息，返回NO。

应用描述（作者注释）：这个方法是最先接收到滑动事件的（优先于button的
UIControlEventTouchDown，以及- (void)touchesCancelled:(NSSet )touches withEvent:(UIEvent )event），
如果返回YES，touche事件沿着消息响应链传递;
如果返回NO，表示UIScrollView接收这个滚动事件，不必沿着消息响应链传递了。

(BOOL)touchesShouldCancelInContentView:(UIView *)view
应用描述（作者注释）：
如果返回YES:(系统默认)是允许UIScrollView，按照消息响应链向子视图传递消息的
如果返回NO:UIScrollView,就接收不到滑动事件了。

canCancelContentTouches原理（tracking属性为轴线）

再看另一个BOOL类型的属性canCencelContentTouches，从字面上理解是“可以取消内容触摸“，默认值为YES。文档里的解释是这样的：

翻译为中文大致如下：

这个BOOL类型的值控制content view里的触摸是否总能引发跟踪(tracking)

如果属性值为YES并且跟踪到手指正触摸到一个内容控件，这时如果用户拖动手指的距离足够产生滚动，那么内容控件将收到一个touchesCancelled:withEvent:消息，而scroll view将这次触摸作为滚动来处理。如果值为NO，一旦content view开始跟踪(tracking==YES)，则无论手指是否移动，scrollView都不会滚动。

简单通俗点说，如果为YES，就会等待用户下一步动作，如果用户移动手指到一定距离，就会把这个操作作为滚动来处理并开始滚动，同时发送一个touchesCancelled:withEvent:消息给内容控件，由控件自行处理。如果为NO，就不会等待用户下一步动作，并始终不会触发scrollView的滚动了。

应用场景

UITableView 手势延迟导致subview无法完成两次绘制

问题：
在UITableViewCell 中点击自定义View 本来想在touchesBegan和touchesEnd中各触发一次绘制来模拟点击高亮的效果，但只要是快速点击就无法触发高亮效果，从而探究原因。

解释：
UIScrollView 中默认情况下对TouchesBegan进行了延迟（150ms）用于判断是否进行滑动如果滑动就不将事件传递给子view；由于延迟导致如果点击过快，这时候touchesBegan 和 touchesEnd就紧接着发生。
如果是在touchesBegan和touchesEnd里面都进行了 setNeedsDisplay 操作，标记需要绘制；而两次的间隔时间极小，导致Runloop 只执行一次绘制。换句话说同时标记了两次只有一次标记绘制生效。

iOS 的屏幕刷新为60FPS，也就是最多每秒发生60次的绘制。每一帧间隔就是 1000 ms / 60 = 16.66 ms ，当两次的绘制的间隔少于16.6毫秒时无法完成两次绘制只会触发一次绘制。

解决办法：
1.关闭UITableview的手势延迟，（但这种做法不怎么好，因为这样对滑动手势有影响）（delaysContentTouches = no）
2.在自定义的view中延迟执行绘制，相关的条件也要延迟获取（比如：touchesEnded 中获取点击的point等）。

                - (void)touchesEnded:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
UITouch *touch = [touches anyObject];
double delayInSeconds = .2;
dispatch_time_t popTime = dispatch_time(DISPATCH_TIME_NOW, (int64_t)(delayInSeconds * NSEC_PER_SEC));
dispatch_after(popTime, dispatch_get_main_queue(), ^(void){
    _endPoint = [touch locationInView:self];
    _touchPhase = touch.phase;
    [self setNeedsDisplay];
});

}