• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2010 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 package com.android.launcher2;
18 
19 import android.animation.Animator;
20 import android.animation.AnimatorListenerAdapter;
21 import android.animation.ValueAnimator;
22 import android.content.Context;
23 import android.content.res.TypedArray;
24 import android.graphics.Canvas;
25 import android.graphics.Rect;
26 import android.os.Bundle;
27 import android.os.Parcel;
28 import android.os.Parcelable;
29 import android.util.AttributeSet;
30 import android.util.Log;
31 import android.view.InputDevice;
32 import android.view.KeyEvent;
33 import android.view.MotionEvent;
34 import android.view.VelocityTracker;
35 import android.view.View;
36 import android.view.ViewConfiguration;
37 import android.view.ViewGroup;
38 import android.view.ViewParent;
39 import android.view.accessibility.AccessibilityEvent;
40 import android.view.accessibility.AccessibilityManager;
41 import android.view.accessibility.AccessibilityNodeInfo;
42 import android.view.animation.Interpolator;
43 import android.widget.Scroller;
44 
45 import com.android.launcher.R;
46 
47 import java.util.ArrayList;
48 
49 /**
50  * An abstraction of the original Workspace which supports browsing through a
51  * sequential list of "pages"
52  */
53 public abstract class PagedView extends ViewGroup implements ViewGroup.OnHierarchyChangeListener {
54     private static final String TAG = "PagedView";
55     private static final boolean DEBUG = false;
56     protected static final int INVALID_PAGE = -1;
57 
58     // the min drag distance for a fling to register, to prevent random page shifts
59     private static final int MIN_LENGTH_FOR_FLING = 25;
60 
61     protected static final int PAGE_SNAP_ANIMATION_DURATION = 550;
62     protected static final int MAX_PAGE_SNAP_DURATION = 750;
63     protected static final int SLOW_PAGE_SNAP_ANIMATION_DURATION = 950;
64     protected static final float NANOTIME_DIV = 1000000000.0f;
65 
66     private static final float OVERSCROLL_ACCELERATE_FACTOR = 2;
67     private static final float OVERSCROLL_DAMP_FACTOR = 0.14f;
68 
69     private static final float RETURN_TO_ORIGINAL_PAGE_THRESHOLD = 0.33f;
70     // The page is moved more than halfway, automatically move to the next page on touch up.
71     private static final float SIGNIFICANT_MOVE_THRESHOLD = 0.4f;
72 
73     // The following constants need to be scaled based on density. The scaled versions will be
74     // assigned to the corresponding member variables below.
75     private static final int FLING_THRESHOLD_VELOCITY = 500;
76     private static final int MIN_SNAP_VELOCITY = 1500;
77     private static final int MIN_FLING_VELOCITY = 250;
78 
79     static final int AUTOMATIC_PAGE_SPACING = -1;
80 
81     protected int mFlingThresholdVelocity;
82     protected int mMinFlingVelocity;
83     protected int mMinSnapVelocity;
84 
85     protected float mDensity;
86     protected float mSmoothingTime;
87     protected float mTouchX;
88 
89     protected boolean mFirstLayout = true;
90 
91     protected int mCurrentPage;
92     protected int mNextPage = INVALID_PAGE;
93     protected int mMaxScrollX;
94     protected Scroller mScroller;
95     private VelocityTracker mVelocityTracker;
96 
97     private float mDownMotionX;
98     protected float mLastMotionX;
99     protected float mLastMotionXRemainder;
100     protected float mLastMotionY;
101     protected float mTotalMotionX;
102     private int mLastScreenCenter = -1;
103     private int[] mChildOffsets;
104     private int[] mChildRelativeOffsets;
105     private int[] mChildOffsetsWithLayoutScale;
106 
107     protected final static int TOUCH_STATE_REST = 0;
108     protected final static int TOUCH_STATE_SCROLLING = 1;
109     protected final static int TOUCH_STATE_PREV_PAGE = 2;
110     protected final static int TOUCH_STATE_NEXT_PAGE = 3;
111     protected final static float ALPHA_QUANTIZE_LEVEL = 0.0001f;
112 
113     protected int mTouchState = TOUCH_STATE_REST;
114     protected boolean mForceScreenScrolled = false;
115 
116     protected OnLongClickListener mLongClickListener;
117 
118     protected boolean mAllowLongPress = true;
119 
120     protected int mTouchSlop;
121     private int mPagingTouchSlop;
122     private int mMaximumVelocity;
123     private int mMinimumWidth;
124     protected int mPageSpacing;
125     protected int mPageLayoutPaddingTop;
126     protected int mPageLayoutPaddingBottom;
127     protected int mPageLayoutPaddingLeft;
128     protected int mPageLayoutPaddingRight;
129     protected int mPageLayoutWidthGap;
130     protected int mPageLayoutHeightGap;
131     protected int mCellCountX = 0;
132     protected int mCellCountY = 0;
133     protected boolean mCenterPagesVertically;
134     protected boolean mAllowOverScroll = true;
135     protected int mUnboundedScrollX;
136     protected int[] mTempVisiblePagesRange = new int[2];
137     protected boolean mForceDrawAllChildrenNextFrame;
138 
139     // mOverScrollX is equal to getScrollX() when we're within the normal scroll range. Otherwise
140     // it is equal to the scaled overscroll position. We use a separate value so as to prevent
141     // the screens from continuing to translate beyond the normal bounds.
142     protected int mOverScrollX;
143 
144     // parameter that adjusts the layout to be optimized for pages with that scale factor
145     protected float mLayoutScale = 1.0f;
146 
147     protected static final int INVALID_POINTER = -1;
148 
149     protected int mActivePointerId = INVALID_POINTER;
150 
151     private PageSwitchListener mPageSwitchListener;
152 
153     protected ArrayList<Boolean> mDirtyPageContent;
154 
155     // If true, syncPages and syncPageItems will be called to refresh pages
156     protected boolean mContentIsRefreshable = true;
157 
158     // If true, modify alpha of neighboring pages as user scrolls left/right
159     protected boolean mFadeInAdjacentScreens = true;
160 
161     // It true, use a different slop parameter (pagingTouchSlop = 2 * touchSlop) for deciding
162     // to switch to a new page
163     protected boolean mUsePagingTouchSlop = true;
164 
165     // If true, the subclass should directly update scrollX itself in its computeScroll method
166     // (SmoothPagedView does this)
167     protected boolean mDeferScrollUpdate = false;
168 
169     protected boolean mIsPageMoving = false;
170 
171     // All syncs and layout passes are deferred until data is ready.
172     protected boolean mIsDataReady = false;
173 
174     // Scrolling indicator
175     private ValueAnimator mScrollIndicatorAnimator;
176     private View mScrollIndicator;
177     private int mScrollIndicatorPaddingLeft;
178     private int mScrollIndicatorPaddingRight;
179     private boolean mHasScrollIndicator = true;
180     private boolean mShouldShowScrollIndicator = false;
181     private boolean mShouldShowScrollIndicatorImmediately = false;
182     protected static final int sScrollIndicatorFadeInDuration = 150;
183     protected static final int sScrollIndicatorFadeOutDuration = 650;
184     protected static final int sScrollIndicatorFlashDuration = 650;
185     private boolean mScrollingPaused = false;
186 
187     // If set, will defer loading associated pages until the scrolling settles
188     private boolean mDeferLoadAssociatedPagesUntilScrollCompletes;
189 
190     public interface PageSwitchListener {
onPageSwitch(View newPage, int newPageIndex)191         void onPageSwitch(View newPage, int newPageIndex);
192     }
193 
PagedView(Context context)194     public PagedView(Context context) {
195         this(context, null);
196     }
197 
PagedView(Context context, AttributeSet attrs)198     public PagedView(Context context, AttributeSet attrs) {
199         this(context, attrs, 0);
200     }
201 
PagedView(Context context, AttributeSet attrs, int defStyle)202     public PagedView(Context context, AttributeSet attrs, int defStyle) {
203         super(context, attrs, defStyle);
204 
205         TypedArray a = context.obtainStyledAttributes(attrs,
206                 R.styleable.PagedView, defStyle, 0);
207         setPageSpacing(a.getDimensionPixelSize(R.styleable.PagedView_pageSpacing, 0));
208         mPageLayoutPaddingTop = a.getDimensionPixelSize(
209                 R.styleable.PagedView_pageLayoutPaddingTop, 0);
210         mPageLayoutPaddingBottom = a.getDimensionPixelSize(
211                 R.styleable.PagedView_pageLayoutPaddingBottom, 0);
212         mPageLayoutPaddingLeft = a.getDimensionPixelSize(
213                 R.styleable.PagedView_pageLayoutPaddingLeft, 0);
214         mPageLayoutPaddingRight = a.getDimensionPixelSize(
215                 R.styleable.PagedView_pageLayoutPaddingRight, 0);
216         mPageLayoutWidthGap = a.getDimensionPixelSize(
217                 R.styleable.PagedView_pageLayoutWidthGap, 0);
218         mPageLayoutHeightGap = a.getDimensionPixelSize(
219                 R.styleable.PagedView_pageLayoutHeightGap, 0);
220         mScrollIndicatorPaddingLeft =
221             a.getDimensionPixelSize(R.styleable.PagedView_scrollIndicatorPaddingLeft, 0);
222         mScrollIndicatorPaddingRight =
223             a.getDimensionPixelSize(R.styleable.PagedView_scrollIndicatorPaddingRight, 0);
224         a.recycle();
225 
226         setHapticFeedbackEnabled(false);
227         init();
228     }
229 
230     /**
231      * Initializes various states for this workspace.
232      */
init()233     protected void init() {
234         mDirtyPageContent = new ArrayList<Boolean>();
235         mDirtyPageContent.ensureCapacity(32);
236         mScroller = new Scroller(getContext(), new ScrollInterpolator());
237         mCurrentPage = 0;
238         mCenterPagesVertically = true;
239 
240         final ViewConfiguration configuration = ViewConfiguration.get(getContext());
241         mTouchSlop = configuration.getScaledTouchSlop();
242         mPagingTouchSlop = configuration.getScaledPagingTouchSlop();
243         mMaximumVelocity = configuration.getScaledMaximumFlingVelocity();
244         mDensity = getResources().getDisplayMetrics().density;
245 
246         mFlingThresholdVelocity = (int) (FLING_THRESHOLD_VELOCITY * mDensity);
247         mMinFlingVelocity = (int) (MIN_FLING_VELOCITY * mDensity);
248         mMinSnapVelocity = (int) (MIN_SNAP_VELOCITY * mDensity);
249         setOnHierarchyChangeListener(this);
250     }
251 
setPageSwitchListener(PageSwitchListener pageSwitchListener)252     public void setPageSwitchListener(PageSwitchListener pageSwitchListener) {
253         mPageSwitchListener = pageSwitchListener;
254         if (mPageSwitchListener != null) {
255             mPageSwitchListener.onPageSwitch(getPageAt(mCurrentPage), mCurrentPage);
256         }
257     }
258 
259     /**
260      * Called by subclasses to mark that data is ready, and that we can begin loading and laying
261      * out pages.
262      */
setDataIsReady()263     protected void setDataIsReady() {
264         mIsDataReady = true;
265     }
isDataReady()266     protected boolean isDataReady() {
267         return mIsDataReady;
268     }
269 
270     /**
271      * Returns the index of the currently displayed page.
272      *
273      * @return The index of the currently displayed page.
274      */
getCurrentPage()275     int getCurrentPage() {
276         return mCurrentPage;
277     }
getNextPage()278     int getNextPage() {
279         return (mNextPage != INVALID_PAGE) ? mNextPage : mCurrentPage;
280     }
281 
getPageCount()282     int getPageCount() {
283         return getChildCount();
284     }
285 
getPageAt(int index)286     View getPageAt(int index) {
287         return getChildAt(index);
288     }
289 
indexToPage(int index)290     protected int indexToPage(int index) {
291         return index;
292     }
293 
294     /**
295      * Updates the scroll of the current page immediately to its final scroll position.  We use this
296      * in CustomizePagedView to allow tabs to share the same PagedView while resetting the scroll of
297      * the previous tab page.
298      */
updateCurrentPageScroll()299     protected void updateCurrentPageScroll() {
300         // If the current page is invalid, just reset the scroll position to zero
301         int newX = 0;
302         if (0 <= mCurrentPage && mCurrentPage < getPageCount()) {
303             int offset = getChildOffset(mCurrentPage);
304             int relOffset = getRelativeChildOffset(mCurrentPage);
305             newX = offset - relOffset;
306         }
307         scrollTo(newX, 0);
308         mScroller.setFinalX(newX);
309         mScroller.forceFinished(true);
310     }
311 
312     /**
313      * Called during AllApps/Home transitions to avoid unnecessary work. When that other animation
314      * ends, {@link #resumeScrolling()} should be called, along with
315      * {@link #updateCurrentPageScroll()} to correctly set the final state and re-enable scrolling.
316      */
pauseScrolling()317     void pauseScrolling() {
318         mScroller.forceFinished(true);
319         cancelScrollingIndicatorAnimations();
320         mScrollingPaused = true;
321     }
322 
323     /**
324      * Enables scrolling again.
325      * @see #pauseScrolling()
326      */
resumeScrolling()327     void resumeScrolling() {
328         mScrollingPaused = false;
329     }
330     /**
331      * Sets the current page.
332      */
setCurrentPage(int currentPage)333     void setCurrentPage(int currentPage) {
334         if (!mScroller.isFinished()) {
335             mScroller.abortAnimation();
336         }
337         // don't introduce any checks like mCurrentPage == currentPage here-- if we change the
338         // the default
339         if (getChildCount() == 0) {
340             return;
341         }
342 
343 
344         mCurrentPage = Math.max(0, Math.min(currentPage, getPageCount() - 1));
345         updateCurrentPageScroll();
346         updateScrollingIndicator();
347         notifyPageSwitchListener();
348         invalidate();
349     }
350 
notifyPageSwitchListener()351     protected void notifyPageSwitchListener() {
352         if (mPageSwitchListener != null) {
353             mPageSwitchListener.onPageSwitch(getPageAt(mCurrentPage), mCurrentPage);
354         }
355     }
356 
pageBeginMoving()357     protected void pageBeginMoving() {
358         if (!mIsPageMoving) {
359             mIsPageMoving = true;
360             onPageBeginMoving();
361         }
362     }
363 
pageEndMoving()364     protected void pageEndMoving() {
365         if (mIsPageMoving) {
366             mIsPageMoving = false;
367             onPageEndMoving();
368         }
369     }
370 
isPageMoving()371     protected boolean isPageMoving() {
372         return mIsPageMoving;
373     }
374 
375     // a method that subclasses can override to add behavior
onPageBeginMoving()376     protected void onPageBeginMoving() {
377     }
378 
379     // a method that subclasses can override to add behavior
onPageEndMoving()380     protected void onPageEndMoving() {
381     }
382 
383     /**
384      * Registers the specified listener on each page contained in this workspace.
385      *
386      * @param l The listener used to respond to long clicks.
387      */
388     @Override
setOnLongClickListener(OnLongClickListener l)389     public void setOnLongClickListener(OnLongClickListener l) {
390         mLongClickListener = l;
391         final int count = getPageCount();
392         for (int i = 0; i < count; i++) {
393             getPageAt(i).setOnLongClickListener(l);
394         }
395     }
396 
397     @Override
scrollBy(int x, int y)398     public void scrollBy(int x, int y) {
399         scrollTo(mUnboundedScrollX + x, getScrollY() + y);
400     }
401 
402     @Override
scrollTo(int x, int y)403     public void scrollTo(int x, int y) {
404         mUnboundedScrollX = x;
405 
406         if (x < 0) {
407             super.scrollTo(0, y);
408             if (mAllowOverScroll) {
409                 overScroll(x);
410             }
411         } else if (x > mMaxScrollX) {
412             super.scrollTo(mMaxScrollX, y);
413             if (mAllowOverScroll) {
414                 overScroll(x - mMaxScrollX);
415             }
416         } else {
417             mOverScrollX = x;
418             super.scrollTo(x, y);
419         }
420 
421         mTouchX = x;
422         mSmoothingTime = System.nanoTime() / NANOTIME_DIV;
423     }
424 
425     // we moved this functionality to a helper function so SmoothPagedView can reuse it
computeScrollHelper()426     protected boolean computeScrollHelper() {
427         if (mScroller.computeScrollOffset()) {
428             // Don't bother scrolling if the page does not need to be moved
429             if (getScrollX() != mScroller.getCurrX()
430                 || getScrollY() != mScroller.getCurrY()
431                 || mOverScrollX != mScroller.getCurrX()) {
432                 scrollTo(mScroller.getCurrX(), mScroller.getCurrY());
433             }
434             invalidate();
435             return true;
436         } else if (mNextPage != INVALID_PAGE) {
437             mCurrentPage = Math.max(0, Math.min(mNextPage, getPageCount() - 1));
438             mNextPage = INVALID_PAGE;
439             notifyPageSwitchListener();
440 
441             // Load the associated pages if necessary
442             if (mDeferLoadAssociatedPagesUntilScrollCompletes) {
443                 loadAssociatedPages(mCurrentPage);
444                 mDeferLoadAssociatedPagesUntilScrollCompletes = false;
445             }
446 
447             // We don't want to trigger a page end moving unless the page has settled
448             // and the user has stopped scrolling
449             if (mTouchState == TOUCH_STATE_REST) {
450                 pageEndMoving();
451             }
452 
453             // Notify the user when the page changes
454             AccessibilityManager accessibilityManager = (AccessibilityManager)
455                     getContext().getSystemService(Context.ACCESSIBILITY_SERVICE);
456             if (accessibilityManager.isEnabled()) {
457                 AccessibilityEvent ev =
458                     AccessibilityEvent.obtain(AccessibilityEvent.TYPE_VIEW_SCROLLED);
459                 ev.getText().add(getCurrentPageDescription());
460                 sendAccessibilityEventUnchecked(ev);
461             }
462             return true;
463         }
464         return false;
465     }
466 
467     @Override
computeScroll()468     public void computeScroll() {
469         computeScrollHelper();
470     }
471 
472     @Override
onMeasure(int widthMeasureSpec, int heightMeasureSpec)473     protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
474         if (!mIsDataReady) {
475             super.onMeasure(widthMeasureSpec, heightMeasureSpec);
476             return;
477         }
478 
479         final int widthMode = MeasureSpec.getMode(widthMeasureSpec);
480         final int widthSize = MeasureSpec.getSize(widthMeasureSpec);
481         final int heightMode = MeasureSpec.getMode(heightMeasureSpec);
482         int heightSize = MeasureSpec.getSize(heightMeasureSpec);
483         if (widthMode != MeasureSpec.EXACTLY) {
484             throw new IllegalStateException("Workspace can only be used in EXACTLY mode.");
485         }
486 
487         // Return early if we aren't given a proper dimension
488         if (widthSize <= 0 || heightSize <= 0) {
489             super.onMeasure(widthMeasureSpec, heightMeasureSpec);
490             return;
491         }
492 
493         /* Allow the height to be set as WRAP_CONTENT. This allows the particular case
494          * of the All apps view on XLarge displays to not take up more space then it needs. Width
495          * is still not allowed to be set as WRAP_CONTENT since many parts of the code expect
496          * each page to have the same width.
497          */
498         int maxChildHeight = 0;
499 
500         final int verticalPadding = getPaddingTop() + getPaddingBottom();
501         final int horizontalPadding = getPaddingLeft() + getPaddingRight();
502 
503 
504         // The children are given the same width and height as the workspace
505         // unless they were set to WRAP_CONTENT
506         if (DEBUG) Log.d(TAG, "PagedView.onMeasure(): " + widthSize + ", " + heightSize);
507         final int childCount = getChildCount();
508         for (int i = 0; i < childCount; i++) {
509             // disallowing padding in paged view (just pass 0)
510             final View child = getPageAt(i);
511             final LayoutParams lp = (LayoutParams) child.getLayoutParams();
512 
513             int childWidthMode;
514             if (lp.width == LayoutParams.WRAP_CONTENT) {
515                 childWidthMode = MeasureSpec.AT_MOST;
516             } else {
517                 childWidthMode = MeasureSpec.EXACTLY;
518             }
519 
520             int childHeightMode;
521             if (lp.height == LayoutParams.WRAP_CONTENT) {
522                 childHeightMode = MeasureSpec.AT_MOST;
523             } else {
524                 childHeightMode = MeasureSpec.EXACTLY;
525             }
526 
527             final int childWidthMeasureSpec =
528                 MeasureSpec.makeMeasureSpec(widthSize - horizontalPadding, childWidthMode);
529             final int childHeightMeasureSpec =
530                 MeasureSpec.makeMeasureSpec(heightSize - verticalPadding, childHeightMode);
531 
532             child.measure(childWidthMeasureSpec, childHeightMeasureSpec);
533             maxChildHeight = Math.max(maxChildHeight, child.getMeasuredHeight());
534             if (DEBUG) Log.d(TAG, "\tmeasure-child" + i + ": " + child.getMeasuredWidth() + ", "
535                     + child.getMeasuredHeight());
536         }
537 
538         if (heightMode == MeasureSpec.AT_MOST) {
539             heightSize = maxChildHeight + verticalPadding;
540         }
541 
542         setMeasuredDimension(widthSize, heightSize);
543 
544         // We can't call getChildOffset/getRelativeChildOffset until we set the measured dimensions.
545         // We also wait until we set the measured dimensions before flushing the cache as well, to
546         // ensure that the cache is filled with good values.
547         invalidateCachedOffsets();
548 
549         if (childCount > 0) {
550             if (DEBUG) Log.d(TAG, "getRelativeChildOffset(): " + getMeasuredWidth() + ", "
551                     + getChildWidth(0));
552 
553             // Calculate the variable page spacing if necessary
554             if (mPageSpacing == AUTOMATIC_PAGE_SPACING) {
555                 // The gap between pages in the PagedView should be equal to the gap from the page
556                 // to the edge of the screen (so it is not visible in the current screen).  To
557                 // account for unequal padding on each side of the paged view, we take the maximum
558                 // of the left/right gap and use that as the gap between each page.
559                 int offset = getRelativeChildOffset(0);
560                 int spacing = Math.max(offset, widthSize - offset -
561                         getChildAt(0).getMeasuredWidth());
562                 setPageSpacing(spacing);
563             }
564         }
565 
566         updateScrollingIndicatorPosition();
567 
568         if (childCount > 0) {
569             mMaxScrollX = getChildOffset(childCount - 1) - getRelativeChildOffset(childCount - 1);
570         } else {
571             mMaxScrollX = 0;
572         }
573     }
574 
scrollToNewPageWithoutMovingPages(int newCurrentPage)575     protected void scrollToNewPageWithoutMovingPages(int newCurrentPage) {
576         int newX = getChildOffset(newCurrentPage) - getRelativeChildOffset(newCurrentPage);
577         int delta = newX - getScrollX();
578 
579         final int pageCount = getChildCount();
580         for (int i = 0; i < pageCount; i++) {
581             View page = (View) getPageAt(i);
582             page.setX(page.getX() + delta);
583         }
584         setCurrentPage(newCurrentPage);
585     }
586 
587     // A layout scale of 1.0f assumes that the pages, in their unshrunken state, have a
588     // scale of 1.0f. A layout scale of 0.8f assumes the pages have a scale of 0.8f, and
589     // tightens the layout accordingly
setLayoutScale(float childrenScale)590     public void setLayoutScale(float childrenScale) {
591         mLayoutScale = childrenScale;
592         invalidateCachedOffsets();
593 
594         // Now we need to do a re-layout, but preserving absolute X and Y coordinates
595         int childCount = getChildCount();
596         float childrenX[] = new float[childCount];
597         float childrenY[] = new float[childCount];
598         for (int i = 0; i < childCount; i++) {
599             final View child = getPageAt(i);
600             childrenX[i] = child.getX();
601             childrenY[i] = child.getY();
602         }
603         // Trigger a full re-layout (never just call onLayout directly!)
604         int widthSpec = MeasureSpec.makeMeasureSpec(getMeasuredWidth(), MeasureSpec.EXACTLY);
605         int heightSpec = MeasureSpec.makeMeasureSpec(getMeasuredHeight(), MeasureSpec.EXACTLY);
606         requestLayout();
607         measure(widthSpec, heightSpec);
608         layout(getLeft(), getTop(), getRight(), getBottom());
609         for (int i = 0; i < childCount; i++) {
610             final View child = getPageAt(i);
611             child.setX(childrenX[i]);
612             child.setY(childrenY[i]);
613         }
614 
615         // Also, the page offset has changed  (since the pages are now smaller);
616         // update the page offset, but again preserving absolute X and Y coordinates
617         scrollToNewPageWithoutMovingPages(mCurrentPage);
618     }
619 
setPageSpacing(int pageSpacing)620     public void setPageSpacing(int pageSpacing) {
621         mPageSpacing = pageSpacing;
622         invalidateCachedOffsets();
623     }
624 
625     @Override
onLayout(boolean changed, int left, int top, int right, int bottom)626     protected void onLayout(boolean changed, int left, int top, int right, int bottom) {
627         if (!mIsDataReady) {
628             return;
629         }
630 
631         if (DEBUG) Log.d(TAG, "PagedView.onLayout()");
632         final int verticalPadding = getPaddingTop() + getPaddingBottom();
633         final int childCount = getChildCount();
634         int childLeft = getRelativeChildOffset(0);
635 
636         for (int i = 0; i < childCount; i++) {
637             final View child = getPageAt(i);
638             if (child.getVisibility() != View.GONE) {
639                 final int childWidth = getScaledMeasuredWidth(child);
640                 final int childHeight = child.getMeasuredHeight();
641                 int childTop = getPaddingTop();
642                 if (mCenterPagesVertically) {
643                     childTop += ((getMeasuredHeight() - verticalPadding) - childHeight) / 2;
644                 }
645 
646                 if (DEBUG) Log.d(TAG, "\tlayout-child" + i + ": " + childLeft + ", " + childTop);
647                 child.layout(childLeft, childTop,
648                         childLeft + child.getMeasuredWidth(), childTop + childHeight);
649                 childLeft += childWidth + mPageSpacing;
650             }
651         }
652 
653         if (mFirstLayout && mCurrentPage >= 0 && mCurrentPage < getChildCount()) {
654             setHorizontalScrollBarEnabled(false);
655             updateCurrentPageScroll();
656             setHorizontalScrollBarEnabled(true);
657             mFirstLayout = false;
658         }
659     }
660 
screenScrolled(int screenCenter)661     protected void screenScrolled(int screenCenter) {
662         if (isScrollingIndicatorEnabled()) {
663             updateScrollingIndicator();
664         }
665         boolean isInOverscroll = mOverScrollX < 0 || mOverScrollX > mMaxScrollX;
666 
667         if (mFadeInAdjacentScreens && !isInOverscroll) {
668             for (int i = 0; i < getChildCount(); i++) {
669                 View child = getChildAt(i);
670                 if (child != null) {
671                     float scrollProgress = getScrollProgress(screenCenter, child, i);
672                     float alpha = 1 - Math.abs(scrollProgress);
673                     child.setAlpha(alpha);
674                 }
675             }
676             invalidate();
677         }
678     }
679 
680     @Override
onChildViewAdded(View parent, View child)681     public void onChildViewAdded(View parent, View child) {
682         // This ensures that when children are added, they get the correct transforms / alphas
683         // in accordance with any scroll effects.
684         mForceScreenScrolled = true;
685         invalidate();
686         invalidateCachedOffsets();
687     }
688 
689     @Override
onChildViewRemoved(View parent, View child)690     public void onChildViewRemoved(View parent, View child) {
691     }
692 
invalidateCachedOffsets()693     protected void invalidateCachedOffsets() {
694         int count = getChildCount();
695         if (count == 0) {
696             mChildOffsets = null;
697             mChildRelativeOffsets = null;
698             mChildOffsetsWithLayoutScale = null;
699             return;
700         }
701 
702         mChildOffsets = new int[count];
703         mChildRelativeOffsets = new int[count];
704         mChildOffsetsWithLayoutScale = new int[count];
705         for (int i = 0; i < count; i++) {
706             mChildOffsets[i] = -1;
707             mChildRelativeOffsets[i] = -1;
708             mChildOffsetsWithLayoutScale[i] = -1;
709         }
710     }
711 
getChildOffset(int index)712     protected int getChildOffset(int index) {
713         int[] childOffsets = Float.compare(mLayoutScale, 1f) == 0 ?
714                 mChildOffsets : mChildOffsetsWithLayoutScale;
715 
716         if (childOffsets != null && childOffsets[index] != -1) {
717             return childOffsets[index];
718         } else {
719             if (getChildCount() == 0)
720                 return 0;
721 
722             int offset = getRelativeChildOffset(0);
723             for (int i = 0; i < index; ++i) {
724                 offset += getScaledMeasuredWidth(getPageAt(i)) + mPageSpacing;
725             }
726             if (childOffsets != null) {
727                 childOffsets[index] = offset;
728             }
729             return offset;
730         }
731     }
732 
getRelativeChildOffset(int index)733     protected int getRelativeChildOffset(int index) {
734         if (mChildRelativeOffsets != null && mChildRelativeOffsets[index] != -1) {
735             return mChildRelativeOffsets[index];
736         } else {
737             final int padding = getPaddingLeft() + getPaddingRight();
738             final int offset = getPaddingLeft() +
739                     (getMeasuredWidth() - padding - getChildWidth(index)) / 2;
740             if (mChildRelativeOffsets != null) {
741                 mChildRelativeOffsets[index] = offset;
742             }
743             return offset;
744         }
745     }
746 
getScaledMeasuredWidth(View child)747     protected int getScaledMeasuredWidth(View child) {
748         // This functions are called enough times that it actually makes a difference in the
749         // profiler -- so just inline the max() here
750         final int measuredWidth = child.getMeasuredWidth();
751         final int minWidth = mMinimumWidth;
752         final int maxWidth = (minWidth > measuredWidth) ? minWidth : measuredWidth;
753         return (int) (maxWidth * mLayoutScale + 0.5f);
754     }
755 
getVisiblePages(int[] range)756     protected void getVisiblePages(int[] range) {
757         final int pageCount = getChildCount();
758 
759         if (pageCount > 0) {
760             final int screenWidth = getMeasuredWidth();
761             int leftScreen = 0;
762             int rightScreen = 0;
763             View currPage = getPageAt(leftScreen);
764             while (leftScreen < pageCount - 1 &&
765                     currPage.getX() + currPage.getWidth() -
766                     currPage.getPaddingRight() < getScrollX()) {
767                 leftScreen++;
768                 currPage = getPageAt(leftScreen);
769             }
770             rightScreen = leftScreen;
771             currPage = getPageAt(rightScreen + 1);
772             while (rightScreen < pageCount - 1 &&
773                     currPage.getX() - currPage.getPaddingLeft() < getScrollX() + screenWidth) {
774                 rightScreen++;
775                 currPage = getPageAt(rightScreen + 1);
776             }
777             range[0] = leftScreen;
778             range[1] = rightScreen;
779         } else {
780             range[0] = -1;
781             range[1] = -1;
782         }
783     }
784 
shouldDrawChild(View child)785     protected boolean shouldDrawChild(View child) {
786         return child.getAlpha() > 0;
787     }
788 
789     @Override
dispatchDraw(Canvas canvas)790     protected void dispatchDraw(Canvas canvas) {
791         int halfScreenSize = getMeasuredWidth() / 2;
792         // mOverScrollX is equal to getScrollX() when we're within the normal scroll range.
793         // Otherwise it is equal to the scaled overscroll position.
794         int screenCenter = mOverScrollX + halfScreenSize;
795 
796         if (screenCenter != mLastScreenCenter || mForceScreenScrolled) {
797             // set mForceScreenScrolled before calling screenScrolled so that screenScrolled can
798             // set it for the next frame
799             mForceScreenScrolled = false;
800             screenScrolled(screenCenter);
801             mLastScreenCenter = screenCenter;
802         }
803 
804         // Find out which screens are visible; as an optimization we only call draw on them
805         final int pageCount = getChildCount();
806         if (pageCount > 0) {
807             getVisiblePages(mTempVisiblePagesRange);
808             final int leftScreen = mTempVisiblePagesRange[0];
809             final int rightScreen = mTempVisiblePagesRange[1];
810             if (leftScreen != -1 && rightScreen != -1) {
811                 final long drawingTime = getDrawingTime();
812                 // Clip to the bounds
813                 canvas.save();
814                 canvas.clipRect(getScrollX(), getScrollY(), getScrollX() + getRight() - getLeft(),
815                         getScrollY() + getBottom() - getTop());
816 
817                 for (int i = getChildCount() - 1; i >= 0; i--) {
818                     final View v = getPageAt(i);
819                     if (mForceDrawAllChildrenNextFrame ||
820                                (leftScreen <= i && i <= rightScreen && shouldDrawChild(v))) {
821                         drawChild(canvas, v, drawingTime);
822                     }
823                 }
824                 mForceDrawAllChildrenNextFrame = false;
825                 canvas.restore();
826             }
827         }
828     }
829 
830     @Override
requestChildRectangleOnScreen(View child, Rect rectangle, boolean immediate)831     public boolean requestChildRectangleOnScreen(View child, Rect rectangle, boolean immediate) {
832         int page = indexToPage(indexOfChild(child));
833         if (page != mCurrentPage || !mScroller.isFinished()) {
834             snapToPage(page);
835             return true;
836         }
837         return false;
838     }
839 
840     @Override
onRequestFocusInDescendants(int direction, Rect previouslyFocusedRect)841     protected boolean onRequestFocusInDescendants(int direction, Rect previouslyFocusedRect) {
842         int focusablePage;
843         if (mNextPage != INVALID_PAGE) {
844             focusablePage = mNextPage;
845         } else {
846             focusablePage = mCurrentPage;
847         }
848         View v = getPageAt(focusablePage);
849         if (v != null) {
850             return v.requestFocus(direction, previouslyFocusedRect);
851         }
852         return false;
853     }
854 
855     @Override
dispatchUnhandledMove(View focused, int direction)856     public boolean dispatchUnhandledMove(View focused, int direction) {
857         if (direction == View.FOCUS_LEFT) {
858             if (getCurrentPage() > 0) {
859                 snapToPage(getCurrentPage() - 1);
860                 return true;
861             }
862         } else if (direction == View.FOCUS_RIGHT) {
863             if (getCurrentPage() < getPageCount() - 1) {
864                 snapToPage(getCurrentPage() + 1);
865                 return true;
866             }
867         }
868         return super.dispatchUnhandledMove(focused, direction);
869     }
870 
871     @Override
addFocusables(ArrayList<View> views, int direction, int focusableMode)872     public void addFocusables(ArrayList<View> views, int direction, int focusableMode) {
873         if (mCurrentPage >= 0 && mCurrentPage < getPageCount()) {
874             getPageAt(mCurrentPage).addFocusables(views, direction, focusableMode);
875         }
876         if (direction == View.FOCUS_LEFT) {
877             if (mCurrentPage > 0) {
878                 getPageAt(mCurrentPage - 1).addFocusables(views, direction, focusableMode);
879             }
880         } else if (direction == View.FOCUS_RIGHT){
881             if (mCurrentPage < getPageCount() - 1) {
882                 getPageAt(mCurrentPage + 1).addFocusables(views, direction, focusableMode);
883             }
884         }
885     }
886 
887     /**
888      * If one of our descendant views decides that it could be focused now, only
889      * pass that along if it's on the current page.
890      *
891      * This happens when live folders requery, and if they're off page, they
892      * end up calling requestFocus, which pulls it on page.
893      */
894     @Override
focusableViewAvailable(View focused)895     public void focusableViewAvailable(View focused) {
896         View current = getPageAt(mCurrentPage);
897         View v = focused;
898         while (true) {
899             if (v == current) {
900                 super.focusableViewAvailable(focused);
901                 return;
902             }
903             if (v == this) {
904                 return;
905             }
906             ViewParent parent = v.getParent();
907             if (parent instanceof View) {
908                 v = (View)v.getParent();
909             } else {
910                 return;
911             }
912         }
913     }
914 
915     /**
916      * {@inheritDoc}
917      */
918     @Override
requestDisallowInterceptTouchEvent(boolean disallowIntercept)919     public void requestDisallowInterceptTouchEvent(boolean disallowIntercept) {
920         if (disallowIntercept) {
921             // We need to make sure to cancel our long press if
922             // a scrollable widget takes over touch events
923             final View currentPage = getPageAt(mCurrentPage);
924             currentPage.cancelLongPress();
925         }
926         super.requestDisallowInterceptTouchEvent(disallowIntercept);
927     }
928 
929     /**
930      * Return true if a tap at (x, y) should trigger a flip to the previous page.
931      */
hitsPreviousPage(float x, float y)932     protected boolean hitsPreviousPage(float x, float y) {
933         return (x < getRelativeChildOffset(mCurrentPage) - mPageSpacing);
934     }
935 
936     /**
937      * Return true if a tap at (x, y) should trigger a flip to the next page.
938      */
hitsNextPage(float x, float y)939     protected boolean hitsNextPage(float x, float y) {
940         return  (x > (getMeasuredWidth() - getRelativeChildOffset(mCurrentPage) + mPageSpacing));
941     }
942 
943     @Override
onInterceptTouchEvent(MotionEvent ev)944     public boolean onInterceptTouchEvent(MotionEvent ev) {
945         /*
946          * This method JUST determines whether we want to intercept the motion.
947          * If we return true, onTouchEvent will be called and we do the actual
948          * scrolling there.
949          */
950         acquireVelocityTrackerAndAddMovement(ev);
951 
952         // Skip touch handling if there are no pages to swipe
953         if (getChildCount() <= 0) return super.onInterceptTouchEvent(ev);
954 
955         /*
956          * Shortcut the most recurring case: the user is in the dragging
957          * state and he is moving his finger.  We want to intercept this
958          * motion.
959          */
960         final int action = ev.getAction();
961         if ((action == MotionEvent.ACTION_MOVE) &&
962                 (mTouchState == TOUCH_STATE_SCROLLING)) {
963             return true;
964         }
965 
966         switch (action & MotionEvent.ACTION_MASK) {
967             case MotionEvent.ACTION_MOVE: {
968                 /*
969                  * mIsBeingDragged == false, otherwise the shortcut would have caught it. Check
970                  * whether the user has moved far enough from his original down touch.
971                  */
972                 if (mActivePointerId != INVALID_POINTER) {
973                     determineScrollingStart(ev);
974                     break;
975                 }
976                 // if mActivePointerId is INVALID_POINTER, then we must have missed an ACTION_DOWN
977                 // event. in that case, treat the first occurence of a move event as a ACTION_DOWN
978                 // i.e. fall through to the next case (don't break)
979                 // (We sometimes miss ACTION_DOWN events in Workspace because it ignores all events
980                 // while it's small- this was causing a crash before we checked for INVALID_POINTER)
981             }
982 
983             case MotionEvent.ACTION_DOWN: {
984                 final float x = ev.getX();
985                 final float y = ev.getY();
986                 // Remember location of down touch
987                 mDownMotionX = x;
988                 mLastMotionX = x;
989                 mLastMotionY = y;
990                 mLastMotionXRemainder = 0;
991                 mTotalMotionX = 0;
992                 mActivePointerId = ev.getPointerId(0);
993                 mAllowLongPress = true;
994 
995                 /*
996                  * If being flinged and user touches the screen, initiate drag;
997                  * otherwise don't.  mScroller.isFinished should be false when
998                  * being flinged.
999                  */
1000                 final int xDist = Math.abs(mScroller.getFinalX() - mScroller.getCurrX());
1001                 final boolean finishedScrolling = (mScroller.isFinished() || xDist < mTouchSlop);
1002                 if (finishedScrolling) {
1003                     mTouchState = TOUCH_STATE_REST;
1004                     mScroller.abortAnimation();
1005                 } else {
1006                     mTouchState = TOUCH_STATE_SCROLLING;
1007                 }
1008 
1009                 // check if this can be the beginning of a tap on the side of the pages
1010                 // to scroll the current page
1011                 if (mTouchState != TOUCH_STATE_PREV_PAGE && mTouchState != TOUCH_STATE_NEXT_PAGE) {
1012                     if (getChildCount() > 0) {
1013                         if (hitsPreviousPage(x, y)) {
1014                             mTouchState = TOUCH_STATE_PREV_PAGE;
1015                         } else if (hitsNextPage(x, y)) {
1016                             mTouchState = TOUCH_STATE_NEXT_PAGE;
1017                         }
1018                     }
1019                 }
1020                 break;
1021             }
1022 
1023             case MotionEvent.ACTION_UP:
1024             case MotionEvent.ACTION_CANCEL:
1025                 mTouchState = TOUCH_STATE_REST;
1026                 mAllowLongPress = false;
1027                 mActivePointerId = INVALID_POINTER;
1028                 releaseVelocityTracker();
1029                 break;
1030 
1031             case MotionEvent.ACTION_POINTER_UP:
1032                 onSecondaryPointerUp(ev);
1033                 releaseVelocityTracker();
1034                 break;
1035         }
1036 
1037         /*
1038          * The only time we want to intercept motion events is if we are in the
1039          * drag mode.
1040          */
1041         return mTouchState != TOUCH_STATE_REST;
1042     }
1043 
determineScrollingStart(MotionEvent ev)1044     protected void determineScrollingStart(MotionEvent ev) {
1045         determineScrollingStart(ev, 1.0f);
1046     }
1047 
1048     /*
1049      * Determines if we should change the touch state to start scrolling after the
1050      * user moves their touch point too far.
1051      */
determineScrollingStart(MotionEvent ev, float touchSlopScale)1052     protected void determineScrollingStart(MotionEvent ev, float touchSlopScale) {
1053         /*
1054          * Locally do absolute value. mLastMotionX is set to the y value
1055          * of the down event.
1056          */
1057         final int pointerIndex = ev.findPointerIndex(mActivePointerId);
1058         if (pointerIndex == -1) {
1059             return;
1060         }
1061         final float x = ev.getX(pointerIndex);
1062         final float y = ev.getY(pointerIndex);
1063         final int xDiff = (int) Math.abs(x - mLastMotionX);
1064         final int yDiff = (int) Math.abs(y - mLastMotionY);
1065 
1066         final int touchSlop = Math.round(touchSlopScale * mTouchSlop);
1067         boolean xPaged = xDiff > mPagingTouchSlop;
1068         boolean xMoved = xDiff > touchSlop;
1069         boolean yMoved = yDiff > touchSlop;
1070 
1071         if (xMoved || xPaged || yMoved) {
1072             if (mUsePagingTouchSlop ? xPaged : xMoved) {
1073                 // Scroll if the user moved far enough along the X axis
1074                 mTouchState = TOUCH_STATE_SCROLLING;
1075                 mTotalMotionX += Math.abs(mLastMotionX - x);
1076                 mLastMotionX = x;
1077                 mLastMotionXRemainder = 0;
1078                 mTouchX = getScrollX();
1079                 mSmoothingTime = System.nanoTime() / NANOTIME_DIV;
1080                 pageBeginMoving();
1081             }
1082             // Either way, cancel any pending longpress
1083             cancelCurrentPageLongPress();
1084         }
1085     }
1086 
cancelCurrentPageLongPress()1087     protected void cancelCurrentPageLongPress() {
1088         if (mAllowLongPress) {
1089             mAllowLongPress = false;
1090             // Try canceling the long press. It could also have been scheduled
1091             // by a distant descendant, so use the mAllowLongPress flag to block
1092             // everything
1093             final View currentPage = getPageAt(mCurrentPage);
1094             if (currentPage != null) {
1095                 currentPage.cancelLongPress();
1096             }
1097         }
1098     }
1099 
getScrollProgress(int screenCenter, View v, int page)1100     protected float getScrollProgress(int screenCenter, View v, int page) {
1101         final int halfScreenSize = getMeasuredWidth() / 2;
1102 
1103         int totalDistance = getScaledMeasuredWidth(v) + mPageSpacing;
1104         int delta = screenCenter - (getChildOffset(page) -
1105                 getRelativeChildOffset(page) + halfScreenSize);
1106 
1107         float scrollProgress = delta / (totalDistance * 1.0f);
1108         scrollProgress = Math.min(scrollProgress, 1.0f);
1109         scrollProgress = Math.max(scrollProgress, -1.0f);
1110         return scrollProgress;
1111     }
1112 
1113     // This curve determines how the effect of scrolling over the limits of the page dimishes
1114     // as the user pulls further and further from the bounds
overScrollInfluenceCurve(float f)1115     private float overScrollInfluenceCurve(float f) {
1116         f -= 1.0f;
1117         return f * f * f + 1.0f;
1118     }
1119 
acceleratedOverScroll(float amount)1120     protected void acceleratedOverScroll(float amount) {
1121         int screenSize = getMeasuredWidth();
1122 
1123         // We want to reach the max over scroll effect when the user has
1124         // over scrolled half the size of the screen
1125         float f = OVERSCROLL_ACCELERATE_FACTOR * (amount / screenSize);
1126 
1127         if (f == 0) return;
1128 
1129         // Clamp this factor, f, to -1 < f < 1
1130         if (Math.abs(f) >= 1) {
1131             f /= Math.abs(f);
1132         }
1133 
1134         int overScrollAmount = (int) Math.round(f * screenSize);
1135         if (amount < 0) {
1136             mOverScrollX = overScrollAmount;
1137             super.scrollTo(0, getScrollY());
1138         } else {
1139             mOverScrollX = mMaxScrollX + overScrollAmount;
1140             super.scrollTo(mMaxScrollX, getScrollY());
1141         }
1142         invalidate();
1143     }
1144 
dampedOverScroll(float amount)1145     protected void dampedOverScroll(float amount) {
1146         int screenSize = getMeasuredWidth();
1147 
1148         float f = (amount / screenSize);
1149 
1150         if (f == 0) return;
1151         f = f / (Math.abs(f)) * (overScrollInfluenceCurve(Math.abs(f)));
1152 
1153         // Clamp this factor, f, to -1 < f < 1
1154         if (Math.abs(f) >= 1) {
1155             f /= Math.abs(f);
1156         }
1157 
1158         int overScrollAmount = (int) Math.round(OVERSCROLL_DAMP_FACTOR * f * screenSize);
1159         if (amount < 0) {
1160             mOverScrollX = overScrollAmount;
1161             super.scrollTo(0, getScrollY());
1162         } else {
1163             mOverScrollX = mMaxScrollX + overScrollAmount;
1164             super.scrollTo(mMaxScrollX, getScrollY());
1165         }
1166         invalidate();
1167     }
1168 
overScroll(float amount)1169     protected void overScroll(float amount) {
1170         dampedOverScroll(amount);
1171     }
1172 
maxOverScroll()1173     protected float maxOverScroll() {
1174         // Using the formula in overScroll, assuming that f = 1.0 (which it should generally not
1175         // exceed). Used to find out how much extra wallpaper we need for the over scroll effect
1176         float f = 1.0f;
1177         f = f / (Math.abs(f)) * (overScrollInfluenceCurve(Math.abs(f)));
1178         return OVERSCROLL_DAMP_FACTOR * f;
1179     }
1180 
1181     @Override
onTouchEvent(MotionEvent ev)1182     public boolean onTouchEvent(MotionEvent ev) {
1183         // Skip touch handling if there are no pages to swipe
1184         if (getChildCount() <= 0) return super.onTouchEvent(ev);
1185 
1186         acquireVelocityTrackerAndAddMovement(ev);
1187 
1188         final int action = ev.getAction();
1189 
1190         switch (action & MotionEvent.ACTION_MASK) {
1191         case MotionEvent.ACTION_DOWN:
1192             /*
1193              * If being flinged and user touches, stop the fling. isFinished
1194              * will be false if being flinged.
1195              */
1196             if (!mScroller.isFinished()) {
1197                 mScroller.abortAnimation();
1198             }
1199 
1200             // Remember where the motion event started
1201             mDownMotionX = mLastMotionX = ev.getX();
1202             mLastMotionXRemainder = 0;
1203             mTotalMotionX = 0;
1204             mActivePointerId = ev.getPointerId(0);
1205             if (mTouchState == TOUCH_STATE_SCROLLING) {
1206                 pageBeginMoving();
1207             }
1208             break;
1209 
1210         case MotionEvent.ACTION_MOVE:
1211             if (mTouchState == TOUCH_STATE_SCROLLING) {
1212                 // Scroll to follow the motion event
1213                 final int pointerIndex = ev.findPointerIndex(mActivePointerId);
1214                 final float x = ev.getX(pointerIndex);
1215                 final float deltaX = mLastMotionX + mLastMotionXRemainder - x;
1216 
1217                 mTotalMotionX += Math.abs(deltaX);
1218 
1219                 // Only scroll and update mLastMotionX if we have moved some discrete amount.  We
1220                 // keep the remainder because we are actually testing if we've moved from the last
1221                 // scrolled position (which is discrete).
1222                 if (Math.abs(deltaX) >= 1.0f) {
1223                     mTouchX += deltaX;
1224                     mSmoothingTime = System.nanoTime() / NANOTIME_DIV;
1225                     if (!mDeferScrollUpdate) {
1226                         scrollBy((int) deltaX, 0);
1227                         if (DEBUG) Log.d(TAG, "onTouchEvent().Scrolling: " + deltaX);
1228                     } else {
1229                         invalidate();
1230                     }
1231                     mLastMotionX = x;
1232                     mLastMotionXRemainder = deltaX - (int) deltaX;
1233                 } else {
1234                     awakenScrollBars();
1235                 }
1236             } else {
1237                 determineScrollingStart(ev);
1238             }
1239             break;
1240 
1241         case MotionEvent.ACTION_UP:
1242             if (mTouchState == TOUCH_STATE_SCROLLING) {
1243                 final int activePointerId = mActivePointerId;
1244                 final int pointerIndex = ev.findPointerIndex(activePointerId);
1245                 final float x = ev.getX(pointerIndex);
1246                 final VelocityTracker velocityTracker = mVelocityTracker;
1247                 velocityTracker.computeCurrentVelocity(1000, mMaximumVelocity);
1248                 int velocityX = (int) velocityTracker.getXVelocity(activePointerId);
1249                 final int deltaX = (int) (x - mDownMotionX);
1250                 final int pageWidth = getScaledMeasuredWidth(getPageAt(mCurrentPage));
1251                 boolean isSignificantMove = Math.abs(deltaX) > pageWidth *
1252                         SIGNIFICANT_MOVE_THRESHOLD;
1253 
1254                 mTotalMotionX += Math.abs(mLastMotionX + mLastMotionXRemainder - x);
1255 
1256                 boolean isFling = mTotalMotionX > MIN_LENGTH_FOR_FLING &&
1257                         Math.abs(velocityX) > mFlingThresholdVelocity;
1258 
1259                 // In the case that the page is moved far to one direction and then is flung
1260                 // in the opposite direction, we use a threshold to determine whether we should
1261                 // just return to the starting page, or if we should skip one further.
1262                 boolean returnToOriginalPage = false;
1263                 if (Math.abs(deltaX) > pageWidth * RETURN_TO_ORIGINAL_PAGE_THRESHOLD &&
1264                         Math.signum(velocityX) != Math.signum(deltaX) && isFling) {
1265                     returnToOriginalPage = true;
1266                 }
1267 
1268                 int finalPage;
1269                 // We give flings precedence over large moves, which is why we short-circuit our
1270                 // test for a large move if a fling has been registered. That is, a large
1271                 // move to the left and fling to the right will register as a fling to the right.
1272                 if (((isSignificantMove && deltaX > 0 && !isFling) ||
1273                         (isFling && velocityX > 0)) && mCurrentPage > 0) {
1274                     finalPage = returnToOriginalPage ? mCurrentPage : mCurrentPage - 1;
1275                     snapToPageWithVelocity(finalPage, velocityX);
1276                 } else if (((isSignificantMove && deltaX < 0 && !isFling) ||
1277                         (isFling && velocityX < 0)) &&
1278                         mCurrentPage < getChildCount() - 1) {
1279                     finalPage = returnToOriginalPage ? mCurrentPage : mCurrentPage + 1;
1280                     snapToPageWithVelocity(finalPage, velocityX);
1281                 } else {
1282                     snapToDestination();
1283                 }
1284             } else if (mTouchState == TOUCH_STATE_PREV_PAGE) {
1285                 // at this point we have not moved beyond the touch slop
1286                 // (otherwise mTouchState would be TOUCH_STATE_SCROLLING), so
1287                 // we can just page
1288                 int nextPage = Math.max(0, mCurrentPage - 1);
1289                 if (nextPage != mCurrentPage) {
1290                     snapToPage(nextPage);
1291                 } else {
1292                     snapToDestination();
1293                 }
1294             } else if (mTouchState == TOUCH_STATE_NEXT_PAGE) {
1295                 // at this point we have not moved beyond the touch slop
1296                 // (otherwise mTouchState would be TOUCH_STATE_SCROLLING), so
1297                 // we can just page
1298                 int nextPage = Math.min(getChildCount() - 1, mCurrentPage + 1);
1299                 if (nextPage != mCurrentPage) {
1300                     snapToPage(nextPage);
1301                 } else {
1302                     snapToDestination();
1303                 }
1304             } else {
1305                 onUnhandledTap(ev);
1306             }
1307             mTouchState = TOUCH_STATE_REST;
1308             mActivePointerId = INVALID_POINTER;
1309             releaseVelocityTracker();
1310             break;
1311 
1312         case MotionEvent.ACTION_CANCEL:
1313             if (mTouchState == TOUCH_STATE_SCROLLING) {
1314                 snapToDestination();
1315             }
1316             mTouchState = TOUCH_STATE_REST;
1317             mActivePointerId = INVALID_POINTER;
1318             releaseVelocityTracker();
1319             break;
1320 
1321         case MotionEvent.ACTION_POINTER_UP:
1322             onSecondaryPointerUp(ev);
1323             break;
1324         }
1325 
1326         return true;
1327     }
1328 
1329     @Override
onGenericMotionEvent(MotionEvent event)1330     public boolean onGenericMotionEvent(MotionEvent event) {
1331         if ((event.getSource() & InputDevice.SOURCE_CLASS_POINTER) != 0) {
1332             switch (event.getAction()) {
1333                 case MotionEvent.ACTION_SCROLL: {
1334                     // Handle mouse (or ext. device) by shifting the page depending on the scroll
1335                     final float vscroll;
1336                     final float hscroll;
1337                     if ((event.getMetaState() & KeyEvent.META_SHIFT_ON) != 0) {
1338                         vscroll = 0;
1339                         hscroll = event.getAxisValue(MotionEvent.AXIS_VSCROLL);
1340                     } else {
1341                         vscroll = -event.getAxisValue(MotionEvent.AXIS_VSCROLL);
1342                         hscroll = event.getAxisValue(MotionEvent.AXIS_HSCROLL);
1343                     }
1344                     if (hscroll != 0 || vscroll != 0) {
1345                         if (hscroll > 0 || vscroll > 0) {
1346                             scrollRight();
1347                         } else {
1348                             scrollLeft();
1349                         }
1350                         return true;
1351                     }
1352                 }
1353             }
1354         }
1355         return super.onGenericMotionEvent(event);
1356     }
1357 
acquireVelocityTrackerAndAddMovement(MotionEvent ev)1358     private void acquireVelocityTrackerAndAddMovement(MotionEvent ev) {
1359         if (mVelocityTracker == null) {
1360             mVelocityTracker = VelocityTracker.obtain();
1361         }
1362         mVelocityTracker.addMovement(ev);
1363     }
1364 
releaseVelocityTracker()1365     private void releaseVelocityTracker() {
1366         if (mVelocityTracker != null) {
1367             mVelocityTracker.recycle();
1368             mVelocityTracker = null;
1369         }
1370     }
1371 
onSecondaryPointerUp(MotionEvent ev)1372     private void onSecondaryPointerUp(MotionEvent ev) {
1373         final int pointerIndex = (ev.getAction() & MotionEvent.ACTION_POINTER_INDEX_MASK) >>
1374                 MotionEvent.ACTION_POINTER_INDEX_SHIFT;
1375         final int pointerId = ev.getPointerId(pointerIndex);
1376         if (pointerId == mActivePointerId) {
1377             // This was our active pointer going up. Choose a new
1378             // active pointer and adjust accordingly.
1379             // TODO: Make this decision more intelligent.
1380             final int newPointerIndex = pointerIndex == 0 ? 1 : 0;
1381             mLastMotionX = mDownMotionX = ev.getX(newPointerIndex);
1382             mLastMotionY = ev.getY(newPointerIndex);
1383             mLastMotionXRemainder = 0;
1384             mActivePointerId = ev.getPointerId(newPointerIndex);
1385             if (mVelocityTracker != null) {
1386                 mVelocityTracker.clear();
1387             }
1388         }
1389     }
1390 
onUnhandledTap(MotionEvent ev)1391     protected void onUnhandledTap(MotionEvent ev) {}
1392 
1393     @Override
requestChildFocus(View child, View focused)1394     public void requestChildFocus(View child, View focused) {
1395         super.requestChildFocus(child, focused);
1396         int page = indexToPage(indexOfChild(child));
1397         if (page >= 0 && page != getCurrentPage() && !isInTouchMode()) {
1398             snapToPage(page);
1399         }
1400     }
1401 
getChildIndexForRelativeOffset(int relativeOffset)1402     protected int getChildIndexForRelativeOffset(int relativeOffset) {
1403         final int childCount = getChildCount();
1404         int left;
1405         int right;
1406         for (int i = 0; i < childCount; ++i) {
1407             left = getRelativeChildOffset(i);
1408             right = (left + getScaledMeasuredWidth(getPageAt(i)));
1409             if (left <= relativeOffset && relativeOffset <= right) {
1410                 return i;
1411             }
1412         }
1413         return -1;
1414     }
1415 
getChildWidth(int index)1416     protected int getChildWidth(int index) {
1417         // This functions are called enough times that it actually makes a difference in the
1418         // profiler -- so just inline the max() here
1419         final int measuredWidth = getPageAt(index).getMeasuredWidth();
1420         final int minWidth = mMinimumWidth;
1421         return (minWidth > measuredWidth) ? minWidth : measuredWidth;
1422     }
1423 
getPageNearestToCenterOfScreen()1424     int getPageNearestToCenterOfScreen() {
1425         int minDistanceFromScreenCenter = Integer.MAX_VALUE;
1426         int minDistanceFromScreenCenterIndex = -1;
1427         int screenCenter = getScrollX() + (getMeasuredWidth() / 2);
1428         final int childCount = getChildCount();
1429         for (int i = 0; i < childCount; ++i) {
1430             View layout = (View) getPageAt(i);
1431             int childWidth = getScaledMeasuredWidth(layout);
1432             int halfChildWidth = (childWidth / 2);
1433             int childCenter = getChildOffset(i) + halfChildWidth;
1434             int distanceFromScreenCenter = Math.abs(childCenter - screenCenter);
1435             if (distanceFromScreenCenter < minDistanceFromScreenCenter) {
1436                 minDistanceFromScreenCenter = distanceFromScreenCenter;
1437                 minDistanceFromScreenCenterIndex = i;
1438             }
1439         }
1440         return minDistanceFromScreenCenterIndex;
1441     }
1442 
snapToDestination()1443     protected void snapToDestination() {
1444         snapToPage(getPageNearestToCenterOfScreen(), PAGE_SNAP_ANIMATION_DURATION);
1445     }
1446 
1447     private static class ScrollInterpolator implements Interpolator {
ScrollInterpolator()1448         public ScrollInterpolator() {
1449         }
1450 
getInterpolation(float t)1451         public float getInterpolation(float t) {
1452             t -= 1.0f;
1453             return t*t*t*t*t + 1;
1454         }
1455     }
1456 
1457     // We want the duration of the page snap animation to be influenced by the distance that
1458     // the screen has to travel, however, we don't want this duration to be effected in a
1459     // purely linear fashion. Instead, we use this method to moderate the effect that the distance
1460     // of travel has on the overall snap duration.
distanceInfluenceForSnapDuration(float f)1461     float distanceInfluenceForSnapDuration(float f) {
1462         f -= 0.5f; // center the values about 0.
1463         f *= 0.3f * Math.PI / 2.0f;
1464         return (float) Math.sin(f);
1465     }
1466 
snapToPageWithVelocity(int whichPage, int velocity)1467     protected void snapToPageWithVelocity(int whichPage, int velocity) {
1468         whichPage = Math.max(0, Math.min(whichPage, getChildCount() - 1));
1469         int halfScreenSize = getMeasuredWidth() / 2;
1470 
1471         if (DEBUG) Log.d(TAG, "snapToPage.getChildOffset(): " + getChildOffset(whichPage));
1472         if (DEBUG) Log.d(TAG, "snapToPageWithVelocity.getRelativeChildOffset(): "
1473                 + getMeasuredWidth() + ", " + getChildWidth(whichPage));
1474         final int newX = getChildOffset(whichPage) - getRelativeChildOffset(whichPage);
1475         int delta = newX - mUnboundedScrollX;
1476         int duration = 0;
1477 
1478         if (Math.abs(velocity) < mMinFlingVelocity) {
1479             // If the velocity is low enough, then treat this more as an automatic page advance
1480             // as opposed to an apparent physical response to flinging
1481             snapToPage(whichPage, PAGE_SNAP_ANIMATION_DURATION);
1482             return;
1483         }
1484 
1485         // Here we compute a "distance" that will be used in the computation of the overall
1486         // snap duration. This is a function of the actual distance that needs to be traveled;
1487         // we keep this value close to half screen size in order to reduce the variance in snap
1488         // duration as a function of the distance the page needs to travel.
1489         float distanceRatio = Math.min(1f, 1.0f * Math.abs(delta) / (2 * halfScreenSize));
1490         float distance = halfScreenSize + halfScreenSize *
1491                 distanceInfluenceForSnapDuration(distanceRatio);
1492 
1493         velocity = Math.abs(velocity);
1494         velocity = Math.max(mMinSnapVelocity, velocity);
1495 
1496         // we want the page's snap velocity to approximately match the velocity at which the
1497         // user flings, so we scale the duration by a value near to the derivative of the scroll
1498         // interpolator at zero, ie. 5. We use 4 to make it a little slower.
1499         duration = 4 * Math.round(1000 * Math.abs(distance / velocity));
1500         duration = Math.min(duration, MAX_PAGE_SNAP_DURATION);
1501 
1502         snapToPage(whichPage, delta, duration);
1503     }
1504 
snapToPage(int whichPage)1505     protected void snapToPage(int whichPage) {
1506         snapToPage(whichPage, PAGE_SNAP_ANIMATION_DURATION);
1507     }
1508 
snapToPage(int whichPage, int duration)1509     protected void snapToPage(int whichPage, int duration) {
1510         whichPage = Math.max(0, Math.min(whichPage, getPageCount() - 1));
1511 
1512         if (DEBUG) Log.d(TAG, "snapToPage.getChildOffset(): " + getChildOffset(whichPage));
1513         if (DEBUG) Log.d(TAG, "snapToPage.getRelativeChildOffset(): " + getMeasuredWidth() + ", "
1514                 + getChildWidth(whichPage));
1515         int newX = getChildOffset(whichPage) - getRelativeChildOffset(whichPage);
1516         final int sX = mUnboundedScrollX;
1517         final int delta = newX - sX;
1518         snapToPage(whichPage, delta, duration);
1519     }
1520 
snapToPage(int whichPage, int delta, int duration)1521     protected void snapToPage(int whichPage, int delta, int duration) {
1522         mNextPage = whichPage;
1523 
1524         View focusedChild = getFocusedChild();
1525         if (focusedChild != null && whichPage != mCurrentPage &&
1526                 focusedChild == getPageAt(mCurrentPage)) {
1527             focusedChild.clearFocus();
1528         }
1529 
1530         pageBeginMoving();
1531         awakenScrollBars(duration);
1532         if (duration == 0) {
1533             duration = Math.abs(delta);
1534         }
1535 
1536         if (!mScroller.isFinished()) mScroller.abortAnimation();
1537         mScroller.startScroll(mUnboundedScrollX, 0, delta, 0, duration);
1538 
1539         // Load associated pages immediately if someone else is handling the scroll, otherwise defer
1540         // loading associated pages until the scroll settles
1541         if (mDeferScrollUpdate) {
1542             loadAssociatedPages(mNextPage);
1543         } else {
1544             mDeferLoadAssociatedPagesUntilScrollCompletes = true;
1545         }
1546         notifyPageSwitchListener();
1547         invalidate();
1548     }
1549 
scrollLeft()1550     public void scrollLeft() {
1551         if (mScroller.isFinished()) {
1552             if (mCurrentPage > 0) snapToPage(mCurrentPage - 1);
1553         } else {
1554             if (mNextPage > 0) snapToPage(mNextPage - 1);
1555         }
1556     }
1557 
scrollRight()1558     public void scrollRight() {
1559         if (mScroller.isFinished()) {
1560             if (mCurrentPage < getChildCount() -1) snapToPage(mCurrentPage + 1);
1561         } else {
1562             if (mNextPage < getChildCount() -1) snapToPage(mNextPage + 1);
1563         }
1564     }
1565 
getPageForView(View v)1566     public int getPageForView(View v) {
1567         int result = -1;
1568         if (v != null) {
1569             ViewParent vp = v.getParent();
1570             int count = getChildCount();
1571             for (int i = 0; i < count; i++) {
1572                 if (vp == getPageAt(i)) {
1573                     return i;
1574                 }
1575             }
1576         }
1577         return result;
1578     }
1579 
1580     /**
1581      * @return True is long presses are still allowed for the current touch
1582      */
allowLongPress()1583     public boolean allowLongPress() {
1584         return mAllowLongPress;
1585     }
1586 
1587     /**
1588      * Set true to allow long-press events to be triggered, usually checked by
1589      * {@link Launcher} to accept or block dpad-initiated long-presses.
1590      */
setAllowLongPress(boolean allowLongPress)1591     public void setAllowLongPress(boolean allowLongPress) {
1592         mAllowLongPress = allowLongPress;
1593     }
1594 
1595     public static class SavedState extends BaseSavedState {
1596         int currentPage = -1;
1597 
SavedState(Parcelable superState)1598         SavedState(Parcelable superState) {
1599             super(superState);
1600         }
1601 
SavedState(Parcel in)1602         private SavedState(Parcel in) {
1603             super(in);
1604             currentPage = in.readInt();
1605         }
1606 
1607         @Override
writeToParcel(Parcel out, int flags)1608         public void writeToParcel(Parcel out, int flags) {
1609             super.writeToParcel(out, flags);
1610             out.writeInt(currentPage);
1611         }
1612 
1613         public static final Parcelable.Creator<SavedState> CREATOR =
1614                 new Parcelable.Creator<SavedState>() {
1615             public SavedState createFromParcel(Parcel in) {
1616                 return new SavedState(in);
1617             }
1618 
1619             public SavedState[] newArray(int size) {
1620                 return new SavedState[size];
1621             }
1622         };
1623     }
1624 
loadAssociatedPages(int page)1625     protected void loadAssociatedPages(int page) {
1626         loadAssociatedPages(page, false);
1627     }
loadAssociatedPages(int page, boolean immediateAndOnly)1628     protected void loadAssociatedPages(int page, boolean immediateAndOnly) {
1629         if (mContentIsRefreshable) {
1630             final int count = getChildCount();
1631             if (page < count) {
1632                 int lowerPageBound = getAssociatedLowerPageBound(page);
1633                 int upperPageBound = getAssociatedUpperPageBound(page);
1634                 if (DEBUG) Log.d(TAG, "loadAssociatedPages: " + lowerPageBound + "/"
1635                         + upperPageBound);
1636                 // First, clear any pages that should no longer be loaded
1637                 for (int i = 0; i < count; ++i) {
1638                     Page layout = (Page) getPageAt(i);
1639                     if ((i < lowerPageBound) || (i > upperPageBound)) {
1640                         if (layout.getPageChildCount() > 0) {
1641                             layout.removeAllViewsOnPage();
1642                         }
1643                         mDirtyPageContent.set(i, true);
1644                     }
1645                 }
1646                 // Next, load any new pages
1647                 for (int i = 0; i < count; ++i) {
1648                     if ((i != page) && immediateAndOnly) {
1649                         continue;
1650                     }
1651                     if (lowerPageBound <= i && i <= upperPageBound) {
1652                         if (mDirtyPageContent.get(i)) {
1653                             syncPageItems(i, (i == page) && immediateAndOnly);
1654                             mDirtyPageContent.set(i, false);
1655                         }
1656                     }
1657                 }
1658             }
1659         }
1660     }
1661 
getAssociatedLowerPageBound(int page)1662     protected int getAssociatedLowerPageBound(int page) {
1663         return Math.max(0, page - 1);
1664     }
getAssociatedUpperPageBound(int page)1665     protected int getAssociatedUpperPageBound(int page) {
1666         final int count = getChildCount();
1667         return Math.min(page + 1, count - 1);
1668     }
1669 
1670     /**
1671      * This method is called ONLY to synchronize the number of pages that the paged view has.
1672      * To actually fill the pages with information, implement syncPageItems() below.  It is
1673      * guaranteed that syncPageItems() will be called for a particular page before it is shown,
1674      * and therefore, individual page items do not need to be updated in this method.
1675      */
syncPages()1676     public abstract void syncPages();
1677 
1678     /**
1679      * This method is called to synchronize the items that are on a particular page.  If views on
1680      * the page can be reused, then they should be updated within this method.
1681      */
syncPageItems(int page, boolean immediate)1682     public abstract void syncPageItems(int page, boolean immediate);
1683 
invalidatePageData()1684     protected void invalidatePageData() {
1685         invalidatePageData(-1, false);
1686     }
invalidatePageData(int currentPage)1687     protected void invalidatePageData(int currentPage) {
1688         invalidatePageData(currentPage, false);
1689     }
invalidatePageData(int currentPage, boolean immediateAndOnly)1690     protected void invalidatePageData(int currentPage, boolean immediateAndOnly) {
1691         if (!mIsDataReady) {
1692             return;
1693         }
1694 
1695         if (mContentIsRefreshable) {
1696             // Force all scrolling-related behavior to end
1697             mScroller.forceFinished(true);
1698             mNextPage = INVALID_PAGE;
1699 
1700             // Update all the pages
1701             syncPages();
1702 
1703             // We must force a measure after we've loaded the pages to update the content width and
1704             // to determine the full scroll width
1705             measure(MeasureSpec.makeMeasureSpec(getMeasuredWidth(), MeasureSpec.EXACTLY),
1706                     MeasureSpec.makeMeasureSpec(getMeasuredHeight(), MeasureSpec.EXACTLY));
1707 
1708             // Set a new page as the current page if necessary
1709             if (currentPage > -1) {
1710                 setCurrentPage(Math.min(getPageCount() - 1, currentPage));
1711             }
1712 
1713             // Mark each of the pages as dirty
1714             final int count = getChildCount();
1715             mDirtyPageContent.clear();
1716             for (int i = 0; i < count; ++i) {
1717                 mDirtyPageContent.add(true);
1718             }
1719 
1720             // Load any pages that are necessary for the current window of views
1721             loadAssociatedPages(mCurrentPage, immediateAndOnly);
1722             requestLayout();
1723         }
1724     }
1725 
getScrollingIndicator()1726     protected View getScrollingIndicator() {
1727         // We use mHasScrollIndicator to prevent future lookups if there is no sibling indicator
1728         // found
1729         if (mHasScrollIndicator && mScrollIndicator == null) {
1730             ViewGroup parent = (ViewGroup) getParent();
1731             if (parent != null) {
1732                 mScrollIndicator = (View) (parent.findViewById(R.id.paged_view_indicator));
1733                 mHasScrollIndicator = mScrollIndicator != null;
1734                 if (mHasScrollIndicator) {
1735                     mScrollIndicator.setVisibility(View.VISIBLE);
1736                 }
1737             }
1738         }
1739         return mScrollIndicator;
1740     }
1741 
isScrollingIndicatorEnabled()1742     protected boolean isScrollingIndicatorEnabled() {
1743         return true;
1744     }
1745 
1746     Runnable hideScrollingIndicatorRunnable = new Runnable() {
1747         @Override
1748         public void run() {
1749             hideScrollingIndicator(false);
1750         }
1751     };
flashScrollingIndicator(boolean animated)1752     protected void flashScrollingIndicator(boolean animated) {
1753         removeCallbacks(hideScrollingIndicatorRunnable);
1754         showScrollingIndicator(!animated);
1755         postDelayed(hideScrollingIndicatorRunnable, sScrollIndicatorFlashDuration);
1756     }
1757 
showScrollingIndicator(boolean immediately)1758     protected void showScrollingIndicator(boolean immediately) {
1759         mShouldShowScrollIndicator = true;
1760         mShouldShowScrollIndicatorImmediately = true;
1761         if (getChildCount() <= 1) return;
1762         if (!isScrollingIndicatorEnabled()) return;
1763 
1764         mShouldShowScrollIndicator = false;
1765         getScrollingIndicator();
1766         if (mScrollIndicator != null) {
1767             // Fade the indicator in
1768             updateScrollingIndicatorPosition();
1769             mScrollIndicator.setVisibility(View.VISIBLE);
1770             cancelScrollingIndicatorAnimations();
1771             if (immediately || mScrollingPaused) {
1772                 mScrollIndicator.setAlpha(1f);
1773             } else {
1774                 mScrollIndicatorAnimator = LauncherAnimUtils.ofFloat(mScrollIndicator, "alpha", 1f);
1775                 mScrollIndicatorAnimator.setDuration(sScrollIndicatorFadeInDuration);
1776                 mScrollIndicatorAnimator.start();
1777             }
1778         }
1779     }
1780 
cancelScrollingIndicatorAnimations()1781     protected void cancelScrollingIndicatorAnimations() {
1782         if (mScrollIndicatorAnimator != null) {
1783             mScrollIndicatorAnimator.cancel();
1784         }
1785     }
1786 
hideScrollingIndicator(boolean immediately)1787     protected void hideScrollingIndicator(boolean immediately) {
1788         if (getChildCount() <= 1) return;
1789         if (!isScrollingIndicatorEnabled()) return;
1790 
1791         getScrollingIndicator();
1792         if (mScrollIndicator != null) {
1793             // Fade the indicator out
1794             updateScrollingIndicatorPosition();
1795             cancelScrollingIndicatorAnimations();
1796             if (immediately || mScrollingPaused) {
1797                 mScrollIndicator.setVisibility(View.INVISIBLE);
1798                 mScrollIndicator.setAlpha(0f);
1799             } else {
1800                 mScrollIndicatorAnimator = LauncherAnimUtils.ofFloat(mScrollIndicator, "alpha", 0f);
1801                 mScrollIndicatorAnimator.setDuration(sScrollIndicatorFadeOutDuration);
1802                 mScrollIndicatorAnimator.addListener(new AnimatorListenerAdapter() {
1803                     private boolean cancelled = false;
1804                     @Override
1805                     public void onAnimationCancel(android.animation.Animator animation) {
1806                         cancelled = true;
1807                     }
1808                     @Override
1809                     public void onAnimationEnd(Animator animation) {
1810                         if (!cancelled) {
1811                             mScrollIndicator.setVisibility(View.INVISIBLE);
1812                         }
1813                     }
1814                 });
1815                 mScrollIndicatorAnimator.start();
1816             }
1817         }
1818     }
1819 
1820     /**
1821      * To be overridden by subclasses to determine whether the scroll indicator should stretch to
1822      * fill its space on the track or not.
1823      */
hasElasticScrollIndicator()1824     protected boolean hasElasticScrollIndicator() {
1825         return true;
1826     }
1827 
updateScrollingIndicator()1828     private void updateScrollingIndicator() {
1829         if (getChildCount() <= 1) return;
1830         if (!isScrollingIndicatorEnabled()) return;
1831 
1832         getScrollingIndicator();
1833         if (mScrollIndicator != null) {
1834             updateScrollingIndicatorPosition();
1835         }
1836         if (mShouldShowScrollIndicator) {
1837             showScrollingIndicator(mShouldShowScrollIndicatorImmediately);
1838         }
1839     }
1840 
updateScrollingIndicatorPosition()1841     private void updateScrollingIndicatorPosition() {
1842         if (!isScrollingIndicatorEnabled()) return;
1843         if (mScrollIndicator == null) return;
1844         int numPages = getChildCount();
1845         int pageWidth = getMeasuredWidth();
1846         int lastChildIndex = Math.max(0, getChildCount() - 1);
1847         int maxScrollX = getChildOffset(lastChildIndex) - getRelativeChildOffset(lastChildIndex);
1848         int trackWidth = pageWidth - mScrollIndicatorPaddingLeft - mScrollIndicatorPaddingRight;
1849         int indicatorWidth = mScrollIndicator.getMeasuredWidth() -
1850                 mScrollIndicator.getPaddingLeft() - mScrollIndicator.getPaddingRight();
1851 
1852         float offset = Math.max(0f, Math.min(1f, (float) getScrollX() / maxScrollX));
1853         int indicatorSpace = trackWidth / numPages;
1854         int indicatorPos = (int) (offset * (trackWidth - indicatorSpace)) + mScrollIndicatorPaddingLeft;
1855         if (hasElasticScrollIndicator()) {
1856             if (mScrollIndicator.getMeasuredWidth() != indicatorSpace) {
1857                 mScrollIndicator.getLayoutParams().width = indicatorSpace;
1858                 mScrollIndicator.requestLayout();
1859             }
1860         } else {
1861             int indicatorCenterOffset = indicatorSpace / 2 - indicatorWidth / 2;
1862             indicatorPos += indicatorCenterOffset;
1863         }
1864         mScrollIndicator.setTranslationX(indicatorPos);
1865     }
1866 
showScrollIndicatorTrack()1867     public void showScrollIndicatorTrack() {
1868     }
1869 
hideScrollIndicatorTrack()1870     public void hideScrollIndicatorTrack() {
1871     }
1872 
1873     /* Accessibility */
1874     @Override
onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo info)1875     public void onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo info) {
1876         super.onInitializeAccessibilityNodeInfo(info);
1877         info.setScrollable(getPageCount() > 1);
1878         if (getCurrentPage() < getPageCount() - 1) {
1879             info.addAction(AccessibilityNodeInfo.ACTION_SCROLL_FORWARD);
1880         }
1881         if (getCurrentPage() > 0) {
1882             info.addAction(AccessibilityNodeInfo.ACTION_SCROLL_BACKWARD);
1883         }
1884     }
1885 
1886     @Override
onInitializeAccessibilityEvent(AccessibilityEvent event)1887     public void onInitializeAccessibilityEvent(AccessibilityEvent event) {
1888         super.onInitializeAccessibilityEvent(event);
1889         event.setScrollable(true);
1890         if (event.getEventType() == AccessibilityEvent.TYPE_VIEW_SCROLLED) {
1891             event.setFromIndex(mCurrentPage);
1892             event.setToIndex(mCurrentPage);
1893             event.setItemCount(getChildCount());
1894         }
1895     }
1896 
1897     @Override
performAccessibilityAction(int action, Bundle arguments)1898     public boolean performAccessibilityAction(int action, Bundle arguments) {
1899         if (super.performAccessibilityAction(action, arguments)) {
1900             return true;
1901         }
1902         switch (action) {
1903             case AccessibilityNodeInfo.ACTION_SCROLL_FORWARD: {
1904                 if (getCurrentPage() < getPageCount() - 1) {
1905                     scrollRight();
1906                     return true;
1907                 }
1908             } break;
1909             case AccessibilityNodeInfo.ACTION_SCROLL_BACKWARD: {
1910                 if (getCurrentPage() > 0) {
1911                     scrollLeft();
1912                     return true;
1913                 }
1914             } break;
1915         }
1916         return false;
1917     }
1918 
getCurrentPageDescription()1919     protected String getCurrentPageDescription() {
1920         return String.format(getContext().getString(R.string.default_scroll_format),
1921                  getNextPage() + 1, getChildCount());
1922     }
1923 
1924     @Override
onHoverEvent(android.view.MotionEvent event)1925     public boolean onHoverEvent(android.view.MotionEvent event) {
1926         return true;
1927     }
1928 }
1929