Class: UIPanGestureRecognizer

Inherits:
UIGestureRecognizer show all

Overview

UIPanGestureRecognizer is a concrete subclass of UIGestureRecognizer that looks for panning (dragging) gestures. The user must be pressing one or more fingers on a view while they pan it. Clients implementing the action method for this gesture recognizer can ask it for the current translation and velocity of the gesture.

Instance Attribute Summary (collapse)

Attributes inherited from UIGestureRecognizer

#cancelsTouchesInView, #delaysTouchesBegan, #delaysTouchesEnded, #delegate, #enabled, #state, #view

Instance Method Summary (collapse)

Methods inherited from UIGestureRecognizer

#addTarget:action:, #canBePreventedByGestureRecognizer:, #canPreventGestureRecognizer:, #ignoreTouch:forEvent:, #initWithTarget:action:, #locationInView:, #locationOfTouch:inView:, #numberOfTouches, #removeTarget:action:, #requireGestureRecognizerToFail:, #reset, #touchesBegan:withEvent:, #touchesCancelled:withEvent:, #touchesEnded:withEvent:, #touchesMoved:withEvent:

Methods inherited from NSObject

#!, #!=, #!~, #, #==, #===, #=~, #Rational, #__callee__, #__method__, #__send__, #__type__, `, alloc, allocWithZone:, #autoContentAccessingProxy, autoload, autoload?, autorelease_pool, #awakeAfterUsingCoder:, binding, block_given?, caller, cancelPreviousPerformRequestsWithTarget:, cancelPreviousPerformRequestsWithTarget:selector:object:, catch, class, classFallbacksForKeyedArchiver, #classForCoder, #classForKeyedArchiver, classForKeyedUnarchiver, #clone, conformsToProtocol:, #copy, copyWithZone:, #dealloc, #define_singleton_method, description, display, #doesNotRecognizeSelector:, #dup, #enum_for, #eql?, #equal?, #extend, fail, #finalize, format, #forwardInvocation:, #forwardingTargetForSelector:, framework, #freeze, #frozen?, getpass, gets, global_variables, #init, initialize, #initialize_clone, #initialize_copy, #initialize_dup, #inspect, instanceMethodForSelector:, instanceMethodSignatureForSelector:, #instance_eval, #instance_exec, #instance_of?, #instance_variable_defined?, #instance_variable_get, #instance_variable_set, #instance_variables, instancesRespondToSelector:, isSubclassOfClass:, #is_a?, iterator?, #kind_of?, lambda, load, load_bridge_support_file, load_plist, local_variables, loop, #method, #methodForSelector:, #methodSignatureForSelector:, #methods, #mutableCopy, mutableCopyWithZone:, new, #nil?, open, p, #performSelector:onThread:withObject:waitUntilDone:, #performSelector:onThread:withObject:waitUntilDone:modes:, #performSelector:withObject:afterDelay:, #performSelector:withObject:afterDelay:inModes:, #performSelectorInBackground:withObject:, #performSelectorOnMainThread:withObject:waitUntilDone:, #performSelectorOnMainThread:withObject:waitUntilDone:modes:, print, printf, #private_methods, proc, #protected_methods, #public_method, #public_methods, #public_send, putc, puts, raise, rand, readline, readlines, #replacementObjectForCoder:, #replacementObjectForKeyedArchiver:, require, resolveClassMethod:, resolveInstanceMethod:, #respond_to?, #respond_to_missing?, select, #send, setVersion:, #singleton_methods, sprintf, srand, superclass, #taint, #tainted?, #tap, test, throw, #to_plist, #to_s, trace_var, trap, #trust, #untaint, untrace_var, #untrust, #untrusted?, version

Constructor Details

This class inherits a constructor from NSObject

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class NSObject

Instance Attribute Details

- (Integer) maximumNumberOfTouches

The maximum number of fingers that can be touching the view for this gesture to be recognized. The default value is NSUIntegerMax.

Returns:

- (Integer) minimumNumberOfTouches

The minimum number of fingers that can be touching the view for this gesture to be recognized. The default value is 1.

Returns:

Instance Method Details

- (Object) setTranslation(translation, inView:view)

Sets the translation value in the coordinate system of the specified view. Changing the translation value resets the velocity of the pan.

Parameters:

  • translation (CGPoint)

    A point that identifies the new translation value.

  • view (UIView)

    A view in whose coordinate system the translation is to occur.

Returns:

- (CGPoint) translationInView(view)

The translation of the pan gesture in the coordinate system of the specified view. The x and y values report the total translation over time. They are not delta values from the last time that the translation was reported. Apply the translation value to the state of the view when the gesture is first recognized—do not concatenate the value each time the handler is called.

Parameters:

  • view (UIView)

    The view in whose coordinate system the translation of the pan gesture should be computed. If you want to adjust a view’s location to keep it under the user’s finger, request the translation in that view’s superview’s coordinate system.

Returns:

  • (CGPoint)

    A point identifying the new location of a view in the coordinate system of its designated superview.

- (CGPoint) velocityInView(view)

The velocity of the pan gesture in the coordinate system of the specified view.

Parameters:

  • view (UIView)

    The view in whose coordinate system the velocity of the pan gesture is computed.

Returns:

  • (CGPoint)

    The velocity of the pan gesture, which is expressed in points per second. The velocity is broken into horizontal and vertical components.