to top
Android APIs
public class

TouchDelegate

extends Object
java.lang.Object
   ↳ android.view.TouchDelegate

Class Overview

Helper class to handle situations where you want a view to have a larger touch area than its actual view bounds. The view whose touch area is changed is called the delegate view. This class should be used by an ancestor of the delegate. To use a TouchDelegate, first create an instance that specifies the bounds that should be mapped to the delegate and the delegate view itself.

The ancestor should then forward all of its touch events received in its onTouchEvent(MotionEvent) to onTouchEvent(MotionEvent).

Summary

Constants
int ABOVE The touchable region of the View extends above its actual extent.
int BELOW The touchable region of the View extends below its actual extent.
int TO_LEFT The touchable region of the View extends to the left of its actual extent.
int TO_RIGHT The touchable region of the View extends to the right of its actual extent.
Public Constructors
TouchDelegate(Rect bounds, View delegateView)
Constructor
Public Methods
boolean onTouchEvent(MotionEvent event)
Will forward touch events to the delegate view if the event is within the bounds specified in the constructor.
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final int ABOVE

Added in API level 1

The touchable region of the View extends above its actual extent.

Constant Value: 1 (0x00000001)

public static final int BELOW

Added in API level 1

The touchable region of the View extends below its actual extent.

Constant Value: 2 (0x00000002)

public static final int TO_LEFT

Added in API level 1

The touchable region of the View extends to the left of its actual extent.

Constant Value: 4 (0x00000004)

public static final int TO_RIGHT

Added in API level 1

The touchable region of the View extends to the right of its actual extent.

Constant Value: 8 (0x00000008)

Public Constructors

public TouchDelegate (Rect bounds, View delegateView)

Added in API level 1

Constructor

Parameters
bounds Bounds in local coordinates of the containing view that should be mapped to the delegate view
delegateView The view that should receive motion events

Public Methods

public boolean onTouchEvent (MotionEvent event)

Added in API level 1

Will forward touch events to the delegate view if the event is within the bounds specified in the constructor.

Parameters
event The touch event to forward
Returns
  • True if the event was forwarded to the delegate, false otherwise.