HapticFeedbackConstants
public
class
HapticFeedbackConstants
extends Object
java.lang.Object | |
↳ | android.view.HapticFeedbackConstants |
Constants to be used to perform haptic feedback effects via
View#performHapticFeedback(int)
Summary
Constants | |
---|---|
int |
CLOCK_TICK
The user has pressed either an hour or minute tick of a Clock. |
int |
CONFIRM
A haptic effect to signal the confirmation or successful completion of a user interaction. |
int |
CONTEXT_CLICK
The user has performed a context click on an object. |
int |
DRAG_START
The user has started a drag-and-drop gesture. |
int |
FLAG_IGNORE_GLOBAL_SETTING
This constant was deprecated
in API level 33.
Starting from |
int |
FLAG_IGNORE_VIEW_SETTING
Flag for |
int |
GESTURE_END
The user has finished a gesture (e.g. on the soft keyboard). |
int |
GESTURE_START
The user has started a gesture (e.g. on the soft keyboard). |
int |
GESTURE_THRESHOLD_ACTIVATE
The user is executing a swipe/drag-style gesture, such as pull-to-refresh, where the gesture action is \u201celigible\u201d at a certain threshold of movement, and can be cancelled by moving back past the threshold. |
int |
GESTURE_THRESHOLD_DEACTIVATE
The user is executing a swipe/drag-style gesture, such as pull-to-refresh, where the gesture action is \u201celigible\u201d at a certain threshold of movement, and can be cancelled by moving back past the threshold. |
int |
KEYBOARD_PRESS
The user has pressed a virtual or software keyboard key. |
int |
KEYBOARD_RELEASE
The user has released a virtual keyboard key. |
int |
KEYBOARD_TAP
The user has pressed a soft keyboard key. |
int |
LONG_PRESS
The user has performed a long press on an object that is resulting in an action being performed. |
int |
NO_HAPTICS
No haptic feedback should be performed. |
int |
REJECT
A haptic effect to signal the rejection or failure of a user interaction. |
int |
SEGMENT_FREQUENT_TICK
The user is switching between a series of many potential choices, for example minutes on a clock face, or individual percentages. |
int |
SEGMENT_TICK
The user is switching between a series of potential choices, for example items in a list or discrete points on a slider. |
int |
TEXT_HANDLE_MOVE
The user has performed a selection/insertion handle move on text field. |
int |
TOGGLE_OFF
The user has toggled a switch or button into the off position. |
int |
TOGGLE_ON
The user has toggled a switch or button into the on position. |
int |
VIRTUAL_KEY
The user has pressed on a virtual on-screen key. |
int |
VIRTUAL_KEY_RELEASE
The user has released a virtual key. |
Inherited methods | |
---|---|
Constants
CLOCK_TICK
public static final int CLOCK_TICK
The user has pressed either an hour or minute tick of a Clock.
Constant Value: 4 (0x00000004)
CONFIRM
public static final int CONFIRM
A haptic effect to signal the confirmation or successful completion of a user interaction.
Constant Value: 16 (0x00000010)
CONTEXT_CLICK
public static final int CONTEXT_CLICK
The user has performed a context click on an object.
Constant Value: 6 (0x00000006)
DRAG_START
public static final int DRAG_START
The user has started a drag-and-drop gesture. The drag target has just been "picked up".
Constant Value: 25 (0x00000019)
FLAG_IGNORE_GLOBAL_SETTING
public static final int FLAG_IGNORE_GLOBAL_SETTING
This constant was deprecated
in API level 33.
Starting from Build.VERSION_CODES.TIRAMISU
only privileged
apps can ignore user settings for touch feedback.
Flag for View.performHapticFeedback(int, int)
: Ignore the global setting
for whether to perform haptic feedback, do it always.
Constant Value: 2 (0x00000002)
FLAG_IGNORE_VIEW_SETTING
public static final int FLAG_IGNORE_VIEW_SETTING
Flag for View.performHapticFeedback(int, int)
: Ignore the setting in the
view for whether to perform haptic feedback, do it always.
Constant Value: 1 (0x00000001)
GESTURE_END
public static final int GESTURE_END
The user has finished a gesture (e.g. on the soft keyboard).
Constant Value: 13 (0x0000000d)
GESTURE_START
public static final int GESTURE_START
The user has started a gesture (e.g. on the soft keyboard).
Constant Value: 12 (0x0000000c)
GESTURE_THRESHOLD_ACTIVATE
public static final int GESTURE_THRESHOLD_ACTIVATE
The user is executing a swipe/drag-style gesture, such as pull-to-refresh, where the gesture action is \u201celigible\u201d at a certain threshold of movement, and can be cancelled by moving back past the threshold. This constant indicates that the user's motion has just passed the threshold for the action to be activated on release.
See also:
Constant Value: 23 (0x00000017)
GESTURE_THRESHOLD_DEACTIVATE
public static final int GESTURE_THRESHOLD_DEACTIVATE
The user is executing a swipe/drag-style gesture, such as pull-to-refresh, where the gesture action is \u201celigible\u201d at a certain threshold of movement, and can be cancelled by moving back past the threshold. This constant indicates that the user's motion has just re-crossed back "under" the threshold for the action to be activated, meaning the gesture is currently in a cancelled state.
See also:
Constant Value: 24 (0x00000018)
KEYBOARD_PRESS
public static final int KEYBOARD_PRESS
The user has pressed a virtual or software keyboard key.
Constant Value: 3 (0x00000003)
KEYBOARD_RELEASE
public static final int KEYBOARD_RELEASE
The user has released a virtual keyboard key.
Constant Value: 7 (0x00000007)
KEYBOARD_TAP
public static final int KEYBOARD_TAP
The user has pressed a soft keyboard key.
Constant Value: 3 (0x00000003)
LONG_PRESS
public static final int LONG_PRESS
The user has performed a long press on an object that is resulting in an action being performed.
Constant Value: 0 (0x00000000)
NO_HAPTICS
public static final int NO_HAPTICS
No haptic feedback should be performed. Applications may use this value to indicate skipping
a call to View#performHapticFeedback
entirely, or else rely that it will immediately
return false
.
Constant Value: -1 (0xffffffff)
REJECT
public static final int REJECT
A haptic effect to signal the rejection or failure of a user interaction.
Constant Value: 17 (0x00000011)
SEGMENT_FREQUENT_TICK
public static final int SEGMENT_FREQUENT_TICK
The user is switching between a series of many potential choices, for example minutes on a clock face, or individual percentages. This constant is expected to be very soft, so as not to be uncomfortable when performed a lot in quick succession. If the device can\u2019t make a suitably soft vibration, then it may not make any vibration.
Some specializations of this constant exist for specific actions, notably
CLOCK_TICK
and TEXT_HANDLE_MOVE
.
See also SEGMENT_TICK
.
Constant Value: 27 (0x0000001b)
SEGMENT_TICK
public static final int SEGMENT_TICK
The user is switching between a series of potential choices, for example items in a list or discrete points on a slider.
See also SEGMENT_FREQUENT_TICK
for cases where density of choices is high, and
the haptics should be lighter or suppressed for a better user experience.
Constant Value: 26 (0x0000001a)
TEXT_HANDLE_MOVE
public static final int TEXT_HANDLE_MOVE
The user has performed a selection/insertion handle move on text field.
Constant Value: 9 (0x00000009)
TOGGLE_OFF
public static final int TOGGLE_OFF
The user has toggled a switch or button into the off position.
Constant Value: 22 (0x00000016)
TOGGLE_ON
public static final int TOGGLE_ON
The user has toggled a switch or button into the on position.
Constant Value: 21 (0x00000015)
VIRTUAL_KEY
public static final int VIRTUAL_KEY
The user has pressed on a virtual on-screen key.
Constant Value: 1 (0x00000001)
VIRTUAL_KEY_RELEASE
public static final int VIRTUAL_KEY_RELEASE
The user has released a virtual key.
Constant Value: 8 (0x00000008)