偶然翻阅到ViewConfiguration类,记录view常见的 timeouts, sizes, distances。
官方文档
ViewConfiguration
/**
* Contains methods to standard constants used in the UI for timeouts, sizes, and distances.
*/
public class ViewConfiguration {
/**
* 定义水平滚动条的宽度和竖直滚动条的高度,单位dip
*/
private static final int SCROLL_BAR_SIZE = 4;
/**
*滚动条淡出的持续时间(毫秒)
*/
private static final int SCROLL_BAR_FADE_DURATION = 250;
/**
* 滚动条淡出前的延迟时间(毫秒)
*/
private static final int SCROLL_BAR_DEFAULT_DELAY = 300;
/**
* 定义边框褪色边缘的长度(dip)
*/
private static final int FADING_EDGE_LENGTH = 12;
/**
* 定义子组件中按下状态的持续时间(毫秒)
*/
private static final int PRESSED_STATE_DURATION = 64;
/*
* 定义长安的最短时间(毫秒)
*/
private static final int DEFAULT_LONG_PRESS_TIMEOUT = 500;
/**
*定义双击的抬起与按下的间隔时间(毫秒)
* Defines the default duration in milliseconds between the first tap's up event and the second
* tap's down event for an interaction to be considered part of the same multi-press.
*/
private static final int DEFAULT_MULTI_PRESS_TIMEOUT = 300;
/**
*定义连续键重复之间的时间(毫秒
*/
private static final int KEY_REPEAT_DELAY = 50;
/**
*定义用户需要按住相应按钮以显示“全局操作”对话框的持续时间(毫秒)
*如:关机 、锁屏
* Defines the duration in milliseconds a user needs to hold down the
* appropriate button to bring up the global actions dialog (power off,
* lock screen, etc).
*/
private static final int GLOBAL_ACTIONS_KEY_TIMEOUT = 500;
/**
* 定义用户首次打开辅助功能快捷方式时需要按住相应按钮的持续时间(毫秒)
*/
private static final int A11Y_SHORTCUT_KEY_TIMEOUT = 3000;
/**
*定义在配置辅助功能快捷方式后,用户需要按住相应按钮以启用辅助功能快捷方式所需的持续时间(毫秒)
*/
private static final int A11Y_SHORTCUT_KEY_TIMEOUT_AFTER_CONFIRMATION = 1000;
/**
* Defines the duration in milliseconds we will wait to see if a touch event
* is a tap or a scroll. If the user does not move within this interval, it is
* considered to be a tap.
*判断touch事件是单击或滑动
*/
private static final int TAP_TIMEOUT = 100;
/**
* 定义跳转点击与点击事件的判断时间(毫秒),若在此时间内未完成,则是点击事件
*/
private static final int JUMP_TAP_TIMEOUT = 500;
/**
* Defines the duration in milliseconds between the first tap's up event and
* the second tap's down event for an interaction to be considered a
* double-tap.
* 双击事件与单击判断时间
*/
private static final int DOUBLE_TAP_TIMEOUT = 300;
/**
* Defines the minimum duration in milliseconds between the first tap's up event and
* the second tap's down event for an interaction to be considered a
* double-tap.
* 双击间隔最短时间
*/
private static final int DOUBLE_TAP_MIN_TIME = 40;
/**
* Defines the maximum duration in milliseconds between a touch pad
* touch and release for a given touch to be considered a tap (click) as
* opposed to a hover movement gesture.
* 定义触摸板触摸和释放之间的最长持续时间(毫秒),将给定触摸视为轻击(单击),而不是悬停移动手势
*/
private static final int HOVER_TAP_TIMEOUT = 150;
/**
* Defines the maximum distance in pixels that a touch pad touch can move
* before being released for it to be considered a tap (click) as opposed
* to a hover movement gesture.
* 定义触摸板触摸在释放前可以移动的最大距离(以像素为单位),以便将其视为轻击(单击),而不是悬停移动手势。
*/
private static final int HOVER_TAP_SLOP = 20;
/**
* Defines the duration in milliseconds we want to display zoom controls in response
* to a user panning within an application.
* 定义在应用程序中响应用户平移时显示缩放控件的持续时间(毫秒)。
*/
private static final int ZOOM_CONTROLS_TIMEOUT = 3000;
/**
* Inset in dips to look for touchable content when the user touches the edge of the screen
* 当用户touch在屏幕边缘时,插入一定像素值,以寻找出可触摸内容
*/
private static final int EDGE_SLOP = 12;
/**
* Distance a touch can wander before we think the user is scrolling in dips.
* Note that this value defined here is only used as a fallback by legacy/misbehaving
* applications that do not provide a Context for determining density/configuration-dependent
* values.
*
* To alter this value, see the configuration resource config_viewConfigurationTouchSlop
* in frameworks/base/core/res/res/values/config.xml or the appropriate device resource overlay.
* It may be appropriate to tweak this on a device-specific basis in an overlay based on
* the characteristics of the touch panel and firmware.
* 满足这个像素距离,可以认为用户在滚动中
*/
private static final int TOUCH_SLOP = 8;
/**
* Defines the minimum size of the touch target for a scrollbar in dips
* 滚动条最小值
*/
private static final int MIN_SCROLLBAR_TOUCH_TARGET = 48;
/**
* Distance the first touch can wander before we stop considering this event a double tap
* (in dips)
*在停止考虑此事件双击之前,第一次触摸可以徘徊的距离
*/
private static final int DOUBLE_TAP_TOUCH_SLOP = TOUCH_SLOP;
/**
* Distance a touch can wander before we think the user is attempting a paged scroll
* (in dips)
* 在认为用户试图滚动页面之前触摸您可以移动的距离
*
* Note that this value defined here is only used as a fallback by legacy/misbehaving
* applications that do not provide a Context for determining density/configuration-dependent
* values.
*
* See the note above on {@link #TOUCH_SLOP} regarding the dimen resource
* config_viewConfigurationTouchSlop. ViewConfiguration will report a paging touch slop of
* config_viewConfigurationTouchSlop * 2 when provided with a Context.
*/
private static final int PAGING_TOUCH_SLOP = TOUCH_SLOP * 2;
/**
* Distance in dips between the first touch and second touch to still be considered a double tap
* 双击间隔内可滑动的距离
*/
private static final int DOUBLE_TAP_SLOP = 100;
/**
* Distance in dips a touch needs to be outside of a window's bounds for it to
* count as outside for purposes of dismissing the window.
*/
private static final int WINDOW_TOUCH_SLOP = 16;
/**
* Minimum velocity to initiate a fling, as measured in dips per second
* fling的最小速度
*/
private static final int MINIMUM_FLING_VELOCITY = 50;
/**
* Maximum velocity to initiate a fling, as measured in dips per second
*/
private static final int MAXIMUM_FLING_VELOCITY = 8000;
/**
* Delay before dispatching a recurring accessibility event in milliseconds.
* This delay guarantees that a recurring event will be send at most once
* during the {@link #SEND_RECURRING_ACCESSIBILITY_EVENTS_INTERVAL_MILLIS} time
* frame.
* 在以毫秒为单位调度重复可访问性事件之前的延迟。
*/
private static final long SEND_RECURRING_ACCESSIBILITY_EVENTS_INTERVAL_MILLIS = 100;
/**
* The maximum size of View's drawing cache, expressed in bytes. This size
* should be at least equal to the size of the screen in ARGB888 format.
* view 绘制的最大缓存
*/
@Deprecated
private static final int MAXIMUM_DRAWING_CACHE_SIZE = 480 * 800 * 4; // ARGB8888
/**
* The coefficient of friction applied to flings/scrolls.
* flings/scrolls的摩擦系数
*/
private static final float SCROLL_FRICTION = 0.015f;
/**
* Max distance in dips to overscroll for edge effects
* 边缘效应的过度滚动的最大距离
*/
private static final int OVERSCROLL_DISTANCE = 0;
/**
* Max distance in dips to overfling for edge effects
* 边缘效应的过度fling的最大距离
*/
private static final int OVERFLING_DISTANCE = 6;
/**
* Amount to scroll in response to a horizontal {@link MotionEvent#ACTION_SCROLL} event,
* in dips per axis value.
* 水平滚动值,超过该值为水平滚动事件
*/
private static final float HORIZONTAL_SCROLL_FACTOR = 64;
/**
* Amount to scroll in response to a vertical {@link MotionEvent#ACTION_SCROLL} event,
* in dips per axis value.
*/
private static final float VERTICAL_SCROLL_FACTOR = 64;
/**
* Default duration to hide an action mode for.
* 隐藏动作模式的默认持续时间。
*/
private static final long ACTION_MODE_HIDE_DURATION_DEFAULT = 2000;
/**
* Defines the duration in milliseconds before an end of a long press causes a tooltip to be
* hidden.
* 定义长按结束导致隐藏工具提示之前的持续时间(毫秒)。
*/
private static final int LONG_PRESS_TOOLTIP_HIDE_TIMEOUT = 1500;
/**
* Defines the duration in milliseconds before a hover event causes a tooltip to be shown.
* 定义悬停事件导致显示工具提示之前的持续时间(以毫秒为单位)。
*/
private static final int HOVER_TOOLTIP_SHOW_TIMEOUT = 500;
/**
* Defines the duration in milliseconds before mouse inactivity causes a tooltip to be hidden.
* (default variant to be used when {@link View#SYSTEM_UI_FLAG_LOW_PROFILE} is not set).
*/
private static final int HOVER_TOOLTIP_HIDE_TIMEOUT = 15000;
/**
* Defines the duration in milliseconds before mouse inactivity causes a tooltip to be hidden
* (short version to be used when {@link View#SYSTEM_UI_FLAG_LOW_PROFILE} is set).
*/
private static final int HOVER_TOOLTIP_HIDE_SHORT_TIMEOUT = 3000;
/**
* Configuration values for overriding {@link #hasPermanentMenuKey()} behavior.
* These constants must match the definition in res/values/config.xml.
*/
private static final int HAS_PERMANENT_MENU_KEY_AUTODETECT = 0;
private static final int HAS_PERMANENT_MENU_KEY_TRUE = 1;
private static final int HAS_PERMANENT_MENU_KEY_FALSE = 2;
private final int mEdgeSlop;
private final int mFadingEdgeLength;
private final int mMinimumFlingVelocity;
private final int mMaximumFlingVelocity;
private final int mScrollbarSize;
private final int mTouchSlop;
private final int mHoverSlop;
private final int mMinScrollbarTouchTarget;
private final int mDoubleTapTouchSlop;
private final int mPagingTouchSlop;
private final int mDoubleTapSlop;
private final int mWindowTouchSlop;
private final int mMaximumDrawingCacheSize;
private final int mOverscrollDistance;
private final int mOverflingDistance;
private final boolean mFadingMarqueeEnabled;
private final long mGlobalActionsKeyTimeout;
private final float mVerticalScrollFactor;
private final float mHorizontalScrollFactor;
private final boolean mShowMenuShortcutsWhenKeyboardPresent;
private boolean sHasPermanentMenuKey;
private boolean sHasPermanentMenuKeySet;
static final SparseArray<ViewConfiguration> sConfigurations =
new SparseArray<ViewConfiguration>(2);
/**
* Creates a new configuration for the specified context. The configuration depends on
* various parameters of the context, like the dimension of the display or the density
* of the display.
*
* @param context The application context used to initialize this view configuration.
*
* @see #get(android.content.Context)
* @see android.util.DisplayMetrics
*/
private ViewConfiguration(Context context) {
final Resources res = context.getResources();
final DisplayMetrics metrics = res.getDisplayMetrics();
final Configuration config = res.getConfiguration();
final float density = metrics.density;
final float sizeAndDensity;
if (config.isLayoutSizeAtLeast(Configuration.SCREENLAYOUT_SIZE_XLARGE)) {
sizeAndDensity = density * 1.5f;
} else {
sizeAndDensity = density;
}
mEdgeSlop = (int) (sizeAndDensity * EDGE_SLOP + 0.5f);
mFadingEdgeLength = (int) (sizeAndDensity * FADING_EDGE_LENGTH + 0.5f);
mScrollbarSize = res.getDimensionPixelSize(
com.android.internal.R.dimen.config_scrollbarSize);
mDoubleTapSlop = (int) (sizeAndDensity * DOUBLE_TAP_SLOP + 0.5f);
mWindowTouchSlop = (int) (sizeAndDensity * WINDOW_TOUCH_SLOP + 0.5f);
// Size of the screen in bytes, in ARGB_8888 format
final WindowManager win = (WindowManager)context.getSystemService(Context.WINDOW_SERVICE);
final Display display = win.getDefaultDisplay();
final Point size = new Point();
display.getRealSize(size);
mMaximumDrawingCacheSize = 4 * size.x * size.y;
mOverscrollDistance = (int) (sizeAndDensity * OVERSCROLL_DISTANCE + 0.5f);
mOverflingDistance = (int) (sizeAndDensity * OVERFLING_DISTANCE + 0.5f);
if (!sHasPermanentMenuKeySet) {
final int configVal = res.getInteger(
com.android.internal.R.integer.config_overrideHasPermanentMenuKey);
switch (configVal) {
default:
case HAS_PERMANENT_MENU_KEY_AUTODETECT: {
IWindowManager wm = WindowManagerGlobal.getWindowManagerService();
try {
sHasPermanentMenuKey = !wm.hasNavigationBar();
sHasPermanentMenuKeySet = true;
} catch (RemoteException ex) {
sHasPermanentMenuKey = false;
}
}
break;
case HAS_PERMANENT_MENU_KEY_TRUE:
sHasPermanentMenuKey = true;
sHasPermanentMenuKeySet = true;
break;
case HAS_PERMANENT_MENU_KEY_FALSE:
sHasPermanentMenuKey = false;
sHasPermanentMenuKeySet = true;
break;
}
}
mFadingMarqueeEnabled = res.getBoolean(
com.android.internal.R.bool.config_ui_enableFadingMarquee);
mTouchSlop = res.getDimensionPixelSize(
com.android.internal.R.dimen.config_viewConfigurationTouchSlop);
mHoverSlop = res.getDimensionPixelSize(
com.android.internal.R.dimen.config_viewConfigurationHoverSlop);
mMinScrollbarTouchTarget = res.getDimensionPixelSize(
com.android.internal.R.dimen.config_minScrollbarTouchTarget);
mPagingTouchSlop = mTouchSlop * 2;
mDoubleTapTouchSlop = mTouchSlop;
mMinimumFlingVelocity = res.getDimensionPixelSize(
com.android.internal.R.dimen.config_viewMinFlingVelocity);
mMaximumFlingVelocity = res.getDimensionPixelSize(
com.android.internal.R.dimen.config_viewMaxFlingVelocity);
mGlobalActionsKeyTimeout = res.getInteger(
com.android.internal.R.integer.config_globalActionsKeyTimeout);
mHorizontalScrollFactor = res.getDimensionPixelSize(
com.android.internal.R.dimen.config_horizontalScrollFactor);
mVerticalScrollFactor = res.getDimensionPixelSize(
com.android.internal.R.dimen.config_verticalScrollFactor);
mShowMenuShortcutsWhenKeyboardPresent = res.getBoolean(
com.android.internal.R.bool.config_showMenuShortcutsWhenKeyboardPresent);
}
/**
* Returns a configuration for the specified context. The configuration depends on
* various parameters of the context, like the dimension of the display or the
* density of the display.
*
* @param context The application context used to initialize the view configuration.
*/
public static ViewConfiguration get(Context context) {
final DisplayMetrics metrics = context.getResources().getDisplayMetrics();
final int density = (int) (100.0f * metrics.density);
ViewConfiguration configuration = sConfigurations.get(density);
if (configuration == null) {
configuration = new ViewConfiguration(context);
sConfigurations.put(density, configuration);
}
return configuration;
}
/**
* @return The width of the horizontal scrollbar and the height of the vertical
* scrollbar in dips
*
* @deprecated Use {@link #getScaledScrollBarSize()} instead.
*/
@Deprecated
public static int getScrollBarSize() {
return SCROLL_BAR_SIZE;
}
/**
* @return The width of the horizontal scrollbar and the height of the vertical
* scrollbar in pixels
*/
public int getScaledScrollBarSize() {
return mScrollbarSize;
}
/**
* @return the minimum size of the scrollbar thumb's touch target in pixels
* @hide
*/
public int getScaledMinScrollbarTouchTarget() {
return mMinScrollbarTouchTarget;
}
/**
* @return Duration of the fade when scrollbars fade away in milliseconds
*/
public static int getScrollBarFadeDuration() {
return SCROLL_BAR_FADE_DURATION;
}
/**
* @return Default delay before the scrollbars fade in milliseconds
*/
public static int getScrollDefaultDelay() {
return SCROLL_BAR_DEFAULT_DELAY;
}
/**
* @return the length of the fading edges in dips
*
* @deprecated Use {@link #getScaledFadingEdgeLength()} instead.
*/
@Deprecated
public static int getFadingEdgeLength() {
return FADING_EDGE_LENGTH;
}
/**
* @return the length of the fading edges in pixels
*/
public int getScaledFadingEdgeLength() {
return mFadingEdgeLength;
}
/**
* @return the duration in milliseconds of the pressed state in child
* components.
*/
public static int getPressedStateDuration() {
return PRESSED_STATE_DURATION;
}
/**
* @return the duration in milliseconds before a press turns into
* a long press
*/
public static int getLongPressTimeout() {
return AppGlobals.getIntCoreSetting(Settings.Secure.LONG_PRESS_TIMEOUT,
DEFAULT_LONG_PRESS_TIMEOUT);
}
/**
* @return the duration in milliseconds between the first tap's up event and the second tap's
* down event for an interaction to be considered part of the same multi-press.
* @hide
*/
public static int getMultiPressTimeout() {
return AppGlobals.getIntCoreSetting(Settings.Secure.MULTI_PRESS_TIMEOUT,
DEFAULT_MULTI_PRESS_TIMEOUT);
}
/**
* @return the time before the first key repeat in milliseconds.
*/
public static int getKeyRepeatTimeout() {
return getLongPressTimeout();
}
/**
* @return the time between successive key repeats in milliseconds.
*/
public static int getKeyRepeatDelay() {
return KEY_REPEAT_DELAY;
}
/**
* @return the duration in milliseconds we will wait to see if a touch event
* is a tap or a scroll. If the user does not move within this interval, it is
* considered to be a tap.
*/
public static int getTapTimeout() {
return TAP_TIMEOUT;
}
/**
* @return the duration in milliseconds we will wait to see if a touch event
* is a jump tap. If the user does not move within this interval, it is
* considered to be a tap.
*/
public static int getJumpTapTimeout() {
return JUMP_TAP_TIMEOUT;
}
/**
* @return the duration in milliseconds between the first tap's up event and
* the second tap's down event for an interaction to be considered a
* double-tap.
*/
public static int getDoubleTapTimeout() {
return DOUBLE_TAP_TIMEOUT;
}
/**
* @return the minimum duration in milliseconds between the first tap's
* up event and the second tap's down event for an interaction to be considered a
* double-tap.
*
* @hide
*/
public static int getDoubleTapMinTime() {
return DOUBLE_TAP_MIN_TIME;
}
/**
* @return the maximum duration in milliseconds between a touch pad
* touch and release for a given touch to be considered a tap (click) as
* opposed to a hover movement gesture.
* @hide
*/
public static int getHoverTapTimeout() {
return HOVER_TAP_TIMEOUT;
}
/**
* @return the maximum distance in pixels that a touch pad touch can move
* before being released for it to be considered a tap (click) as opposed
* to a hover movement gesture.
* @hide
*/
public static int getHoverTapSlop() {
return HOVER_TAP_SLOP;
}
/**
* @return Inset in dips to look for touchable content when the user touches the edge of the
* screen
*
* @deprecated Use {@link #getScaledEdgeSlop()} instead.
*/
@Deprecated
public static int getEdgeSlop() {
return EDGE_SLOP;
}
/**
* @return Inset in pixels to look for touchable content when the user touches the edge of the
* screen
*/
public int getScaledEdgeSlop() {
return mEdgeSlop;
}
/**
* @return Distance in dips a touch can wander before we think the user is scrolling
*
* @deprecated Use {@link #getScaledTouchSlop()} instead.
*/
@Deprecated
public static int getTouchSlop() {
return TOUCH_SLOP;
}
/**
* @return Distance in pixels a touch can wander before we think the user is scrolling
*/
public int getScaledTouchSlop() {
return mTouchSlop;
}
/**
* @return Distance in pixels a hover can wander while it is still considered "stationary".
*
*/
public int getScaledHoverSlop() {
return mHoverSlop;
}
/**
* @return Distance in pixels the first touch can wander before we do not consider this a
* potential double tap event
* @hide
*/
public int getScaledDoubleTapTouchSlop() {
return mDoubleTapTouchSlop;
}
/**
* @return Distance in pixels a touch can wander before we think the user is scrolling a full
* page
*/
public int getScaledPagingTouchSlop() {
return mPagingTouchSlop;
}
/**
* @return Distance in dips between the first touch and second touch to still be
* considered a double tap
* @deprecated Use {@link #getScaledDoubleTapSlop()} instead.
* @hide The only client of this should be GestureDetector, which needs this
* for clients that still use its deprecated constructor.
*/
@Deprecated
public static int getDoubleTapSlop() {
return DOUBLE_TAP_SLOP;
}
/**
* @return Distance in pixels between the first touch and second touch to still be
* considered a double tap
*/
public int getScaledDoubleTapSlop() {
return mDoubleTapSlop;
}
/**
* Interval for dispatching a recurring accessibility event in milliseconds.
* This interval guarantees that a recurring event will be send at most once
* during the {@link #getSendRecurringAccessibilityEventsInterval()} time frame.
*
* @return The delay in milliseconds.
*
* @hide
*/
public static long getSendRecurringAccessibilityEventsInterval() {
return SEND_RECURRING_ACCESSIBILITY_EVENTS_INTERVAL_MILLIS;
}
/**
* @return Distance in dips a touch must be outside the bounds of a window for it
* to be counted as outside the window for purposes of dismissing that
* window.
*
* @deprecated Use {@link #getScaledWindowTouchSlop()} instead.
*/
@Deprecated
public static int getWindowTouchSlop() {
return WINDOW_TOUCH_SLOP;
}
/**
* @return Distance in pixels a touch must be outside the bounds of a window for it
* to be counted as outside the window for purposes of dismissing that window.
*/
public int getScaledWindowTouchSlop() {
return mWindowTouchSlop;
}
/**
* @return Minimum velocity to initiate a fling, as measured in dips per second.
*
* @deprecated Use {@link #getScaledMinimumFlingVelocity()} instead.
*/
@Deprecated
public static int getMinimumFlingVelocity() {
return MINIMUM_FLING_VELOCITY;
}
/**
* @return Minimum velocity to initiate a fling, as measured in pixels per second.
*/
public int getScaledMinimumFlingVelocity() {
return mMinimumFlingVelocity;
}
/**
* @return Maximum velocity to initiate a fling, as measured in dips per second.
*
* @deprecated Use {@link #getScaledMaximumFlingVelocity()} instead.
*/
@Deprecated
public static int getMaximumFlingVelocity() {
return MAXIMUM_FLING_VELOCITY;
}
/**
* @return Maximum velocity to initiate a fling, as measured in pixels per second.
*/
public int getScaledMaximumFlingVelocity() {
return mMaximumFlingVelocity;
}
/**
* @return Amount to scroll in response to a {@link MotionEvent#ACTION_SCROLL} event. Multiply
* this by the event's axis value to obtain the number of pixels to be scrolled.
*
* @removed
*/
public int getScaledScrollFactor() {
return (int) mVerticalScrollFactor;
}
/**
* @return Amount to scroll in response to a horizontal {@link MotionEvent#ACTION_SCROLL} event.
* Multiply this by the event's axis value to obtain the number of pixels to be scrolled.
*/
public float getScaledHorizontalScrollFactor() {
return mHorizontalScrollFactor;
}
/**
* @return Amount to scroll in response to a vertical {@link MotionEvent#ACTION_SCROLL} event.
* Multiply this by the event's axis value to obtain the number of pixels to be scrolled.
*/
public float getScaledVerticalScrollFactor() {
return mVerticalScrollFactor;
}
/**
* The maximum drawing cache size expressed in bytes.
*
* @return the maximum size of View's drawing cache expressed in bytes
*
* @deprecated Use {@link #getScaledMaximumDrawingCacheSize()} instead.
*/
@Deprecated
public static int getMaximumDrawingCacheSize() {
//noinspection deprecation
return MAXIMUM_DRAWING_CACHE_SIZE;
}
/**
* The maximum drawing cache size expressed in bytes.
*
* @return the maximum size of View's drawing cache expressed in bytes
*/
public int getScaledMaximumDrawingCacheSize() {
return mMaximumDrawingCacheSize;
}
/**
* @return The maximum distance a View should overscroll by when showing edge effects (in
* pixels).
*/
public int getScaledOverscrollDistance() {
return mOverscrollDistance;
}
/**
* @return The maximum distance a View should overfling by when showing edge effects (in
* pixels).
*/
public int getScaledOverflingDistance() {
return mOverflingDistance;
}
/**
* The amount of time that the zoom controls should be
* displayed on the screen expressed in milliseconds.
*
* @return the time the zoom controls should be visible expressed
* in milliseconds.
*/
public static long getZoomControlsTimeout() {
return ZOOM_CONTROLS_TIMEOUT;
}
/**
* The amount of time a user needs to press the relevant key to bring up
* the global actions dialog.
*
* @return how long a user needs to press the relevant key to bring up
* the global actions dialog.
* @deprecated This timeout should not be used by applications
*/
@Deprecated
public static long getGlobalActionKeyTimeout() {
return GLOBAL_ACTIONS_KEY_TIMEOUT;
}
/**
* The amount of time a user needs to press the relevant key to bring up
* the global actions dialog.
*
* @return how long a user needs to press the relevant key to bring up
* the global actions dialog.
* @hide
*/
public long getDeviceGlobalActionKeyTimeout() {
return mGlobalActionsKeyTimeout;
}
/**
* The amount of time a user needs to press the relevant keys to activate the accessibility
* shortcut.
*
* @return how long a user needs to press the relevant keys to activate the accessibility
* shortcut.
* @hide
*/
public long getAccessibilityShortcutKeyTimeout() {
return A11Y_SHORTCUT_KEY_TIMEOUT;
}
/**
* @return The amount of time a user needs to press the relevant keys to activate the
* accessibility shortcut after it's confirmed that accessibility shortcut is used.
* @hide
*/
public long getAccessibilityShortcutKeyTimeoutAfterConfirmation() {
return A11Y_SHORTCUT_KEY_TIMEOUT_AFTER_CONFIRMATION;
}
/**
* The amount of friction applied to scrolls and flings.
*
* @return A scalar dimensionless value representing the coefficient of
* friction.
*/
public static float getScrollFriction() {
return SCROLL_FRICTION;
}
/**
* @return the default duration in milliseconds for {@link ActionMode#hide(long)}.
*/
public static long getDefaultActionModeHideDuration() {
return ACTION_MODE_HIDE_DURATION_DEFAULT;
}
/**
* Report if the device has a permanent menu key available to the user.
*
* <p>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.
*
* @return true if a permanent menu key is present, false otherwise.
*/
public boolean hasPermanentMenuKey() {
return sHasPermanentMenuKey;
}
/**
* Check if shortcuts should be displayed in menus.
*
* @return {@code True} if shortcuts should be displayed in menus.
*/
public boolean shouldShowMenuShortcutsWhenKeyboardPresent() {
return mShowMenuShortcutsWhenKeyboardPresent;
}
/**
* @hide
* @return Whether or not marquee should use fading edges.
*/
public boolean isFadingMarqueeEnabled() {
return mFadingMarqueeEnabled;
}
/**
* @return the duration in milliseconds before an end of a long press causes a tooltip to be
* hidden
* @hide
*/
@TestApi
public static int getLongPressTooltipHideTimeout() {
return LONG_PRESS_TOOLTIP_HIDE_TIMEOUT;
}
/**
* @return the duration in milliseconds before a hover event causes a tooltip to be shown
* @hide
*/
@TestApi
public static int getHoverTooltipShowTimeout() {
return HOVER_TOOLTIP_SHOW_TIMEOUT;
}
/**
* @return the duration in milliseconds before mouse inactivity causes a tooltip to be hidden
* (default variant to be used when {@link View#SYSTEM_UI_FLAG_LOW_PROFILE} is not set).
* @hide
*/
@TestApi
public static int getHoverTooltipHideTimeout() {
return HOVER_TOOLTIP_HIDE_TIMEOUT;
}
/**
* @return the duration in milliseconds before mouse inactivity causes a tooltip to be hidden
* (shorter variant to be used when {@link View#SYSTEM_UI_FLAG_LOW_PROFILE} is set).
* @hide
*/
@TestApi
public static int getHoverTooltipHideShortTimeout() {
return HOVER_TOOLTIP_HIDE_SHORT_TIMEOUT;
}
}