ViewConfiguration

ViewConfiguration

public ViewConfiguration ()

This constructor is deprecated.
Use get(android.content.Context) instead.

get

public static ViewConfiguration get (Context context)

Returns a configuration for the specified visual Context. The configuration depends on various parameters of the Context, like the dimension of the display or the density of the display.

getAmbiguousGestureMultiplier

public static float getAmbiguousGestureMultiplier ()

This method was deprecated in API level 30.
Use getScaledAmbiguousGestureMultiplier().

The multiplication factor for inhibiting default gestures. If a MotionEvent has MotionEvent.CLASSIFICATION_AMBIGUOUS_GESTURE set, then certain actions, such as scrolling, will be inhibited. However, to account for the possibility of an incorrect classification, existing gesture thresholds (e.g. scrolling touch slop and the long-press timeout) should be scaled by this factor and remain in effect.

getDefaultActionModeHideDuration

public static long getDefaultActionModeHideDuration ()

getDoubleTapTimeout

public static int getDoubleTapTimeout ()

getEdgeSlop

public static int getEdgeSlop ()

This method was deprecated in API level 15.
Use getScaledEdgeSlop() instead.

getFadingEdgeLength

public static int getFadingEdgeLength ()

This method was deprecated in API level 15.
Use getScaledFadingEdgeLength() instead.

getGlobalActionKeyTimeout

public static long getGlobalActionKeyTimeout ()

This method was deprecated in API level 20.
This timeout should not be used by applications

The amount of time a user needs to press the relevant key to bring up the global actions dialog.

getJumpTapTimeout

public static int getJumpTapTimeout ()

getKeyRepeatDelay

public static int getKeyRepeatDelay ()

getKeyRepeatTimeout

public static int getKeyRepeatTimeout ()

getLongPressTimeout

public static int getLongPressTimeout ()

Used for both key and motion events.

getMaximumDrawingCacheSize

public static int getMaximumDrawingCacheSize ()

This method was deprecated in API level 15.
Use getScaledMaximumDrawingCacheSize() instead.

The maximum drawing cache size expressed in bytes.

getMaximumFlingVelocity

public static int getMaximumFlingVelocity ()

This method was deprecated in API level 15.
Use getScaledMaximumFlingVelocity() instead.

getMinimumFlingVelocity

public static int getMinimumFlingVelocity ()

This method was deprecated in API level 15.
Use getScaledMinimumFlingVelocity() instead.

getMultiPressTimeout

public static int getMultiPressTimeout ()

getPressedStateDuration

public static int getPressedStateDuration ()

getScaledAmbiguousGestureMultiplier

public float getScaledAmbiguousGestureMultiplier ()

The multiplication factor for inhibiting default gestures. If a MotionEvent has MotionEvent.CLASSIFICATION_AMBIGUOUS_GESTURE set, then certain actions, such as scrolling, will be inhibited. However, to account for the possibility of an incorrect classification, existing gesture thresholds (e.g. scrolling touch slop and the long-press timeout) should be scaled by this factor and remain in effect.

getScaledDoubleTapSlop

public int getScaledDoubleTapSlop ()

getScaledEdgeSlop

public int getScaledEdgeSlop ()

getScaledFadingEdgeLength

public int getScaledFadingEdgeLength ()

getScaledHandwritingGestureLineMargin

public int getScaledHandwritingGestureLineMargin ()

getScaledHandwritingSlop

public int getScaledHandwritingSlop ()

getScaledHorizontalScrollFactor

public float getScaledHorizontalScrollFactor ()

getScaledHoverSlop

public int getScaledHoverSlop ()

getScaledMaximumDrawingCacheSize

public int getScaledMaximumDrawingCacheSize ()

The maximum drawing cache size expressed in bytes.

getScaledMaximumFlingVelocity

public int getScaledMaximumFlingVelocity (int inputDeviceId, 
                int axis, 
                int source)

Maximum absolute value of velocity to initiate a fling for a motion generated by an InputDevice with an id of inputDeviceId, from an input source and on a given motion event axis.

Similar to getScaledMinimumFlingVelocity(int, int, int), but for maximum fling velocity, instead of minimum. Also, unlike that method which returns Integer.MAX_VALUE for bad input device ID, source and/or motion event axis inputs, this method returns Integer.MIN_VALUE for such bad inputs.

getScaledMaximumFlingVelocity

public int getScaledMaximumFlingVelocity ()

getScaledMinimumFlingVelocity

public int getScaledMinimumFlingVelocity (int inputDeviceId, 
                int axis, 
                int source)

