shouldBeRequiredToFailByGestureRecognizer 和 shouldRequireFailureOfGestureRecognizer 是UIKit中的两个手势识别器(GestureRecognizer)代理方法,它们用于处理多个手势识别器之间的交互和优先级。这两个方法帮助决定当多个手势可能同时被识别时,哪一个手势应该生效或失败。但它们的角度和用途有所不同:
shouldBeRequiredToFailByGestureRecognizer:
这个方法被调用在另一个手势识别器(作为参数传递的那个)上,询问当前手势识别器是否应该在另一个手势识别器成功之前失败。换句话说,这个方法是用来确定当前手势是否要有更低的优先级,需要等待其他特定的手势识别器失败后才能尝试识别。此方法在UIGestureRecognizerDelegate协议中定义,其原型如下:
func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldBeRequiredToFailBy otherGestureRecognizer: UIGestureRecognizer) -> Bool
如果返回true,则表示当前手势识别器应该在otherGestureRecognizer失败后才尝试识别;如果返回false,则不改变它们的默认优先级关系。
shouldRequireFailureOfGestureRecognizer:
相比之下,这个方法是在设置一个手势识别器时使用,用来指定它需要等待另一个特定手势识别器失败后才能开始尝试识别。这是在手势识别器实例化并配置时设置的,而不是通过代理方法。也就是说,当你初始化一个手势识别器并希望它在另一个手势失败后才激活时,你将使用这个方法来建立这种依赖关系。这不是一个代理方法,而是一个直接在手势识别器上配置的属性或方法(尽管具体实现细节可能因不同的子类而异)。
用于控制手势识别器之间相互作用的行为。它允许你定义一个手势识别器只有在另一个手势识别器未能识别到手势时才能开始尝试识别。这在解决手势冲突和定义交互优先级时非常有用。
以下是使用 shouldRequireFailureOfGestureRecognizer 方法的一个基本示例场景和代码示例。假设你有一个滑动手势UISwipeGestureRecognizer和一个捏合缩放手势UIPinchGestureRecognizer,你想要确保当用户尝试捏合缩放时,滑动手势不会干扰:
首先,你需要设置你的视图控制器或其他合适的对象作为这两个手势识别器的代理,并且确保遵循 UIGestureRecognizerDelegate 协议:
class YourViewController: UIViewController, UIGestureRecognizerDelegate {
}
接着,初始化你的手势识别器,并设置代理:
let swipeGesture = UISwipeGestureRecognizer(target: self, action: #selector(handleSwipe))
swipeGesture.delegate = self
view.addGestureRecognizer(swipeGesture)
let pinchGesture = UIPinchGestureRecognizer(target: self, action: #selector(handlePinch))
pinchGesture.delegate = self
view.addGestureRecognizer(pinchGesture)
然后,实现 shouldRequireFailureOfGestureRecognizer 方法以定义手势的依赖关系。在这个例子中,我们让滑动手势swipeGesture只有在捏合手势pinchGesture失败时才尝试识别:
func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRequireFailureOf otherGestureRecognizer: UIGestureRecognizer) -> Bool {
if gestureRecognizer === swipeGesture && otherGestureRecognizer === pinchGesture {
return true
}
return false
}
在这个方法中,我们检查传入的手势识别器是否是我们希望其依赖于另一个手势失败的手势,如果是,则返回 true,表明这个手势识别器应该等待另一个手势失败后再尝试识别。
总结来说,shouldBeRequiredToFailByGestureRecognizer 是一个代理回调,动态地决定手势识别器间的优先级,而 shouldRequireFailureOfGestureRecognizer 是一种配置方式,静态地设定一个手势识别器需要在其指定的手势识别器失败后才能开始尝试识别。两者都是为了管理复杂触摸交互中手势识别的顺序和优先级,但应用场合和使用方式有所不同。