summaryrefslogtreecommitdiff
path: root/core/java/android/view/ViewConfiguration.java
diff options
context:
space:
mode:
authorThe Android Open Source Project <initial-contribution@android.com>2009-03-03 18:28:45 -0800
committerThe Android Open Source Project <initial-contribution@android.com>2009-03-03 18:28:45 -0800
commitd83a98f4ce9cfa908f5c54bbd70f03eec07e7553 (patch)
tree4b825dc642cb6eb9a060e54bf8d69288fbee4904 /core/java/android/view/ViewConfiguration.java
parent076357b8567458d4b6dfdcf839ef751634cd2bfb (diff)
auto import from //depot/cupcake/@135843
Diffstat (limited to 'core/java/android/view/ViewConfiguration.java')
-rw-r--r--core/java/android/view/ViewConfiguration.java424
1 files changed, 0 insertions, 424 deletions
diff --git a/core/java/android/view/ViewConfiguration.java b/core/java/android/view/ViewConfiguration.java
deleted file mode 100644
index 2f7b0d1a0068..000000000000
--- a/core/java/android/view/ViewConfiguration.java
+++ /dev/null
@@ -1,424 +0,0 @@
-/*
- * Copyright (C) 2006 The Android Open Source Project
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package android.view;
-
-import android.content.Context;
-import android.util.DisplayMetrics;
-import android.util.SparseArray;
-
-/**
- * Contains methods to standard constants used in the UI for timeouts, sizes, and distances.
- */
-public class ViewConfiguration {
- /**
- * Defines the width of the horizontal scrollbar and the height of the vertical scrollbar in
- * pixels
- */
- private static final int SCROLL_BAR_SIZE = 10;
-
- /**
- * Defines the length of the fading edges in pixels
- */
- private static final int FADING_EDGE_LENGTH = 12;
-
- /**
- * Defines the duration in milliseconds of the pressed state in child
- * components.
- */
- private static final int PRESSED_STATE_DURATION = 85;
-
- /**
- * Defines the duration in milliseconds before a press turns into
- * a long press
- */
- private static final int LONG_PRESS_TIMEOUT = 500;
-
- /**
- * 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;
-
- /**
- * Defines the duration in milliseconds we will wait to see if a touch event
- * is a top or a scroll. If the user does not move within this interval, it is
- * considered to be a tap.
- */
- private static final int TAP_TIMEOUT = 100;
-
- /**
- * Defines the duration in milliseconds we will wait to see if a touch event
- * is a jump tap. If the user does not complete the jump tap within this interval, it is
- * considered to be a tap.
- */
- 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 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 pixels to look for touchable content when the user touches the edge of the screen
- */
- private static final int EDGE_SLOP = 12;
-
- /**
- * Distance a touch can wander before we think the user is scrolling in pixels
- */
- private static final int TOUCH_SLOP = 25;
-
- /**
- * Distance between the first touch and second touch to still be considered a double tap
- */
- private static final int DOUBLE_TAP_SLOP = 100;
-
- /**
- * Distance 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 pixels per second
- */
- private static final int MINIMUM_FLING_VELOCITY = 50;
-
- /**
- * 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.
- */
- @Deprecated
- private static final int MAXIMUM_DRAWING_CACHE_SIZE = 320 * 480 * 4; // HVGA screen, ARGB8888
-
- /**
- * The coefficient of friction applied to flings/scrolls.
- */
- private static float SCROLL_FRICTION = 0.015f;
-
- private final int mEdgeSlop;
- private final int mFadingEdgeLength;
- private final int mMinimumFlingVelocity;
- private final int mScrollbarSize;
- private final int mTouchSlop;
- private final int mDoubleTapSlop;
- private final int mWindowTouchSlop;
- private final int mMaximumDrawingCacheSize;
-
- private static final SparseArray<ViewConfiguration> sConfigurations =
- new SparseArray<ViewConfiguration>(2);
-
- /**
- * @deprecated Use {@link android.view.ViewConfiguration#get(android.content.Context)} instead.
- */
- @Deprecated
- public ViewConfiguration() {
- mEdgeSlop = EDGE_SLOP;
- mFadingEdgeLength = FADING_EDGE_LENGTH;
- mMinimumFlingVelocity = MINIMUM_FLING_VELOCITY;
- mScrollbarSize = SCROLL_BAR_SIZE;
- mTouchSlop = TOUCH_SLOP;
- mDoubleTapSlop = DOUBLE_TAP_SLOP;
- mWindowTouchSlop = WINDOW_TOUCH_SLOP;
- //noinspection deprecation
- mMaximumDrawingCacheSize = MAXIMUM_DRAWING_CACHE_SIZE;
- }
-
- /**
- * 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 DisplayMetrics metrics = context.getResources().getDisplayMetrics();
- final float density = metrics.density;
-
- mEdgeSlop = (int) (density * EDGE_SLOP + 0.5f);
- mFadingEdgeLength = (int) (density * FADING_EDGE_LENGTH + 0.5f);
- mMinimumFlingVelocity = (int) (density * MINIMUM_FLING_VELOCITY + 0.5f);
- mScrollbarSize = (int) (density * SCROLL_BAR_SIZE + 0.5f);
- mTouchSlop = (int) (density * TOUCH_SLOP + 0.5f);
- mDoubleTapSlop = (int) (density * DOUBLE_TAP_SLOP + 0.5f);
- mWindowTouchSlop = (int) (density * WINDOW_TOUCH_SLOP + 0.5f);
-
- // Size of the screen in bytes, in ARGB_8888 format
- mMaximumDrawingCacheSize = 4 * metrics.widthPixels * metrics.heightPixels;
- }
-
- /**
- * 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 pixels
- *
- * @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 Defines the length of the fading edges in pixels
- *
- * @deprecated Use {@link #getScaledFadingEdgeLength()} instead.
- */
- @Deprecated
- public static int getFadingEdgeLength() {
- return FADING_EDGE_LENGTH;
- }
-
- /**
- * @return Defines the length of the fading edges in pixels
- */
- public int getScaledFadingEdgeLength() {
- return mFadingEdgeLength;
- }
-
- /**
- * @return Defines the duration in milliseconds of the pressed state in child
- * components.
- */
- public static int getPressedStateDuration() {
- return PRESSED_STATE_DURATION;
- }
-
- /**
- * @return Defines the duration in milliseconds before a press turns into
- * a long press
- */
- public static int getLongPressTimeout() {
- return LONG_PRESS_TIMEOUT;
- }
-
- /**
- * @return Defines the duration in milliseconds we will wait to see if a touch event
- * is a top 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 Defines 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 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.
- * @hide pending API council
- */
- public static int getDoubleTapTimeout() {
- return DOUBLE_TAP_TIMEOUT;
- }
-
- /**
- * @return Inset in pixels 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 a touch can wander before we think the user is scrolling in pixels
- *
- * @deprecated Use {@link #getScaledTouchSlop()} instead.
- */
- @Deprecated
- public static int getTouchSlop() {
- return TOUCH_SLOP;
- }
-
- /**
- * @return Distance a touch can wander before we think the user is scrolling in pixels
- */
- public int getScaledTouchSlop() {
- return mTouchSlop;
- }
-
- /**
- * @return Distance 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 between the first touch and second touch to still be
- * considered a double tap
- * @hide pending API council
- */
- public int getScaledDoubleTapSlop() {
- return mDoubleTapSlop;
- }
-
- /**
- * @return Distance 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 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 pixels 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;
- }
-
- /**
- * 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;
- }
-
- /**
- * 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.
- */
- public static long getGlobalActionKeyTimeout() {
- return GLOBAL_ACTIONS_KEY_TIMEOUT;
- }
-
- /**
- * 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;
- }
-}