Skip to content

Most visited

Recently visited

navigation

InputDeviceCompat

public final class InputDeviceCompat
extends Object

java.lang.Object
   ↳ android.support.v4.view.InputDeviceCompat


Helper class for accessing values in InputDevice.

Summary

Constants

int SOURCE_ANY

A special input source constant that is used when filtering input devices to match devices that provide any type of input source.

int SOURCE_CLASS_BUTTON

The input source has buttons or keys.

int SOURCE_CLASS_JOYSTICK

The input source is a joystick.

int SOURCE_CLASS_MASK

A mask for input source classes.

int SOURCE_CLASS_NONE

The input source has no class.

int SOURCE_CLASS_POINTER

The input source is a pointing device associated with a display.

int SOURCE_CLASS_POSITION

The input source is an absolute positioning device not associated with a display (unlike SOURCE_CLASS_POINTER).

int SOURCE_CLASS_TRACKBALL

The input source is a trackball navigation device.

int SOURCE_DPAD

The input source is a DPad.

int SOURCE_GAMEPAD

The input source is a game pad.

int SOURCE_HDMI

The input source is a device connected through HDMI-based bus.

int SOURCE_JOYSTICK

The input source is a joystick.

int SOURCE_KEYBOARD

The input source is a keyboard.

int SOURCE_MOUSE

The input source is a mouse pointing device.

int SOURCE_ROTARY_ENCODER

The input source is a rotating encoder device whose motions should be interpreted as akin to those of a scroll wheel.

int SOURCE_STYLUS

The input source is a stylus pointing device.

int SOURCE_TOUCHPAD

The input source is a touch pad or digitizer tablet that is not associated with a display (unlike SOURCE_TOUCHSCREEN).

int SOURCE_TOUCHSCREEN

The input source is a touch screen pointing device.

int SOURCE_TOUCH_NAVIGATION

The input source is a touch device whose motions should be interpreted as navigation events.

int SOURCE_TRACKBALL

The input source is a trackball.

int SOURCE_UNKNOWN

The input source is unknown.

Inherited methods

From class java.lang.Object

Constants

SOURCE_ANY

added in version 22.1.0
int SOURCE_ANY

A special input source constant that is used when filtering input devices to match devices that provide any type of input source.

Constant Value: -256 (0xffffff00)

SOURCE_CLASS_BUTTON

added in version 22.1.0
int SOURCE_CLASS_BUTTON

The input source has buttons or keys. Examples: SOURCE_KEYBOARD, SOURCE_DPAD. A KeyEvent should be interpreted as a button or key press.

Constant Value: 1 (0x00000001)

SOURCE_CLASS_JOYSTICK

added in version 22.1.0
int SOURCE_CLASS_JOYSTICK

The input source is a joystick. A MotionEvent should be interpreted as absolute joystick movements. Use getMotionRange(int) to query the range of positions.

Constant Value: 16 (0x00000010)

SOURCE_CLASS_MASK

added in version 22.1.0
int SOURCE_CLASS_MASK

A mask for input source classes. Each distinct input source constant has one or more input source class bits set to specify the desired interpretation for its input events.

Constant Value: 255 (0x000000ff)

SOURCE_CLASS_NONE

added in version 22.1.0
int SOURCE_CLASS_NONE

The input source has no class. It is up to the application to determine how to handle the device based on the device type.

Constant Value: 0 (0x00000000)

SOURCE_CLASS_POINTER

added in version 22.1.0
int SOURCE_CLASS_POINTER

The input source is a pointing device associated with a display. Examples: SOURCE_TOUCHSCREEN, SOURCE_MOUSE. A MotionEvent should be interpreted as absolute coordinates in display units according to the View hierarchy. Pointer down/up indicated when the finger touches the display or when the selection button is pressed/released. Use getMotionRange(int) to query the range of the pointing device. Some devices permit touches outside the display area so the effective range may be somewhat smaller or larger than the actual display size.

Constant Value: 2 (0x00000002)

SOURCE_CLASS_POSITION

added in version 22.1.0
int SOURCE_CLASS_POSITION

The input source is an absolute positioning device not associated with a display (unlike SOURCE_CLASS_POINTER). A MotionEvent should be interpreted as absolute coordinates in device-specific surface units. Use getMotionRange(int) to query the range of positions.

