A gesture recognizer that looks for a touch event that moves around the screen.
SDK
- watchOS 3.0+
Framework
- Watch
Kit
Declaration
class WKPanGestureRecognizer : WKGesture Recognizer
Overview
In watchOS, a pan gesture must track exactly one touch event, but that touch event may move freely. Pan gestures are often used to drag content around a given area.
You do not create instances of this class programmatically. Instead, add a pan gesture recognizer to your Watch app’s storyboard file, dropping it onto a specific interface object. Touches occurring within the bounds of that interface object are tracked by the gesture recognizer and reported to an action method you define on the parent interface controller. For information on defining your action method and connecting it to your gesture recognizer, see WKGesture
.
State Changes for a Pan Gesture

A pan gesture recognizer tracks touch events continuously, and therefore has many potential state changes. A pan gesture does not transition to the Began state until after the touch event starts moving. After that, it may transition to the Changed state, to the Ended, state, to the Failed state, or to the Cancelled state. The two most common state transition sequences are as follows:
Possible —> Began —> [Changed…] —> Ended
Possible —> Began —> [Changed…] —> Failed
The Changed state is optional and may occur multiple times before the Ended, Failed, or Cancelled state is reached. The gesture recognizer calls its action method at each state transition. For more information on implementing continuous gesture recognizers, see WKGesture
.
Interface Builder Attributes
Xcode lets you configure information about your gesture recognizer in your storyboard file. A pan gesture recognizer defines no attributes of its own, but you can configure attributes of the WKGesture
parent class. For information about those attributes, see WKGesture
.