crossmobile.ios.uikit

Class UILongPressGestureRecognizer

java.lang.Object

crossmobile.ios.foundation.NSObject

crossmobile.ios.uikit.UIGestureRecognizer

crossmobile.ios.uikit.UILongPressGestureRecognizer

public class UILongPressGestureRecognizer
extends UIGestureRecognizer

UILongPressGestureRecognizer class extends UIGestureRecognizer and recognizes series of touches as long press gestures.This happens only after an extended touch of the screen with one or more fingers.

Constructor Summary

Constructors

Constructor and Description
UILongPressGestureRecognizer(NSSelector<UIGestureRecognizer> target) Constructs a new UILongPressGestureRecognizer object and attaches it to the specified UIGestureRecognizer.

Method Summary

Modifier and Type	Method and Description
double	allowableMovement() Returns the maximum distance(expressed in points) that the fingers can move, until the gesture is rejected and not recognized as a long-press one.
boolean	canBePreventedByGestureRecognizer(UIGestureRecognizer preventing) Override this method so that the specified UIGestureRecognizer prevents this UIGestureRecognizer from recognizing a gesture.
boolean	canPreventGestureRecognizer(UIGestureRecognizer preventing) Override this method so that this UIGestureRecognizer prevents the specified UIGestureRecognizer from recognizing a gesture.
double	minimumPressDuration() Returns the minimum touch time that is needed in order to recognize a gesture as a long-press one.
int	numberOfTapsRequired() Returns the number of taps that are needed for gesture to be recognized as long-press one.
int	numberOfTouchesRequired() Returns the number of fingers needed to touch the screen in order to recognize a gesture as a long-press one.
void	setAllowableMovement(double allowableMovement) Sets the maximum distance(expressed in points) that the fingers can move, until the gesture is rejected and not recognized as a long-press one.
void	setMinimumPressDuration(double minimumPressDuration) Sets the minimum touch time that is needed in order to recognize a gesture as a long-press one.
void	setNumberOfTapsRequired(int numberOfTapsRequired) Sets the number of taps that are needed for gesture to be recognized as long-press one.
void	setNumberOfTouchesRequired(int numberOfTouchesRequired) Sets the number of fingers needed to touch the screen in order to recognize a gesture as a long-press one.
void	touchesBegan(Set<UITouch> touches, UIEvent event) Informs this UIGestureRecognizer when one or more fingers touched down in the associated UIView.
void	touchesCancelled(Set<UITouch> touches, UIEvent event) Informs this UIGestureRecognizer that a touch event was canceled due to system event.
void	touchesEnded(Set<UITouch> touches, UIEvent event) Informs this UIGestureRecognizer when one or more fingers were lifted from the associated view.
void	touchesMoved(Set<UITouch> touches, UIEvent event) Informs this UIGestureRecognizer when one or more fingers were moved within the associated view.

Methods inherited from class crossmobile.ios.uikit.UIGestureRecognizer

addTarget, cancelsTouchesInView, delaysTouchesBegan, delaysTouchesEnded, delegate, isEnabled, locationInView, locationOfTouch, numberOfTouches, removeTarget, requireGestureRecognizerToFail, reset, setCancelsTouchesInView, setDelaysTouchesBegan, setDelaysTouchesEnded, setDelegate, setEnabled, state, toString, view

Methods inherited from class crossmobile.ios.foundation.NSObject

addObserver, observeValueForKeyPath, performSelector, performSelectorOnMainThread, release, removeObserver, removeObserver, retain, setValueForKey, setValueForUndefinedKey, valueForKey, valueForUndefinedKey

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

UILongPressGestureRecognizer

public UILongPressGestureRecognizer(NSSelector<UIGestureRecognizer> target)

Constructs a new UILongPressGestureRecognizer object and attaches it to the specified UIGestureRecognizer.

Parameters:

target - The UIGestureRecognizer to which the new object is attached to.

Method Detail

touchesBegan

public void touchesBegan(Set<UITouch> touches,
                         UIEvent event)

Description copied from class: UIGestureRecognizer

Informs this UIGestureRecognizer when one or more fingers touched down in the associated UIView.

Overrides:

touchesBegan in class UIGestureRecognizer

Parameters:

touches - The set of touches until the UITouchPhaseCancelled phase.

event - The event to which the touches belong.

touchesMoved