Minimum absolute value of velocity to initiate a fling for a motion generated by an InputDevice with an id of inputDeviceId, from an input source and on a given motion event axis.

Before utilizing this method to get a minimum fling velocity for a motion generated by the input device, scale the velocity of the motion events generated by the input device to pixels per second.

For instance, if you tracked MotionEvent#AXIS_SCROLL vertical velocities generated from a InputDevice#SOURCE_ROTARY_ENCODER, the velocity returned from VelocityTracker will be in the units with which the axis values were reported in the motion event. Before comparing that velocity against the minimum fling velocity specified here, make sure that the MotionEvent#AXIS_SCROLL velocity from the tracker is calculated in "units per second" (see VelocityTracker#computeCurrentVelocity(int), VelocityTracker#computeCurrentVelocity(int, float) to adjust your velocity computations to "per second"), and use getScaledVerticalScrollFactor() to change this velocity value to "pixels/second".

If the provided inputDeviceId is not valid, or if the input device whose ID is provided does not support the given motion event source and/or axis, this method will return Integer.MAX_VALUE.

Obtaining the correct arguments for this method call

inputDeviceId: if calling this method in response to a MotionEvent, use the device ID that is reported by the event, which can be obtained using MotionEvent#getDeviceId(). Otherwise, use a valid ID that is obtained from InputDevice#getId(), or from an InputManager instance (InputManager#getInputDeviceIds() gives all the valid input device IDs).

axis: a MotionEvent may report data for multiple axes, and each axis may have multiple data points for different pointers. Use the axis for which you obtained the velocity for (VelocityTracker lets you calculate velocities for a specific axis. Use the axis for which you calculated velocity). You can use InputDevice#getMotionRanges() to get all the InputDevice.MotionRanges for the InputDevice, from which you can derive all the valid axes for the device.

source: use MotionEvent#getSource() if calling this method in response to a MotionEvent. Otherwise, use a valid source for the InputDevice. You can use InputDevice#getMotionRanges() to get all the InputDevice.MotionRanges for the InputDevice, from which you can derive all the valid sources for the device.

This method optimizes calls over multiple input device IDs, so caching the return value of the method is not necessary if you are handling multiple input devices.

getScaledMinimumFlingVelocity

public int getScaledMinimumFlingVelocity ()

getScaledMinimumScalingSpan

public int getScaledMinimumScalingSpan ()

Retrieves the distance in pixels between touches that must be reached for a gesture to be interpreted as scaling. In general, scaling shouldn't start until this distance has been met or surpassed, and scaling should end when the distance in pixels between touches drops below this distance.

getScaledOverflingDistance

public int getScaledOverflingDistance ()

getScaledOverscrollDistance

public int getScaledOverscrollDistance ()

getScaledPagingTouchSlop

public int getScaledPagingTouchSlop ()

getScaledScrollBarSize

public int getScaledScrollBarSize ()

getScaledTouchSlop

public int getScaledTouchSlop ()

getScaledVerticalScrollFactor

public float getScaledVerticalScrollFactor ()

getScaledWindowTouchSlop

public int getScaledWindowTouchSlop ()

getScrollBarFadeDuration

public static int getScrollBarFadeDuration ()

getScrollBarSize

public static int getScrollBarSize ()

This method was deprecated in API level 15.
Use getScaledScrollBarSize() instead.

getScrollDefaultDelay

public static int getScrollDefaultDelay ()

getScrollFriction

public static float getScrollFriction ()

The amount of friction applied to scrolls and flings.

getTapTimeout

public static int getTapTimeout ()

getTouchSlop

public static int getTouchSlop ()

This method was deprecated in API level 15.
Use getScaledTouchSlop() instead.

getWindowTouchSlop

public static int getWindowTouchSlop ()

This method was deprecated in API level 15.
Use getScaledWindowTouchSlop() instead.

getZoomControlsTimeout

public static long getZoomControlsTimeout ()

The amount of time that the zoom controls should be displayed on the screen expressed in milliseconds.

hasPermanentMenuKey

public boolean hasPermanentMenuKey ()

Report if the device has a permanent menu key available to the user.

As of Android 3.0, devices may not have a permanent menu key available. Apps should use the action bar to present menu options to users. However, there are some apps where the action bar is inappropriate or undesirable. This method may be used to detect if a menu key is present. If not, applications should provide another on-screen affordance to access functionality.

shouldShowMenuShortcutsWhenKeyboardPresent

public boolean shouldShowMenuShortcutsWhenKeyboardPresent ()

Check if shortcuts should be displayed in menus.