# trackSwipeEvent(options:dampenAmountThresholdMin:max:usingHandler:) Allows tracking and user interface feedback of scroll wheel events. ``` func trackSwipeEvent(options: NSEvent.SwipeTrackingOptions = [], dampenAmountThresholdMin minDampenThreshold: CGFloat, max maxDampenThreshold: CGFloat, usingHandler trackingHandler: @escaping (CGFloat, NSEvent.Phase, Bool, UnsafeMutablePointer) -> Void) ``` ## Parameters `options` The swipe tracking events. See [`NSEvent.SwipeTrackingOptions`](/documentation/AppKit/NSEvent/SwipeTrackingOptions) for possible values. `minDampenThreshold` The minimum dampen threshold. This value is considered to encompass the “current view content area” and is referred to as a page. This is the number of pages with a negative position relative to the current page. The value must be less than or equal to zero. `maxDampenThreshold` The maximum dampen threshold. This value is considered to encompass the “current view content area” and is referred to as a page. This is the number of pages with a positive position relative to the current page. The value must be greater than or equal to zero. `trackingHandler` The Block used as the tracking handler. The Block takes four arguments: - gestureAmount: The amount of gesture that you should display in the user interface. This may be a fractional amount. The direction of the gestureAmount matches the user’s “scroll content” preference setting as set in [`isDirectionInvertedFromDevice`](/documentation/AppKit/NSEvent/isDirectionInvertedFromDevice) , which is based on a user preference. Upon completion, the gesture amount will animate to one of the following values: -1, 0, 1. - phase: The phase of the physical gesture as performed by the user. See [`NSEvent.Phase`](/documentation/AppKit/NSEvent/Phase-swift.struct) for possible values. When the phase is either [`ended`](/documentation/AppKit/NSEvent/Phase-swift.struct/ended), or [`mayBegin`](/documentation/AppKit/NSEvent/Phase-swift.struct/mayBegin), the user has physically ended the gesture successfully or un-successfully, respectively. Your handler will continue to be called with updated progress values to complete the fluid swipe animation with a phase of [`NSEventPhaseNone`](/documentation/AppKit/NSEventPhase/NSEventPhaseNone) . - isComplete: Signifies the swipe and animation are complete and you should release any temporary animation objects. The `trackingHandler` is released and will not be called further. - stop: A reference to a Boolean value. The Block can set the value to to stop further processing of the array. The `stop` argument is an out-only argument. You should only ever set this Boolean to within the Block ## Discussion Scroll wheel swipes are tracked not only to the end of the physical gesture phase by the user, but also to the completion of any user interface animation that should be performed. Using this method allows your implementation to maintain a consistent fluid feel with other applications. Any gesture amount outside of the supplied minimum and maximum dampen amount is pre-dampened for you to provide an elastic feel. The swipe `gestureAmount` that would fall outside of the range specified by the `minDampenThreshold` and `maxDampenThreshold` are automatically dampened. For example, the user’s physical swipe action results in a value of .50, however, there is no page in that direction to swipe to. The `gestureAmount` reported is adjusted by a damping factor resulting in something like .125. As a developer, you simply treat the `gestureAmount` like you normally do, and the result is an elastic feedback effect to let the user know that there is nothing to swipe to in that direction. > Note: > This method returns immediately and tracking is performed asynchronously. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)