public void touchesMoved(Set<UITouch> touches,
                         UIEvent event)

Description copied from class: UIGestureRecognizer

Informs this UIGestureRecognizer when one or more fingers were moved within the associated view.

Overrides:

touchesMoved in class UIGestureRecognizer

Parameters:

touches - The set of touches until the UITouchPhaseCancelled phase.

event - The event to which the touches belong.

touchesEnded

public void touchesEnded(Set<UITouch> touches,
                         UIEvent event)

Description copied from class: UIGestureRecognizer

Informs this UIGestureRecognizer when one or more fingers were lifted from the associated view.

Overrides:

touchesEnded in class UIGestureRecognizer

Parameters:

touches - The set of touches until the UITouchPhaseCancelled phase.

event - The event to which the touches belong.

touchesCancelled

public void touchesCancelled(Set<UITouch> touches,
                             UIEvent event)

Description copied from class: UIGestureRecognizer

Informs this UIGestureRecognizer that a touch event was canceled due to system event.

Overrides:

touchesCancelled in class UIGestureRecognizer

Parameters:

touches - The set of touches until the UITouchPhaseCancelled phase.

event - The event to which the touches belong.

canBePreventedByGestureRecognizer

public boolean canBePreventedByGestureRecognizer(UIGestureRecognizer preventing)

Description copied from class: UIGestureRecognizer

Override this method so that the specified UIGestureRecognizer prevents this UIGestureRecognizer from recognizing a gesture.

Specified by:

canBePreventedByGestureRecognizer in class UIGestureRecognizer

Parameters:

preventing - The UIGestureRecognizer that prevents this gesture recognizer from recognizing a gesture.

Returns:

TRUE then the specified UIGestureRecognizer is able to prevent the recognition of a gesture.

canPreventGestureRecognizer

public boolean canPreventGestureRecognizer(UIGestureRecognizer preventing)

Description copied from class: UIGestureRecognizer

Override this method so that this UIGestureRecognizer prevents the specified UIGestureRecognizer from recognizing a gesture.

Specified by:

canPreventGestureRecognizer in class UIGestureRecognizer

Parameters:

preventing - The UIGestureRecognizer that is prevented from recognizing a gesture.

Returns:

TRUE then this UIGestureRecognizer is able to prevent the recognition of a gesture.

numberOfTapsRequired

public int numberOfTapsRequired()

Returns the number of taps that are needed for gesture to be recognized as long-press one.

Returns:

The number of taps that are needed for gesture to be recognized as long-press one.

setNumberOfTapsRequired

public void setNumberOfTapsRequired(int numberOfTapsRequired)

Sets the number of taps that are needed for gesture to be recognized as long-press one.

Parameters:

numberOfTapsRequired - The number of taps that are needed for gesture to be recognized as long-press one.

numberOfTouchesRequired

public int numberOfTouchesRequired()

Returns the number of fingers needed to touch the screen in order to recognize a gesture as a long-press one.

Returns:

The number of fingers needed to touch the screen in order to recognize a gesture as a long-press one.

setNumberOfTouchesRequired

public void setNumberOfTouchesRequired(int numberOfTouchesRequired)

Sets the number of fingers needed to touch the screen in order to recognize a gesture as a long-press one.

Parameters:

numberOfTouchesRequired - The number of fingers needed to touch the screen in order to recognize a gesture as a long-press one.

minimumPressDuration

public double minimumPressDuration()

Returns the minimum touch time that is needed in order to recognize a gesture as a long-press one.

Returns:

The time that is needed in order to recognize a gesture as a long-press one.(seconds)

setMinimumPressDuration

public void setMinimumPressDuration(double minimumPressDuration)

Sets the minimum touch time that is needed in order to recognize a gesture as a long-press one.

Parameters:

minimumPressDuration - The time that is needed in order to recognize a gesture as a long-press one.(seconds)

allowableMovement

public double allowableMovement()

Returns the maximum distance(expressed in points) that the fingers can move, until the gesture is rejected and not recognized as a long-press one.

Returns:

The maximum distance(expressed in points) that the fingers can move.

setAllowableMovement

public void setAllowableMovement(double allowableMovement)

Sets the maximum distance(expressed in points) that the fingers can move, until the gesture is rejected and not recognized as a long-press one.

Parameters:

allowableMovement - The maximum distance(expressed in points) that the fingers can move.