Constant Value: 8 (0x00000008)

SOURCE_CLASS_TRACKBALL

added in version 22.1.0
int SOURCE_CLASS_TRACKBALL

The input source is a trackball navigation device. Examples: SOURCE_TRACKBALL. A MotionEvent should be interpreted as relative movements in device-specific units used for navigation purposes. Pointer down/up indicates when the selection button is pressed/released. Use getMotionRange(int) to query the range of motion.

Constant Value: 4 (0x00000004)

SOURCE_DPAD

added in version 22.1.0
int SOURCE_DPAD

The input source is a DPad.

See also:

Constant Value: 513 (0x00000201)

SOURCE_GAMEPAD

added in version 22.1.0
int SOURCE_GAMEPAD

The input source is a game pad. (It may also be a SOURCE_JOYSTICK).

See also:

Constant Value: 1025 (0x00000401)

SOURCE_HDMI

added in version 22.1.0
int SOURCE_HDMI

The input source is a device connected through HDMI-based bus. The key comes in through HDMI-CEC or MHL signal line, and is treated as if it were generated by a locally connected DPAD or keyboard.

Constant Value: 33554433 (0x02000001)

SOURCE_JOYSTICK

added in version 22.1.0
int SOURCE_JOYSTICK

The input source is a joystick. (It may also be a SOURCE_GAMEPAD).

See also:

Constant Value: 16777232 (0x01000010)

SOURCE_KEYBOARD

added in version 22.1.0
int SOURCE_KEYBOARD

The input source is a keyboard. This source indicates pretty much anything that has buttons. Use getKeyboardType() to determine whether the keyboard has alphabetic keys and can be used to enter text.

See also:

Constant Value: 257 (0x00000101)

SOURCE_MOUSE

added in version 22.1.0
int SOURCE_MOUSE

The input source is a mouse pointing device. This code is also used for other mouse-like pointing devices such as trackpads and trackpoints.

See also:

Constant Value: 8194 (0x00002002)

SOURCE_ROTARY_ENCODER

added in version 26.0.0
int SOURCE_ROTARY_ENCODER

The input source is a rotating encoder device whose motions should be interpreted as akin to those of a scroll wheel.

See also:

Constant Value: 4194304 (0x00400000)

SOURCE_STYLUS

added in version 22.1.0
int SOURCE_STYLUS

The input source is a stylus pointing device.

Note that this bit merely indicates that an input device is capable of obtaining input from a stylus. To determine whether a given touch event was produced by a stylus, examine the tool type returned by getToolType(int) for each individual pointer.

A single touch event may multiple pointers with different tool types, such as an event that has one pointer with tool type TOOL_TYPE_FINGER and another pointer with tool type TOOL_TYPE_STYLUS. So it is important to examine the tool type of each pointer, regardless of the source reported by getSource().

See also:

Constant Value: 16386 (0x00004002)

SOURCE_TOUCHPAD

added in version 22.1.0
int SOURCE_TOUCHPAD

The input source is a touch pad or digitizer tablet that is not associated with a display (unlike SOURCE_TOUCHSCREEN).

See also:

Constant Value: 1048584 (0x00100008)

SOURCE_TOUCHSCREEN

added in version 22.1.0
int SOURCE_TOUCHSCREEN

The input source is a touch screen pointing device.

See also:

Constant Value: 4098 (0x00001002)

SOURCE_TOUCH_NAVIGATION

added in version 22.1.0
int SOURCE_TOUCH_NAVIGATION

The input source is a touch device whose motions should be interpreted as navigation events. For example, an upward swipe should be as an upward focus traversal in the same manner as pressing up on a D-Pad would be. Swipes to the left, right and down should be treated in a similar manner.

See also:

Constant Value: 2097152 (0x00200000)

SOURCE_TRACKBALL

added in version 22.1.0
int SOURCE_TRACKBALL

The input source is a trackball.

See also:

Constant Value: 65540 (0x00010004)

SOURCE_UNKNOWN

added in version 22.1.0
int SOURCE_UNKNOWN

The input source is unknown.

Constant Value: 0 (0x00000000)

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.