A set of methods implemented by the delegate of a gesture recognizer to fine-tune an app’s gesture-recognition behavior.


@protocol UIGestureRecognizerDelegate


The delegates receive messages from a gesture recognizer, and their responses to these messages enable them to affect the operation of the gesture recognizer or to specify a relationship between it and another gesture recognizer, such as allowing simultaneous recognition or setting up a dynamic failure requirement.

An example of a situation where dynamic failure requirements are useful is in an app that attaches a screen-edge pan gesture recognizer to a view. In this case, you might want all other relevant gesture recognizers associated with that view's subtree to require the screen-edge gesture recognizer to fail so you can prevent any graphical glitches that might occur when the other recognizers get canceled after starting the recognition process. To do this, you could use code similar to the following:

UIScreenEdgePanGestureRecognizer *myScreenEdgePanGestureRecognizer;
myScreenEdgePanGestureRecognizer = [[UIScreenEdgePanGestureRecognizer alloc] initWithTarget:self action:@selector(handleScreenEdgePan:)];
myScreenEdgePanGestureRecognizer.delegate = self;
// Configure the gesture recognizer and attach it to the view.
 - (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldBeRequiredToFailByGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer {
    BOOL result = NO;
    if ((gestureRecognizer == myScreenEdgePanGestureRecognizer) && [[otherGestureRecognizer view] isDescendantOfView:[gestureRecognizer view]]) {
        result = YES;
    return result;


Regulating Gesture Recognition

- gestureRecognizerShouldBegin:

Asks the delegate if a gesture recognizer should begin interpreting touches.

- gestureRecognizer:shouldReceiveTouch:

Ask the delegate if a gesture recognizer should receive an object representing a touch.

- gestureRecognizer:shouldReceivePress:

Ask the delegate if a gesture recognizer should receive an object representing a press.

Controlling Simultaneous Gesture Recognition

- gestureRecognizer:shouldRecognizeSimultaneouslyWithGestureRecognizer:

Asks the delegate if two gesture recognizers should be allowed to recognize gestures simultaneously.

Setting Up Failure Requirements

- gestureRecognizer:shouldRequireFailureOfGestureRecognizer:

Asks the delegate if a gesture recognizer should require another gesture recognizer to fail.

- gestureRecognizer:shouldBeRequiredToFailByGestureRecognizer:

Asks the delegate if a gesture recognizer should be required to fail by another gesture recognizer.


Inherits From

Conforming Types

See Also

Custom Gestures

Implementing a Custom Gesture Recognizer

Discover when and how to build your own gesture recognizers


The base class for concrete gesture recognizers.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software