1 /* 2 * Copyright (C) 2012 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.launcher3; 18 19 import android.animation.Animator; 20 import android.animation.AnimatorListenerAdapter; 21 import android.animation.AnimatorSet; 22 import android.animation.LayoutTransition; 23 import android.animation.ObjectAnimator; 24 import android.animation.TimeInterpolator; 25 import android.annotation.TargetApi; 26 import android.content.Context; 27 import android.content.res.TypedArray; 28 import android.graphics.Canvas; 29 import android.graphics.Matrix; 30 import android.graphics.Rect; 31 import android.graphics.RectF; 32 import android.os.Build; 33 import android.os.Bundle; 34 import android.os.Parcel; 35 import android.os.Parcelable; 36 import android.util.AttributeSet; 37 import android.util.DisplayMetrics; 38 import android.util.Log; 39 import android.view.InputDevice; 40 import android.view.KeyEvent; 41 import android.view.MotionEvent; 42 import android.view.VelocityTracker; 43 import android.view.View; 44 import android.view.ViewConfiguration; 45 import android.view.ViewGroup; 46 import android.view.ViewParent; 47 import android.view.accessibility.AccessibilityEvent; 48 import android.view.accessibility.AccessibilityManager; 49 import android.view.accessibility.AccessibilityNodeInfo; 50 import android.view.animation.Interpolator; 51 52 import com.android.launcher3.util.LauncherEdgeEffect; 53 import com.android.launcher3.util.Thunk; 54 55 import java.util.ArrayList; 56 57 /** 58 * An abstraction of the original Workspace which supports browsing through a 59 * sequential list of "pages" 60 */ 61 public abstract class PagedView extends ViewGroup implements ViewGroup.OnHierarchyChangeListener { 62 private static final String TAG = "PagedView"; 63 private static final boolean DEBUG = false; 64 protected static final int INVALID_PAGE = -1; 65 66 // the min drag distance for a fling to register, to prevent random page shifts 67 private static final int MIN_LENGTH_FOR_FLING = 25; 68 69 protected static final int PAGE_SNAP_ANIMATION_DURATION = 750; 70 protected static final int SLOW_PAGE_SNAP_ANIMATION_DURATION = 950; 71 protected static final float NANOTIME_DIV = 1000000000.0f; 72 73 private static final float RETURN_TO_ORIGINAL_PAGE_THRESHOLD = 0.33f; 74 // The page is moved more than halfway, automatically move to the next page on touch up. 75 private static final float SIGNIFICANT_MOVE_THRESHOLD = 0.4f; 76 77 private static final float MAX_SCROLL_PROGRESS = 1.0f; 78 79 // The following constants need to be scaled based on density. The scaled versions will be 80 // assigned to the corresponding member variables below. 81 private static final int FLING_THRESHOLD_VELOCITY = 500; 82 private static final int MIN_SNAP_VELOCITY = 1500; 83 private static final int MIN_FLING_VELOCITY = 250; 84 85 public static final int INVALID_RESTORE_PAGE = -1001; 86 87 private boolean mFreeScroll = false; 88 private int mFreeScrollMinScrollX = -1; 89 private int mFreeScrollMaxScrollX = -1; 90 91 protected int mFlingThresholdVelocity; 92 protected int mMinFlingVelocity; 93 protected int mMinSnapVelocity; 94 95 protected float mDensity; 96 protected float mSmoothingTime; 97 protected float mTouchX; 98 99 protected boolean mFirstLayout = true; 100 private int mNormalChildHeight; 101 102 protected int mCurrentPage; 103 protected int mRestorePage = INVALID_RESTORE_PAGE; 104 protected int mChildCountOnLastLayout; 105 106 protected int mNextPage = INVALID_PAGE; 107 protected int mMaxScrollX; 108 protected LauncherScroller mScroller; 109 private Interpolator mDefaultInterpolator; 110 private VelocityTracker mVelocityTracker; 111 @Thunk int mPageSpacing = 0; 112 113 private float mParentDownMotionX; 114 private float mParentDownMotionY; 115 private float mDownMotionX; 116 private float mDownMotionY; 117 private float mDownScrollX; 118 private float mDragViewBaselineLeft; 119 protected float mLastMotionX; 120 protected float mLastMotionXRemainder; 121 protected float mLastMotionY; 122 protected float mTotalMotionX; 123 private int mLastScreenCenter = -1; 124 125 private boolean mCancelTap; 126 127 private int[] mPageScrolls; 128 129 protected final static int TOUCH_STATE_REST = 0; 130 protected final static int TOUCH_STATE_SCROLLING = 1; 131 protected final static int TOUCH_STATE_PREV_PAGE = 2; 132 protected final static int TOUCH_STATE_NEXT_PAGE = 3; 133 protected final static int TOUCH_STATE_REORDERING = 4; 134 135 protected int mTouchState = TOUCH_STATE_REST; 136 protected boolean mForceScreenScrolled = false; 137 138 protected OnLongClickListener mLongClickListener; 139 140 protected int mTouchSlop; 141 private int mMaximumVelocity; 142 protected int mPageLayoutWidthGap; 143 protected int mPageLayoutHeightGap; 144 protected boolean mCenterPagesVertically; 145 protected boolean mAllowOverScroll = true; 146 protected int[] mTempVisiblePagesRange = new int[2]; 147 148 protected static final int INVALID_POINTER = -1; 149 150 protected int mActivePointerId = INVALID_POINTER; 151 152 private PageSwitchListener mPageSwitchListener; 153 154 // If true, modify alpha of neighboring pages as user scrolls left/right 155 protected boolean mFadeInAdjacentScreens = false; 156 157 protected boolean mIsPageMoving = false; 158 159 protected boolean mWasInOverscroll = false; 160 161 // Page Indicator 162 @Thunk int mPageIndicatorViewId; 163 @Thunk PageIndicator mPageIndicator; 164 // The viewport whether the pages are to be contained (the actual view may be larger than the 165 // viewport) 166 private Rect mViewport = new Rect(); 167 168 // Reordering 169 // We use the min scale to determine how much to expand the actually PagedView measured 170 // dimensions such that when we are zoomed out, the view is not clipped 171 private static int REORDERING_DROP_REPOSITION_DURATION = 200; 172 @Thunk static int REORDERING_REORDER_REPOSITION_DURATION = 300; 173 private static int REORDERING_SIDE_PAGE_HOVER_TIMEOUT = 80; 174 175 private float mMinScale = 1f; 176 private boolean mUseMinScale = false; 177 protected View mDragView; 178 private Runnable mSidePageHoverRunnable; 179 @Thunk int mSidePageHoverIndex = -1; 180 // This variable's scope is only for the duration of startReordering() and endReordering() 181 private boolean mReorderingStarted = false; 182 // This variable's scope is for the duration of startReordering() and after the zoomIn() 183 // animation after endReordering() 184 private boolean mIsReordering; 185 // The runnable that settles the page after snapToPage and animateDragViewToOriginalPosition 186 private int NUM_ANIMATIONS_RUNNING_BEFORE_ZOOM_OUT = 2; 187 private int mPostReorderingPreZoomInRemainingAnimationCount; 188 private Runnable mPostReorderingPreZoomInRunnable; 189 190 // Convenience/caching 191 private static final Matrix sTmpInvMatrix = new Matrix(); 192 private static final float[] sTmpPoint = new float[2]; 193 private static final int[] sTmpIntPoint = new int[2]; 194 private static final Rect sTmpRect = new Rect(); 195 private static final RectF sTmpRectF = new RectF(); 196 197 protected final Rect mInsets = new Rect(); 198 protected final boolean mIsRtl; 199 200 // Edge effect 201 private final LauncherEdgeEffect mEdgeGlowLeft = new LauncherEdgeEffect(); 202 private final LauncherEdgeEffect mEdgeGlowRight = new LauncherEdgeEffect(); 203 204 public interface PageSwitchListener { onPageSwitch(View newPage, int newPageIndex)205 void onPageSwitch(View newPage, int newPageIndex); 206 } 207 PagedView(Context context)208 public PagedView(Context context) { 209 this(context, null); 210 } 211 PagedView(Context context, AttributeSet attrs)212 public PagedView(Context context, AttributeSet attrs) { 213 this(context, attrs, 0); 214 } 215 PagedView(Context context, AttributeSet attrs, int defStyle)216 public PagedView(Context context, AttributeSet attrs, int defStyle) { 217 super(context, attrs, defStyle); 218 219 TypedArray a = context.obtainStyledAttributes(attrs, 220 R.styleable.PagedView, defStyle, 0); 221 222 mPageLayoutWidthGap = a.getDimensionPixelSize( 223 R.styleable.PagedView_pageLayoutWidthGap, 0); 224 mPageLayoutHeightGap = a.getDimensionPixelSize( 225 R.styleable.PagedView_pageLayoutHeightGap, 0); 226 mPageIndicatorViewId = a.getResourceId(R.styleable.PagedView_pageIndicator, -1); 227 a.recycle(); 228 229 setHapticFeedbackEnabled(false); 230 mIsRtl = Utilities.isRtl(getResources()); 231 init(); 232 } 233 234 /** 235 * Initializes various states for this workspace. 236 */ init()237 protected void init() { 238 mScroller = new LauncherScroller(getContext()); 239 setDefaultInterpolator(new ScrollInterpolator()); 240 mCurrentPage = 0; 241 mCenterPagesVertically = true; 242 243 final ViewConfiguration configuration = ViewConfiguration.get(getContext()); 244 mTouchSlop = configuration.getScaledPagingTouchSlop(); 245 mMaximumVelocity = configuration.getScaledMaximumFlingVelocity(); 246 mDensity = getResources().getDisplayMetrics().density; 247 248 mFlingThresholdVelocity = (int) (FLING_THRESHOLD_VELOCITY * mDensity); 249 mMinFlingVelocity = (int) (MIN_FLING_VELOCITY * mDensity); 250 mMinSnapVelocity = (int) (MIN_SNAP_VELOCITY * mDensity); 251 setOnHierarchyChangeListener(this); 252 setWillNotDraw(false); 253 } 254 setEdgeGlowColor(int color)255 protected void setEdgeGlowColor(int color) { 256 mEdgeGlowLeft.setColor(color); 257 mEdgeGlowRight.setColor(color); 258 } 259 setDefaultInterpolator(Interpolator interpolator)260 protected void setDefaultInterpolator(Interpolator interpolator) { 261 mDefaultInterpolator = interpolator; 262 mScroller.setInterpolator(mDefaultInterpolator); 263 } 264 onAttachedToWindow()265 protected void onAttachedToWindow() { 266 super.onAttachedToWindow(); 267 268 // Hook up the page indicator 269 ViewGroup parent = (ViewGroup) getParent(); 270 ViewGroup grandParent = (ViewGroup) parent.getParent(); 271 if (mPageIndicator == null && mPageIndicatorViewId > -1) { 272 mPageIndicator = (PageIndicator) grandParent.findViewById(mPageIndicatorViewId); 273 mPageIndicator.removeAllMarkers(true); 274 275 ArrayList<PageIndicator.PageMarkerResources> markers = 276 new ArrayList<PageIndicator.PageMarkerResources>(); 277 for (int i = 0; i < getChildCount(); ++i) { 278 markers.add(getPageIndicatorMarker(i)); 279 } 280 281 mPageIndicator.addMarkers(markers, true); 282 283 OnClickListener listener = getPageIndicatorClickListener(); 284 if (listener != null) { 285 mPageIndicator.setOnClickListener(listener); 286 } 287 mPageIndicator.setContentDescription(getPageIndicatorDescription()); 288 } 289 } 290 getPageIndicatorDescription()291 protected String getPageIndicatorDescription() { 292 return getCurrentPageDescription(); 293 } 294 getPageIndicatorClickListener()295 protected OnClickListener getPageIndicatorClickListener() { 296 return null; 297 } 298 299 @Override onDetachedFromWindow()300 protected void onDetachedFromWindow() { 301 super.onDetachedFromWindow(); 302 // Unhook the page indicator 303 mPageIndicator = null; 304 } 305 306 // Convenience methods to map points from self to parent and vice versa mapPointFromViewToParent(View v, float x, float y)307 private float[] mapPointFromViewToParent(View v, float x, float y) { 308 sTmpPoint[0] = x; 309 sTmpPoint[1] = y; 310 v.getMatrix().mapPoints(sTmpPoint); 311 sTmpPoint[0] += v.getLeft(); 312 sTmpPoint[1] += v.getTop(); 313 return sTmpPoint; 314 } mapPointFromParentToView(View v, float x, float y)315 private float[] mapPointFromParentToView(View v, float x, float y) { 316 sTmpPoint[0] = x - v.getLeft(); 317 sTmpPoint[1] = y - v.getTop(); 318 v.getMatrix().invert(sTmpInvMatrix); 319 sTmpInvMatrix.mapPoints(sTmpPoint); 320 return sTmpPoint; 321 } 322 updateDragViewTranslationDuringDrag()323 private void updateDragViewTranslationDuringDrag() { 324 if (mDragView != null) { 325 float x = (mLastMotionX - mDownMotionX) + (getScrollX() - mDownScrollX) + 326 (mDragViewBaselineLeft - mDragView.getLeft()); 327 float y = mLastMotionY - mDownMotionY; 328 mDragView.setTranslationX(x); 329 mDragView.setTranslationY(y); 330 331 if (DEBUG) Log.d(TAG, "PagedView.updateDragViewTranslationDuringDrag(): " 332 + x + ", " + y); 333 } 334 } 335 setMinScale(float f)336 public void setMinScale(float f) { 337 mMinScale = f; 338 mUseMinScale = true; 339 requestLayout(); 340 } 341 342 @Override setScaleX(float scaleX)343 public void setScaleX(float scaleX) { 344 super.setScaleX(scaleX); 345 if (isReordering(true)) { 346 float[] p = mapPointFromParentToView(this, mParentDownMotionX, mParentDownMotionY); 347 mLastMotionX = p[0]; 348 mLastMotionY = p[1]; 349 updateDragViewTranslationDuringDrag(); 350 } 351 } 352 353 // Convenience methods to get the actual width/height of the PagedView (since it is measured 354 // to be larger to account for the minimum possible scale) getViewportWidth()355 int getViewportWidth() { 356 return mViewport.width(); 357 } getViewportHeight()358 int getViewportHeight() { 359 return mViewport.height(); 360 } 361 362 // Convenience methods to get the offset ASSUMING that we are centering the pages in the 363 // PagedView both horizontally and vertically getViewportOffsetX()364 int getViewportOffsetX() { 365 return (getMeasuredWidth() - getViewportWidth()) / 2; 366 } 367 getViewportOffsetY()368 int getViewportOffsetY() { 369 return (getMeasuredHeight() - getViewportHeight()) / 2; 370 } 371 getPageIndicator()372 PageIndicator getPageIndicator() { 373 return mPageIndicator; 374 } getPageIndicatorMarker(int pageIndex)375 protected PageIndicator.PageMarkerResources getPageIndicatorMarker(int pageIndex) { 376 return new PageIndicator.PageMarkerResources(); 377 } 378 379 /** 380 * Add a page change listener which will be called when a page is _finished_ listening. 381 * 382 */ setPageSwitchListener(PageSwitchListener pageSwitchListener)383 public void setPageSwitchListener(PageSwitchListener pageSwitchListener) { 384 mPageSwitchListener = pageSwitchListener; 385 if (mPageSwitchListener != null) { 386 mPageSwitchListener.onPageSwitch(getPageAt(mCurrentPage), mCurrentPage); 387 } 388 } 389 390 /** 391 * Returns the index of the currently displayed page. 392 */ getCurrentPage()393 public int getCurrentPage() { 394 return mCurrentPage; 395 } 396 397 /** 398 * Returns the index of page to be shown immediately afterwards. 399 */ getNextPage()400 int getNextPage() { 401 return (mNextPage != INVALID_PAGE) ? mNextPage : mCurrentPage; 402 } 403 getPageCount()404 int getPageCount() { 405 return getChildCount(); 406 } 407 getPageAt(int index)408 public View getPageAt(int index) { 409 return getChildAt(index); 410 } 411 indexToPage(int index)412 protected int indexToPage(int index) { 413 return index; 414 } 415 416 /** 417 * Updates the scroll of the current page immediately to its final scroll position. We use this 418 * in CustomizePagedView to allow tabs to share the same PagedView while resetting the scroll of 419 * the previous tab page. 420 */ updateCurrentPageScroll()421 protected void updateCurrentPageScroll() { 422 // If the current page is invalid, just reset the scroll position to zero 423 int newX = 0; 424 if (0 <= mCurrentPage && mCurrentPage < getPageCount()) { 425 newX = getScrollForPage(mCurrentPage); 426 } 427 scrollTo(newX, 0); 428 mScroller.setFinalX(newX); 429 forceFinishScroller(); 430 } 431 abortScrollerAnimation(boolean resetNextPage)432 private void abortScrollerAnimation(boolean resetNextPage) { 433 mScroller.abortAnimation(); 434 // We need to clean up the next page here to avoid computeScrollHelper from 435 // updating current page on the pass. 436 if (resetNextPage) { 437 mNextPage = INVALID_PAGE; 438 } 439 } 440 forceFinishScroller()441 private void forceFinishScroller() { 442 mScroller.forceFinished(true); 443 // We need to clean up the next page here to avoid computeScrollHelper from 444 // updating current page on the pass. 445 mNextPage = INVALID_PAGE; 446 } 447 validateNewPage(int newPage)448 private int validateNewPage(int newPage) { 449 int validatedPage = newPage; 450 // When in free scroll mode, we need to clamp to the free scroll page range. 451 if (mFreeScroll) { 452 getFreeScrollPageRange(mTempVisiblePagesRange); 453 validatedPage = Math.max(mTempVisiblePagesRange[0], 454 Math.min(newPage, mTempVisiblePagesRange[1])); 455 } 456 // Ensure that it is clamped by the actual set of children in all cases 457 validatedPage = Math.max(0, Math.min(validatedPage, getPageCount() - 1)); 458 return validatedPage; 459 } 460 461 /** 462 * Sets the current page. 463 */ setCurrentPage(int currentPage)464 public void setCurrentPage(int currentPage) { 465 if (!mScroller.isFinished()) { 466 abortScrollerAnimation(true); 467 } 468 // don't introduce any checks like mCurrentPage == currentPage here-- if we change the 469 // the default 470 if (getChildCount() == 0) { 471 return; 472 } 473 mForceScreenScrolled = true; 474 mCurrentPage = validateNewPage(currentPage); 475 updateCurrentPageScroll(); 476 notifyPageSwitchListener(); 477 invalidate(); 478 } 479 480 /** 481 * The restore page will be set in place of the current page at the next (likely first) 482 * layout. 483 */ setRestorePage(int restorePage)484 void setRestorePage(int restorePage) { 485 mRestorePage = restorePage; 486 } getRestorePage()487 int getRestorePage() { 488 return mRestorePage; 489 } 490 491 /** 492 * Should be called whenever the page changes. In the case of a scroll, we wait until the page 493 * has settled. 494 */ notifyPageSwitchListener()495 protected void notifyPageSwitchListener() { 496 if (mPageSwitchListener != null) { 497 mPageSwitchListener.onPageSwitch(getPageAt(getNextPage()), getNextPage()); 498 } 499 500 updatePageIndicator(); 501 } 502 updatePageIndicator()503 private void updatePageIndicator() { 504 // Update the page indicator (when we aren't reordering) 505 if (mPageIndicator != null) { 506 mPageIndicator.setContentDescription(getPageIndicatorDescription()); 507 if (!isReordering(false)) { 508 mPageIndicator.setActiveMarker(getNextPage()); 509 } 510 } 511 } pageBeginMoving()512 protected void pageBeginMoving() { 513 if (!mIsPageMoving) { 514 mIsPageMoving = true; 515 onPageBeginMoving(); 516 } 517 } 518 pageEndMoving()519 protected void pageEndMoving() { 520 if (mIsPageMoving) { 521 mIsPageMoving = false; 522 onPageEndMoving(); 523 } 524 } 525 isPageMoving()526 protected boolean isPageMoving() { 527 return mIsPageMoving; 528 } 529 530 // a method that subclasses can override to add behavior onPageBeginMoving()531 protected void onPageBeginMoving() { 532 } 533 534 // a method that subclasses can override to add behavior onPageEndMoving()535 protected void onPageEndMoving() { 536 mWasInOverscroll = false; 537 } 538 539 /** 540 * Registers the specified listener on each page contained in this workspace. 541 * 542 * @param l The listener used to respond to long clicks. 543 */ 544 @Override setOnLongClickListener(OnLongClickListener l)545 public void setOnLongClickListener(OnLongClickListener l) { 546 mLongClickListener = l; 547 final int count = getPageCount(); 548 for (int i = 0; i < count; i++) { 549 getPageAt(i).setOnLongClickListener(l); 550 } 551 super.setOnLongClickListener(l); 552 } 553 getUnboundedScrollX()554 protected int getUnboundedScrollX() { 555 return getScrollX(); 556 } 557 558 @Override scrollBy(int x, int y)559 public void scrollBy(int x, int y) { 560 scrollTo(getUnboundedScrollX() + x, getScrollY() + y); 561 } 562 563 @Override scrollTo(int x, int y)564 public void scrollTo(int x, int y) { 565 // In free scroll mode, we clamp the scrollX 566 if (mFreeScroll) { 567 // If the scroller is trying to move to a location beyond the maximum allowed 568 // in the free scroll mode, we make sure to end the scroll operation. 569 if (!mScroller.isFinished() && 570 (x > mFreeScrollMaxScrollX || x < mFreeScrollMinScrollX)) { 571 forceFinishScroller(); 572 } 573 574 x = Math.min(x, mFreeScrollMaxScrollX); 575 x = Math.max(x, mFreeScrollMinScrollX); 576 } 577 578 boolean isXBeforeFirstPage = mIsRtl ? (x > mMaxScrollX) : (x < 0); 579 boolean isXAfterLastPage = mIsRtl ? (x < 0) : (x > mMaxScrollX); 580 if (isXBeforeFirstPage) { 581 super.scrollTo(mIsRtl ? mMaxScrollX : 0, y); 582 if (mAllowOverScroll) { 583 mWasInOverscroll = true; 584 if (mIsRtl) { 585 overScroll(x - mMaxScrollX); 586 } else { 587 overScroll(x); 588 } 589 } 590 } else if (isXAfterLastPage) { 591 super.scrollTo(mIsRtl ? 0 : mMaxScrollX, y); 592 if (mAllowOverScroll) { 593 mWasInOverscroll = true; 594 if (mIsRtl) { 595 overScroll(x); 596 } else { 597 overScroll(x - mMaxScrollX); 598 } 599 } 600 } else { 601 if (mWasInOverscroll) { 602 overScroll(0); 603 mWasInOverscroll = false; 604 } 605 super.scrollTo(x, y); 606 } 607 608 mTouchX = x; 609 mSmoothingTime = System.nanoTime() / NANOTIME_DIV; 610 611 // Update the last motion events when scrolling 612 if (isReordering(true)) { 613 float[] p = mapPointFromParentToView(this, mParentDownMotionX, mParentDownMotionY); 614 mLastMotionX = p[0]; 615 mLastMotionY = p[1]; 616 updateDragViewTranslationDuringDrag(); 617 } 618 } 619 sendScrollAccessibilityEvent()620 private void sendScrollAccessibilityEvent() { 621 AccessibilityManager am = 622 (AccessibilityManager) getContext().getSystemService(Context.ACCESSIBILITY_SERVICE); 623 if (am.isEnabled()) { 624 if (mCurrentPage != getNextPage()) { 625 AccessibilityEvent ev = 626 AccessibilityEvent.obtain(AccessibilityEvent.TYPE_VIEW_SCROLLED); 627 ev.setScrollable(true); 628 ev.setScrollX(getScrollX()); 629 ev.setScrollY(getScrollY()); 630 ev.setMaxScrollX(mMaxScrollX); 631 ev.setMaxScrollY(0); 632 633 sendAccessibilityEventUnchecked(ev); 634 } 635 } 636 } 637 638 // we moved this functionality to a helper function so SmoothPagedView can reuse it computeScrollHelper()639 protected boolean computeScrollHelper() { 640 if (mScroller.computeScrollOffset()) { 641 // Don't bother scrolling if the page does not need to be moved 642 if (getScrollX() != mScroller.getCurrX() 643 || getScrollY() != mScroller.getCurrY()) { 644 float scaleX = mFreeScroll ? getScaleX() : 1f; 645 int scrollX = (int) (mScroller.getCurrX() * (1 / scaleX)); 646 scrollTo(scrollX, mScroller.getCurrY()); 647 } 648 invalidate(); 649 return true; 650 } else if (mNextPage != INVALID_PAGE) { 651 sendScrollAccessibilityEvent(); 652 653 mCurrentPage = validateNewPage(mNextPage); 654 mNextPage = INVALID_PAGE; 655 notifyPageSwitchListener(); 656 657 // We don't want to trigger a page end moving unless the page has settled 658 // and the user has stopped scrolling 659 if (mTouchState == TOUCH_STATE_REST) { 660 pageEndMoving(); 661 } 662 663 onPostReorderingAnimationCompleted(); 664 AccessibilityManager am = (AccessibilityManager) 665 getContext().getSystemService(Context.ACCESSIBILITY_SERVICE); 666 if (am.isEnabled()) { 667 // Notify the user when the page changes 668 announceForAccessibility(getCurrentPageDescription()); 669 } 670 return true; 671 } 672 return false; 673 } 674 675 @Override computeScroll()676 public void computeScroll() { 677 computeScrollHelper(); 678 } 679 680 public static class LayoutParams extends ViewGroup.LayoutParams { 681 public boolean isFullScreenPage = false; 682 683 /** 684 * {@inheritDoc} 685 */ LayoutParams(int width, int height)686 public LayoutParams(int width, int height) { 687 super(width, height); 688 } 689 LayoutParams(Context context, AttributeSet attrs)690 public LayoutParams(Context context, AttributeSet attrs) { 691 super(context, attrs); 692 } 693 LayoutParams(ViewGroup.LayoutParams source)694 public LayoutParams(ViewGroup.LayoutParams source) { 695 super(source); 696 } 697 } 698 699 @Override generateLayoutParams(AttributeSet attrs)700 public LayoutParams generateLayoutParams(AttributeSet attrs) { 701 return new LayoutParams(getContext(), attrs); 702 } 703 704 @Override generateDefaultLayoutParams()705 protected LayoutParams generateDefaultLayoutParams() { 706 return new LayoutParams(LayoutParams.WRAP_CONTENT, LayoutParams.WRAP_CONTENT); 707 } 708 709 @Override generateLayoutParams(ViewGroup.LayoutParams p)710 protected ViewGroup.LayoutParams generateLayoutParams(ViewGroup.LayoutParams p) { 711 return new LayoutParams(p); 712 } 713 714 @Override checkLayoutParams(ViewGroup.LayoutParams p)715 protected boolean checkLayoutParams(ViewGroup.LayoutParams p) { 716 return p instanceof LayoutParams; 717 } 718 addFullScreenPage(View page)719 public void addFullScreenPage(View page) { 720 LayoutParams lp = generateDefaultLayoutParams(); 721 lp.isFullScreenPage = true; 722 super.addView(page, 0, lp); 723 } 724 getNormalChildHeight()725 public int getNormalChildHeight() { 726 return mNormalChildHeight; 727 } 728 729 @Override onMeasure(int widthMeasureSpec, int heightMeasureSpec)730 protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) { 731 if (getChildCount() == 0) { 732 super.onMeasure(widthMeasureSpec, heightMeasureSpec); 733 return; 734 } 735 736 // We measure the dimensions of the PagedView to be larger than the pages so that when we 737 // zoom out (and scale down), the view is still contained in the parent 738 int widthMode = MeasureSpec.getMode(widthMeasureSpec); 739 int widthSize = MeasureSpec.getSize(widthMeasureSpec); 740 int heightMode = MeasureSpec.getMode(heightMeasureSpec); 741 int heightSize = MeasureSpec.getSize(heightMeasureSpec); 742 // NOTE: We multiply by 2f to account for the fact that depending on the offset of the 743 // viewport, we can be at most one and a half screens offset once we scale down 744 DisplayMetrics dm = getResources().getDisplayMetrics(); 745 int maxSize = Math.max(dm.widthPixels + mInsets.left + mInsets.right, 746 dm.heightPixels + mInsets.top + mInsets.bottom); 747 748 int parentWidthSize = (int) (2f * maxSize); 749 int parentHeightSize = (int) (2f * maxSize); 750 int scaledWidthSize, scaledHeightSize; 751 if (mUseMinScale) { 752 scaledWidthSize = (int) (parentWidthSize / mMinScale); 753 scaledHeightSize = (int) (parentHeightSize / mMinScale); 754 } else { 755 scaledWidthSize = widthSize; 756 scaledHeightSize = heightSize; 757 } 758 mViewport.set(0, 0, widthSize, heightSize); 759 760 if (widthMode == MeasureSpec.UNSPECIFIED || heightMode == MeasureSpec.UNSPECIFIED) { 761 super.onMeasure(widthMeasureSpec, heightMeasureSpec); 762 return; 763 } 764 765 // Return early if we aren't given a proper dimension 766 if (widthSize <= 0 || heightSize <= 0) { 767 super.onMeasure(widthMeasureSpec, heightMeasureSpec); 768 return; 769 } 770 771 /* Allow the height to be set as WRAP_CONTENT. This allows the particular case 772 * of the All apps view on XLarge displays to not take up more space then it needs. Width 773 * is still not allowed to be set as WRAP_CONTENT since many parts of the code expect 774 * each page to have the same width. 775 */ 776 final int verticalPadding = getPaddingTop() + getPaddingBottom(); 777 final int horizontalPadding = getPaddingLeft() + getPaddingRight(); 778 779 int referenceChildWidth = 0; 780 // The children are given the same width and height as the workspace 781 // unless they were set to WRAP_CONTENT 782 if (DEBUG) Log.d(TAG, "PagedView.onMeasure(): " + widthSize + ", " + heightSize); 783 if (DEBUG) Log.d(TAG, "PagedView.scaledSize: " + scaledWidthSize + ", " + scaledHeightSize); 784 if (DEBUG) Log.d(TAG, "PagedView.parentSize: " + parentWidthSize + ", " + parentHeightSize); 785 if (DEBUG) Log.d(TAG, "PagedView.horizontalPadding: " + horizontalPadding); 786 if (DEBUG) Log.d(TAG, "PagedView.verticalPadding: " + verticalPadding); 787 final int childCount = getChildCount(); 788 for (int i = 0; i < childCount; i++) { 789 // disallowing padding in paged view (just pass 0) 790 final View child = getPageAt(i); 791 if (child.getVisibility() != GONE) { 792 final LayoutParams lp = (LayoutParams) child.getLayoutParams(); 793 794 int childWidthMode; 795 int childHeightMode; 796 int childWidth; 797 int childHeight; 798 799 if (!lp.isFullScreenPage) { 800 if (lp.width == LayoutParams.WRAP_CONTENT) { 801 childWidthMode = MeasureSpec.AT_MOST; 802 } else { 803 childWidthMode = MeasureSpec.EXACTLY; 804 } 805 806 if (lp.height == LayoutParams.WRAP_CONTENT) { 807 childHeightMode = MeasureSpec.AT_MOST; 808 } else { 809 childHeightMode = MeasureSpec.EXACTLY; 810 } 811 812 childWidth = getViewportWidth() - horizontalPadding 813 - mInsets.left - mInsets.right; 814 childHeight = getViewportHeight() - verticalPadding 815 - mInsets.top - mInsets.bottom; 816 mNormalChildHeight = childHeight; 817 } else { 818 childWidthMode = MeasureSpec.EXACTLY; 819 childHeightMode = MeasureSpec.EXACTLY; 820 821 childWidth = getViewportWidth(); 822 childHeight = getViewportHeight(); 823 } 824 if (referenceChildWidth == 0) { 825 referenceChildWidth = childWidth; 826 } 827 828 final int childWidthMeasureSpec = 829 MeasureSpec.makeMeasureSpec(childWidth, childWidthMode); 830 final int childHeightMeasureSpec = 831 MeasureSpec.makeMeasureSpec(childHeight, childHeightMode); 832 child.measure(childWidthMeasureSpec, childHeightMeasureSpec); 833 } 834 } 835 setMeasuredDimension(scaledWidthSize, scaledHeightSize); 836 } 837 838 @Override onLayout(boolean changed, int left, int top, int right, int bottom)839 protected void onLayout(boolean changed, int left, int top, int right, int bottom) { 840 if (getChildCount() == 0) { 841 return; 842 } 843 844 if (DEBUG) Log.d(TAG, "PagedView.onLayout()"); 845 final int childCount = getChildCount(); 846 847 int offsetX = getViewportOffsetX(); 848 int offsetY = getViewportOffsetY(); 849 850 // Update the viewport offsets 851 mViewport.offset(offsetX, offsetY); 852 853 final int startIndex = mIsRtl ? childCount - 1 : 0; 854 final int endIndex = mIsRtl ? -1 : childCount; 855 final int delta = mIsRtl ? -1 : 1; 856 857 int verticalPadding = getPaddingTop() + getPaddingBottom(); 858 859 LayoutParams lp = (LayoutParams) getChildAt(startIndex).getLayoutParams(); 860 LayoutParams nextLp; 861 862 int childLeft = offsetX + (lp.isFullScreenPage ? 0 : getPaddingLeft()); 863 if (mPageScrolls == null || childCount != mChildCountOnLastLayout) { 864 mPageScrolls = new int[childCount]; 865 } 866 867 for (int i = startIndex; i != endIndex; i += delta) { 868 final View child = getPageAt(i); 869 if (child.getVisibility() != View.GONE) { 870 lp = (LayoutParams) child.getLayoutParams(); 871 int childTop; 872 if (lp.isFullScreenPage) { 873 childTop = offsetY; 874 } else { 875 childTop = offsetY + getPaddingTop() + mInsets.top; 876 if (mCenterPagesVertically) { 877 childTop += (getViewportHeight() - mInsets.top - mInsets.bottom - verticalPadding - child.getMeasuredHeight()) / 2; 878 } 879 } 880 881 final int childWidth = child.getMeasuredWidth(); 882 final int childHeight = child.getMeasuredHeight(); 883 884 if (DEBUG) Log.d(TAG, "\tlayout-child" + i + ": " + childLeft + ", " + childTop); 885 child.layout(childLeft, childTop, 886 childLeft + child.getMeasuredWidth(), childTop + childHeight); 887 888 int scrollOffsetLeft = lp.isFullScreenPage ? 0 : getPaddingLeft(); 889 mPageScrolls[i] = childLeft - scrollOffsetLeft - offsetX; 890 891 int pageGap = mPageSpacing; 892 int next = i + delta; 893 if (next != endIndex) { 894 nextLp = (LayoutParams) getPageAt(next).getLayoutParams(); 895 } else { 896 nextLp = null; 897 } 898 899 // Prevent full screen pages from showing in the viewport 900 // when they are not the current page. 901 if (lp.isFullScreenPage) { 902 pageGap = getPaddingLeft(); 903 } else if (nextLp != null && nextLp.isFullScreenPage) { 904 pageGap = getPaddingRight(); 905 } 906 907 childLeft += childWidth + pageGap + getChildGap(); 908 } 909 } 910 911 final LayoutTransition transition = getLayoutTransition(); 912 // If the transition is running defer updating max scroll, as some empty pages could 913 // still be present, and a max scroll change could cause sudden jumps in scroll. 914 if (transition != null && transition.isRunning()) { 915 transition.addTransitionListener(new LayoutTransition.TransitionListener() { 916 917 @Override 918 public void startTransition(LayoutTransition transition, ViewGroup container, 919 View view, int transitionType) { } 920 921 @Override 922 public void endTransition(LayoutTransition transition, ViewGroup container, 923 View view, int transitionType) { 924 // Wait until all transitions are complete. 925 if (!transition.isRunning()) { 926 transition.removeTransitionListener(this); 927 updateMaxScrollX(); 928 } 929 } 930 }); 931 } else { 932 updateMaxScrollX(); 933 } 934 935 if (mFirstLayout && mCurrentPage >= 0 && mCurrentPage < childCount) { 936 updateCurrentPageScroll(); 937 mFirstLayout = false; 938 } 939 940 if (mScroller.isFinished() && mChildCountOnLastLayout != childCount) { 941 if (mRestorePage != INVALID_RESTORE_PAGE) { 942 setCurrentPage(mRestorePage); 943 mRestorePage = INVALID_RESTORE_PAGE; 944 } else { 945 setCurrentPage(getNextPage()); 946 } 947 } 948 mChildCountOnLastLayout = childCount; 949 950 if (isReordering(true)) { 951 updateDragViewTranslationDuringDrag(); 952 } 953 } 954 getChildGap()955 protected int getChildGap() { 956 return 0; 957 } 958 updateMaxScrollX()959 @Thunk void updateMaxScrollX() { 960 int childCount = getChildCount(); 961 if (childCount > 0) { 962 final int index = mIsRtl ? 0 : childCount - 1; 963 mMaxScrollX = getScrollForPage(index); 964 } else { 965 mMaxScrollX = 0; 966 } 967 } 968 setPageSpacing(int pageSpacing)969 public void setPageSpacing(int pageSpacing) { 970 mPageSpacing = pageSpacing; 971 requestLayout(); 972 } 973 974 /** 975 * Called when the center screen changes during scrolling. 976 */ screenScrolled(int screenCenter)977 protected void screenScrolled(int screenCenter) { } 978 979 @Override onChildViewAdded(View parent, View child)980 public void onChildViewAdded(View parent, View child) { 981 // Update the page indicator, we don't update the page indicator as we 982 // add/remove pages 983 if (mPageIndicator != null && !isReordering(false)) { 984 int pageIndex = indexOfChild(child); 985 mPageIndicator.addMarker(pageIndex, 986 getPageIndicatorMarker(pageIndex), 987 true); 988 } 989 990 // This ensures that when children are added, they get the correct transforms / alphas 991 // in accordance with any scroll effects. 992 mForceScreenScrolled = true; 993 updateFreescrollBounds(); 994 invalidate(); 995 } 996 997 @Override onChildViewRemoved(View parent, View child)998 public void onChildViewRemoved(View parent, View child) { 999 mForceScreenScrolled = true; 1000 updateFreescrollBounds(); 1001 invalidate(); 1002 } 1003 removeMarkerForView(int index)1004 private void removeMarkerForView(int index) { 1005 // Update the page indicator, we don't update the page indicator as we 1006 // add/remove pages 1007 if (mPageIndicator != null && !isReordering(false)) { 1008 mPageIndicator.removeMarker(index, true); 1009 } 1010 } 1011 1012 @Override removeView(View v)1013 public void removeView(View v) { 1014 // XXX: We should find a better way to hook into this before the view 1015 // gets removed form its parent... 1016 removeMarkerForView(indexOfChild(v)); 1017 super.removeView(v); 1018 } 1019 @Override removeViewInLayout(View v)1020 public void removeViewInLayout(View v) { 1021 // XXX: We should find a better way to hook into this before the view 1022 // gets removed form its parent... 1023 removeMarkerForView(indexOfChild(v)); 1024 super.removeViewInLayout(v); 1025 } 1026 @Override removeViewAt(int index)1027 public void removeViewAt(int index) { 1028 // XXX: We should find a better way to hook into this before the view 1029 // gets removed form its parent... 1030 removeMarkerForView(index); 1031 super.removeViewAt(index); 1032 } 1033 @Override removeAllViewsInLayout()1034 public void removeAllViewsInLayout() { 1035 // Update the page indicator, we don't update the page indicator as we 1036 // add/remove pages 1037 if (mPageIndicator != null) { 1038 mPageIndicator.removeAllMarkers(true); 1039 } 1040 1041 super.removeAllViewsInLayout(); 1042 } 1043 getChildOffset(int index)1044 protected int getChildOffset(int index) { 1045 if (index < 0 || index > getChildCount() - 1) return 0; 1046 1047 int offset = getPageAt(index).getLeft() - getViewportOffsetX(); 1048 1049 return offset; 1050 } 1051 getFreeScrollPageRange(int[] range)1052 protected void getFreeScrollPageRange(int[] range) { 1053 range[0] = 0; 1054 range[1] = Math.max(0, getChildCount() - 1); 1055 } 1056 getVisiblePages(int[] range)1057 protected void getVisiblePages(int[] range) { 1058 final int count = getChildCount(); 1059 range[0] = -1; 1060 range[1] = -1; 1061 1062 if (count > 0) { 1063 final int visibleLeft = -getLeft(); 1064 final int visibleRight = visibleLeft + getViewportWidth(); 1065 final Matrix pageShiftMatrix = getPageShiftMatrix(); 1066 int curScreen = 0; 1067 1068 for (int i = 0; i < count; i++) { 1069 View currPage = getPageAt(i); 1070 1071 // Verify if the page bounds are within the visible range. 1072 sTmpRectF.left = 0; 1073 sTmpRectF.right = currPage.getMeasuredWidth(); 1074 currPage.getMatrix().mapRect(sTmpRectF); 1075 sTmpRectF.offset(currPage.getLeft() - getScrollX(), 0); 1076 pageShiftMatrix.mapRect(sTmpRectF); 1077 1078 if (sTmpRectF.left > visibleRight || sTmpRectF.right < visibleLeft) { 1079 if (range[0] == -1) { 1080 continue; 1081 } else { 1082 break; 1083 } 1084 } 1085 1086 curScreen = i; 1087 if (range[0] < 0) { 1088 range[0] = curScreen; 1089 } 1090 } 1091 1092 range[1] = curScreen; 1093 } else { 1094 range[0] = -1; 1095 range[1] = -1; 1096 } 1097 } 1098 getPageShiftMatrix()1099 protected Matrix getPageShiftMatrix() { 1100 return getMatrix(); 1101 } 1102 shouldDrawChild(View child)1103 protected boolean shouldDrawChild(View child) { 1104 return child.getVisibility() == VISIBLE; 1105 } 1106 1107 @Override dispatchDraw(Canvas canvas)1108 protected void dispatchDraw(Canvas canvas) { 1109 // Find out which screens are visible; as an optimization we only call draw on them 1110 final int pageCount = getChildCount(); 1111 if (pageCount > 0) { 1112 int halfScreenSize = getViewportWidth() / 2; 1113 int screenCenter = getScrollX() + halfScreenSize; 1114 1115 if (screenCenter != mLastScreenCenter || mForceScreenScrolled) { 1116 // set mForceScreenScrolled before calling screenScrolled so that screenScrolled can 1117 // set it for the next frame 1118 mForceScreenScrolled = false; 1119 screenScrolled(screenCenter); 1120 mLastScreenCenter = screenCenter; 1121 } 1122 1123 getVisiblePages(mTempVisiblePagesRange); 1124 final int leftScreen = mTempVisiblePagesRange[0]; 1125 final int rightScreen = mTempVisiblePagesRange[1]; 1126 if (leftScreen != -1 && rightScreen != -1) { 1127 final long drawingTime = getDrawingTime(); 1128 // Clip to the bounds 1129 canvas.save(); 1130 canvas.clipRect(getScrollX(), getScrollY(), getScrollX() + getRight() - getLeft(), 1131 getScrollY() + getBottom() - getTop()); 1132 1133 // Draw all the children, leaving the drag view for last 1134 for (int i = pageCount - 1; i >= 0; i--) { 1135 final View v = getPageAt(i); 1136 if (v == mDragView) continue; 1137 if (leftScreen <= i && i <= rightScreen && shouldDrawChild(v)) { 1138 drawChild(canvas, v, drawingTime); 1139 } 1140 } 1141 // Draw the drag view on top (if there is one) 1142 if (mDragView != null) { 1143 drawChild(canvas, mDragView, drawingTime); 1144 } 1145 1146 canvas.restore(); 1147 } 1148 } 1149 } 1150 1151 @Override draw(Canvas canvas)1152 public void draw(Canvas canvas) { 1153 super.draw(canvas); 1154 if (getPageCount() > 0) { 1155 if (!mEdgeGlowLeft.isFinished()) { 1156 final int restoreCount = canvas.save(); 1157 Rect display = mViewport; 1158 canvas.translate(display.left, display.top); 1159 canvas.rotate(270); 1160 1161 getEdgeVerticalPostion(sTmpIntPoint); 1162 canvas.translate(display.top - sTmpIntPoint[1], 0); 1163 mEdgeGlowLeft.setSize(sTmpIntPoint[1] - sTmpIntPoint[0], display.width()); 1164 if (mEdgeGlowLeft.draw(canvas)) { 1165 postInvalidateOnAnimation(); 1166 } 1167 canvas.restoreToCount(restoreCount); 1168 } 1169 if (!mEdgeGlowRight.isFinished()) { 1170 final int restoreCount = canvas.save(); 1171 Rect display = mViewport; 1172 canvas.translate(display.left + mPageScrolls[mIsRtl ? 0 : (getPageCount() - 1)], display.top); 1173 canvas.rotate(90); 1174 1175 getEdgeVerticalPostion(sTmpIntPoint); 1176 1177 canvas.translate(sTmpIntPoint[0] - display.top, -display.width()); 1178 mEdgeGlowRight.setSize(sTmpIntPoint[1] - sTmpIntPoint[0], display.width()); 1179 if (mEdgeGlowRight.draw(canvas)) { 1180 postInvalidateOnAnimation(); 1181 } 1182 canvas.restoreToCount(restoreCount); 1183 } 1184 } 1185 } 1186 1187 /** 1188 * Returns the top and bottom position for the edge effect. 1189 */ getEdgeVerticalPostion(int[] pos)1190 protected abstract void getEdgeVerticalPostion(int[] pos); 1191 1192 @Override requestChildRectangleOnScreen(View child, Rect rectangle, boolean immediate)1193 public boolean requestChildRectangleOnScreen(View child, Rect rectangle, boolean immediate) { 1194 int page = indexToPage(indexOfChild(child)); 1195 if (page != mCurrentPage || !mScroller.isFinished()) { 1196 snapToPage(page); 1197 return true; 1198 } 1199 return false; 1200 } 1201 1202 @Override onRequestFocusInDescendants(int direction, Rect previouslyFocusedRect)1203 protected boolean onRequestFocusInDescendants(int direction, Rect previouslyFocusedRect) { 1204 int focusablePage; 1205 if (mNextPage != INVALID_PAGE) { 1206 focusablePage = mNextPage; 1207 } else { 1208 focusablePage = mCurrentPage; 1209 } 1210 View v = getPageAt(focusablePage); 1211 if (v != null) { 1212 return v.requestFocus(direction, previouslyFocusedRect); 1213 } 1214 return false; 1215 } 1216 1217 @Override dispatchUnhandledMove(View focused, int direction)1218 public boolean dispatchUnhandledMove(View focused, int direction) { 1219 if (super.dispatchUnhandledMove(focused, direction)) { 1220 return true; 1221 } 1222 1223 if (mIsRtl) { 1224 if (direction == View.FOCUS_LEFT) { 1225 direction = View.FOCUS_RIGHT; 1226 } else if (direction == View.FOCUS_RIGHT) { 1227 direction = View.FOCUS_LEFT; 1228 } 1229 } 1230 if (direction == View.FOCUS_LEFT) { 1231 if (getCurrentPage() > 0) { 1232 snapToPage(getCurrentPage() - 1); 1233 return true; 1234 } 1235 } else if (direction == View.FOCUS_RIGHT) { 1236 if (getCurrentPage() < getPageCount() - 1) { 1237 snapToPage(getCurrentPage() + 1); 1238 return true; 1239 } 1240 } 1241 return false; 1242 } 1243 1244 @Override addFocusables(ArrayList<View> views, int direction, int focusableMode)1245 public void addFocusables(ArrayList<View> views, int direction, int focusableMode) { 1246 // XXX-RTL: This will be fixed in a future CL 1247 if (mCurrentPage >= 0 && mCurrentPage < getPageCount()) { 1248 getPageAt(mCurrentPage).addFocusables(views, direction, focusableMode); 1249 } 1250 if (direction == View.FOCUS_LEFT) { 1251 if (mCurrentPage > 0) { 1252 getPageAt(mCurrentPage - 1).addFocusables(views, direction, focusableMode); 1253 } 1254 } else if (direction == View.FOCUS_RIGHT){ 1255 if (mCurrentPage < getPageCount() - 1) { 1256 getPageAt(mCurrentPage + 1).addFocusables(views, direction, focusableMode); 1257 } 1258 } 1259 } 1260 1261 /** 1262 * If one of our descendant views decides that it could be focused now, only 1263 * pass that along if it's on the current page. 1264 * 1265 * This happens when live folders requery, and if they're off page, they 1266 * end up calling requestFocus, which pulls it on page. 1267 */ 1268 @Override focusableViewAvailable(View focused)1269 public void focusableViewAvailable(View focused) { 1270 View current = getPageAt(mCurrentPage); 1271 View v = focused; 1272 while (true) { 1273 if (v == current) { 1274 super.focusableViewAvailable(focused); 1275 return; 1276 } 1277 if (v == this) { 1278 return; 1279 } 1280 ViewParent parent = v.getParent(); 1281 if (parent instanceof View) { 1282 v = (View)v.getParent(); 1283 } else { 1284 return; 1285 } 1286 } 1287 } 1288 1289 /** 1290 * {@inheritDoc} 1291 */ 1292 @Override requestDisallowInterceptTouchEvent(boolean disallowIntercept)1293 public void requestDisallowInterceptTouchEvent(boolean disallowIntercept) { 1294 if (disallowIntercept) { 1295 // We need to make sure to cancel our long press if 1296 // a scrollable widget takes over touch events 1297 final View currentPage = getPageAt(mCurrentPage); 1298 currentPage.cancelLongPress(); 1299 } 1300 super.requestDisallowInterceptTouchEvent(disallowIntercept); 1301 } 1302 1303 /** 1304 * Return true if a tap at (x, y) should trigger a flip to the previous page. 1305 */ hitsPreviousPage(float x, float y)1306 protected boolean hitsPreviousPage(float x, float y) { 1307 if (mIsRtl) { 1308 return (x > (getViewportOffsetX() + getViewportWidth() - 1309 getPaddingRight() - mPageSpacing)); 1310 } 1311 return (x < getViewportOffsetX() + getPaddingLeft() + mPageSpacing); 1312 } 1313 1314 /** 1315 * Return true if a tap at (x, y) should trigger a flip to the next page. 1316 */ hitsNextPage(float x, float y)1317 protected boolean hitsNextPage(float x, float y) { 1318 if (mIsRtl) { 1319 return (x < getViewportOffsetX() + getPaddingLeft() + mPageSpacing); 1320 } 1321 return (x > (getViewportOffsetX() + getViewportWidth() - 1322 getPaddingRight() - mPageSpacing)); 1323 } 1324 1325 /** Returns whether x and y originated within the buffered viewport */ isTouchPointInViewportWithBuffer(int x, int y)1326 private boolean isTouchPointInViewportWithBuffer(int x, int y) { 1327 sTmpRect.set(mViewport.left - mViewport.width() / 2, mViewport.top, 1328 mViewport.right + mViewport.width() / 2, mViewport.bottom); 1329 return sTmpRect.contains(x, y); 1330 } 1331 1332 @Override onInterceptTouchEvent(MotionEvent ev)1333 public boolean onInterceptTouchEvent(MotionEvent ev) { 1334 /* 1335 * This method JUST determines whether we want to intercept the motion. 1336 * If we return true, onTouchEvent will be called and we do the actual 1337 * scrolling there. 1338 */ 1339 acquireVelocityTrackerAndAddMovement(ev); 1340 1341 // Skip touch handling if there are no pages to swipe 1342 if (getChildCount() <= 0) return super.onInterceptTouchEvent(ev); 1343 1344 /* 1345 * Shortcut the most recurring case: the user is in the dragging 1346 * state and he is moving his finger. We want to intercept this 1347 * motion. 1348 */ 1349 final int action = ev.getAction(); 1350 if ((action == MotionEvent.ACTION_MOVE) && 1351 (mTouchState == TOUCH_STATE_SCROLLING)) { 1352 return true; 1353 } 1354 1355 switch (action & MotionEvent.ACTION_MASK) { 1356 case MotionEvent.ACTION_MOVE: { 1357 /* 1358 * mIsBeingDragged == false, otherwise the shortcut would have caught it. Check 1359 * whether the user has moved far enough from his original down touch. 1360 */ 1361 if (mActivePointerId != INVALID_POINTER) { 1362 determineScrollingStart(ev); 1363 } 1364 // if mActivePointerId is INVALID_POINTER, then we must have missed an ACTION_DOWN 1365 // event. in that case, treat the first occurence of a move event as a ACTION_DOWN 1366 // i.e. fall through to the next case (don't break) 1367 // (We sometimes miss ACTION_DOWN events in Workspace because it ignores all events 1368 // while it's small- this was causing a crash before we checked for INVALID_POINTER) 1369 break; 1370 } 1371 1372 case MotionEvent.ACTION_DOWN: { 1373 final float x = ev.getX(); 1374 final float y = ev.getY(); 1375 // Remember location of down touch 1376 mDownMotionX = x; 1377 mDownMotionY = y; 1378 mDownScrollX = getScrollX(); 1379 mLastMotionX = x; 1380 mLastMotionY = y; 1381 float[] p = mapPointFromViewToParent(this, x, y); 1382 mParentDownMotionX = p[0]; 1383 mParentDownMotionY = p[1]; 1384 mLastMotionXRemainder = 0; 1385 mTotalMotionX = 0; 1386 mActivePointerId = ev.getPointerId(0); 1387 1388 /* 1389 * If being flinged and user touches the screen, initiate drag; 1390 * otherwise don't. mScroller.isFinished should be false when 1391 * being flinged. 1392 */ 1393 final int xDist = Math.abs(mScroller.getFinalX() - mScroller.getCurrX()); 1394 final boolean finishedScrolling = (mScroller.isFinished() || xDist < mTouchSlop / 3); 1395 1396 if (finishedScrolling) { 1397 mTouchState = TOUCH_STATE_REST; 1398 if (!mScroller.isFinished() && !mFreeScroll) { 1399 setCurrentPage(getNextPage()); 1400 pageEndMoving(); 1401 } 1402 } else { 1403 if (isTouchPointInViewportWithBuffer((int) mDownMotionX, (int) mDownMotionY)) { 1404 mTouchState = TOUCH_STATE_SCROLLING; 1405 } else { 1406 mTouchState = TOUCH_STATE_REST; 1407 } 1408 } 1409 1410 break; 1411 } 1412 1413 case MotionEvent.ACTION_UP: 1414 case MotionEvent.ACTION_CANCEL: 1415 resetTouchState(); 1416 break; 1417 1418 case MotionEvent.ACTION_POINTER_UP: 1419 onSecondaryPointerUp(ev); 1420 releaseVelocityTracker(); 1421 break; 1422 } 1423 1424 /* 1425 * The only time we want to intercept motion events is if we are in the 1426 * drag mode. 1427 */ 1428 return mTouchState != TOUCH_STATE_REST; 1429 } 1430 determineScrollingStart(MotionEvent ev)1431 protected void determineScrollingStart(MotionEvent ev) { 1432 determineScrollingStart(ev, 1.0f); 1433 } 1434 1435 /* 1436 * Determines if we should change the touch state to start scrolling after the 1437 * user moves their touch point too far. 1438 */ determineScrollingStart(MotionEvent ev, float touchSlopScale)1439 protected void determineScrollingStart(MotionEvent ev, float touchSlopScale) { 1440 // Disallow scrolling if we don't have a valid pointer index 1441 final int pointerIndex = ev.findPointerIndex(mActivePointerId); 1442 if (pointerIndex == -1) return; 1443 1444 // Disallow scrolling if we started the gesture from outside the viewport 1445 final float x = ev.getX(pointerIndex); 1446 final float y = ev.getY(pointerIndex); 1447 if (!isTouchPointInViewportWithBuffer((int) x, (int) y)) return; 1448 1449 final int xDiff = (int) Math.abs(x - mLastMotionX); 1450 1451 final int touchSlop = Math.round(touchSlopScale * mTouchSlop); 1452 boolean xMoved = xDiff > touchSlop; 1453 1454 if (xMoved) { 1455 // Scroll if the user moved far enough along the X axis 1456 mTouchState = TOUCH_STATE_SCROLLING; 1457 mTotalMotionX += Math.abs(mLastMotionX - x); 1458 mLastMotionX = x; 1459 mLastMotionXRemainder = 0; 1460 mTouchX = getViewportOffsetX() + getScrollX(); 1461 mSmoothingTime = System.nanoTime() / NANOTIME_DIV; 1462 onScrollInteractionBegin(); 1463 pageBeginMoving(); 1464 } 1465 } 1466 cancelCurrentPageLongPress()1467 protected void cancelCurrentPageLongPress() { 1468 // Try canceling the long press. It could also have been scheduled 1469 // by a distant descendant, so use the mAllowLongPress flag to block 1470 // everything 1471 final View currentPage = getPageAt(mCurrentPage); 1472 if (currentPage != null) { 1473 currentPage.cancelLongPress(); 1474 } 1475 } 1476 getScrollProgress(int screenCenter, View v, int page)1477 protected float getScrollProgress(int screenCenter, View v, int page) { 1478 final int halfScreenSize = getViewportWidth() / 2; 1479 1480 int delta = screenCenter - (getScrollForPage(page) + halfScreenSize); 1481 int count = getChildCount(); 1482 1483 final int totalDistance; 1484 1485 int adjacentPage = page + 1; 1486 if ((delta < 0 && !mIsRtl) || (delta > 0 && mIsRtl)) { 1487 adjacentPage = page - 1; 1488 } 1489 1490 if (adjacentPage < 0 || adjacentPage > count - 1) { 1491 totalDistance = v.getMeasuredWidth() + mPageSpacing; 1492 } else { 1493 totalDistance = Math.abs(getScrollForPage(adjacentPage) - getScrollForPage(page)); 1494 } 1495 1496 float scrollProgress = delta / (totalDistance * 1.0f); 1497 scrollProgress = Math.min(scrollProgress, MAX_SCROLL_PROGRESS); 1498 scrollProgress = Math.max(scrollProgress, - MAX_SCROLL_PROGRESS); 1499 return scrollProgress; 1500 } 1501 getScrollForPage(int index)1502 public int getScrollForPage(int index) { 1503 if (mPageScrolls == null || index >= mPageScrolls.length || index < 0) { 1504 return 0; 1505 } else { 1506 return mPageScrolls[index]; 1507 } 1508 } 1509 1510 // While layout transitions are occurring, a child's position may stray from its baseline 1511 // position. This method returns the magnitude of this stray at any given time. getLayoutTransitionOffsetForPage(int index)1512 public int getLayoutTransitionOffsetForPage(int index) { 1513 if (mPageScrolls == null || index >= mPageScrolls.length || index < 0) { 1514 return 0; 1515 } else { 1516 View child = getChildAt(index); 1517 1518 int scrollOffset = 0; 1519 LayoutParams lp = (LayoutParams) child.getLayoutParams(); 1520 if (!lp.isFullScreenPage) { 1521 scrollOffset = mIsRtl ? getPaddingRight() : getPaddingLeft(); 1522 } 1523 1524 int baselineX = mPageScrolls[index] + scrollOffset + getViewportOffsetX(); 1525 return (int) (child.getX() - baselineX); 1526 } 1527 } 1528 dampedOverScroll(float amount)1529 protected void dampedOverScroll(float amount) { 1530 int screenSize = getViewportWidth(); 1531 float f = (amount / screenSize); 1532 if (f < 0) { 1533 mEdgeGlowLeft.onPull(-f); 1534 } else if (f > 0) { 1535 mEdgeGlowRight.onPull(f); 1536 } else { 1537 return; 1538 } 1539 invalidate(); 1540 } 1541 overScroll(float amount)1542 protected void overScroll(float amount) { 1543 dampedOverScroll(amount); 1544 } 1545 enableFreeScroll()1546 public void enableFreeScroll() { 1547 setEnableFreeScroll(true); 1548 } 1549 disableFreeScroll()1550 public void disableFreeScroll() { 1551 setEnableFreeScroll(false); 1552 } 1553 updateFreescrollBounds()1554 void updateFreescrollBounds() { 1555 getFreeScrollPageRange(mTempVisiblePagesRange); 1556 if (mIsRtl) { 1557 mFreeScrollMinScrollX = getScrollForPage(mTempVisiblePagesRange[1]); 1558 mFreeScrollMaxScrollX = getScrollForPage(mTempVisiblePagesRange[0]); 1559 } else { 1560 mFreeScrollMinScrollX = getScrollForPage(mTempVisiblePagesRange[0]); 1561 mFreeScrollMaxScrollX = getScrollForPage(mTempVisiblePagesRange[1]); 1562 } 1563 } 1564 setEnableFreeScroll(boolean freeScroll)1565 private void setEnableFreeScroll(boolean freeScroll) { 1566 mFreeScroll = freeScroll; 1567 1568 if (mFreeScroll) { 1569 updateFreescrollBounds(); 1570 getFreeScrollPageRange(mTempVisiblePagesRange); 1571 if (getCurrentPage() < mTempVisiblePagesRange[0]) { 1572 setCurrentPage(mTempVisiblePagesRange[0]); 1573 } else if (getCurrentPage() > mTempVisiblePagesRange[1]) { 1574 setCurrentPage(mTempVisiblePagesRange[1]); 1575 } 1576 } 1577 1578 setEnableOverscroll(!freeScroll); 1579 } 1580 setEnableOverscroll(boolean enable)1581 protected void setEnableOverscroll(boolean enable) { 1582 mAllowOverScroll = enable; 1583 } 1584 getNearestHoverOverPageIndex()1585 private int getNearestHoverOverPageIndex() { 1586 if (mDragView != null) { 1587 int dragX = (int) (mDragView.getLeft() + (mDragView.getMeasuredWidth() / 2) 1588 + mDragView.getTranslationX()); 1589 getFreeScrollPageRange(mTempVisiblePagesRange); 1590 int minDistance = Integer.MAX_VALUE; 1591 int minIndex = indexOfChild(mDragView); 1592 for (int i = mTempVisiblePagesRange[0]; i <= mTempVisiblePagesRange[1]; i++) { 1593 View page = getPageAt(i); 1594 int pageX = (int) (page.getLeft() + page.getMeasuredWidth() / 2); 1595 int d = Math.abs(dragX - pageX); 1596 if (d < minDistance) { 1597 minIndex = i; 1598 minDistance = d; 1599 } 1600 } 1601 return minIndex; 1602 } 1603 return -1; 1604 } 1605 1606 @Override onTouchEvent(MotionEvent ev)1607 public boolean onTouchEvent(MotionEvent ev) { 1608 super.onTouchEvent(ev); 1609 1610 // Skip touch handling if there are no pages to swipe 1611 if (getChildCount() <= 0) return super.onTouchEvent(ev); 1612 1613 acquireVelocityTrackerAndAddMovement(ev); 1614 1615 final int action = ev.getAction(); 1616 1617 switch (action & MotionEvent.ACTION_MASK) { 1618 case MotionEvent.ACTION_DOWN: 1619 /* 1620 * If being flinged and user touches, stop the fling. isFinished 1621 * will be false if being flinged. 1622 */ 1623 if (!mScroller.isFinished()) { 1624 abortScrollerAnimation(false); 1625 } 1626 1627 // Remember where the motion event started 1628 mDownMotionX = mLastMotionX = ev.getX(); 1629 mDownMotionY = mLastMotionY = ev.getY(); 1630 mDownScrollX = getScrollX(); 1631 float[] p = mapPointFromViewToParent(this, mLastMotionX, mLastMotionY); 1632 mParentDownMotionX = p[0]; 1633 mParentDownMotionY = p[1]; 1634 mLastMotionXRemainder = 0; 1635 mTotalMotionX = 0; 1636 mActivePointerId = ev.getPointerId(0); 1637 1638 if (mTouchState == TOUCH_STATE_SCROLLING) { 1639 onScrollInteractionBegin(); 1640 pageBeginMoving(); 1641 } 1642 break; 1643 1644 case MotionEvent.ACTION_MOVE: 1645 if (mTouchState == TOUCH_STATE_SCROLLING) { 1646 // Scroll to follow the motion event 1647 final int pointerIndex = ev.findPointerIndex(mActivePointerId); 1648 1649 if (pointerIndex == -1) return true; 1650 1651 final float x = ev.getX(pointerIndex); 1652 final float deltaX = mLastMotionX + mLastMotionXRemainder - x; 1653 1654 mTotalMotionX += Math.abs(deltaX); 1655 1656 // Only scroll and update mLastMotionX if we have moved some discrete amount. We 1657 // keep the remainder because we are actually testing if we've moved from the last 1658 // scrolled position (which is discrete). 1659 if (Math.abs(deltaX) >= 1.0f) { 1660 mTouchX += deltaX; 1661 mSmoothingTime = System.nanoTime() / NANOTIME_DIV; 1662 scrollBy((int) deltaX, 0); 1663 mLastMotionX = x; 1664 mLastMotionXRemainder = deltaX - (int) deltaX; 1665 } else { 1666 awakenScrollBars(); 1667 } 1668 } else if (mTouchState == TOUCH_STATE_REORDERING) { 1669 // Update the last motion position 1670 mLastMotionX = ev.getX(); 1671 mLastMotionY = ev.getY(); 1672 1673 // Update the parent down so that our zoom animations take this new movement into 1674 // account 1675 float[] pt = mapPointFromViewToParent(this, mLastMotionX, mLastMotionY); 1676 mParentDownMotionX = pt[0]; 1677 mParentDownMotionY = pt[1]; 1678 updateDragViewTranslationDuringDrag(); 1679 1680 // Find the closest page to the touch point 1681 final int dragViewIndex = indexOfChild(mDragView); 1682 1683 if (DEBUG) Log.d(TAG, "mLastMotionX: " + mLastMotionX); 1684 if (DEBUG) Log.d(TAG, "mLastMotionY: " + mLastMotionY); 1685 if (DEBUG) Log.d(TAG, "mParentDownMotionX: " + mParentDownMotionX); 1686 if (DEBUG) Log.d(TAG, "mParentDownMotionY: " + mParentDownMotionY); 1687 1688 final int pageUnderPointIndex = getNearestHoverOverPageIndex(); 1689 if (pageUnderPointIndex > -1 && pageUnderPointIndex != indexOfChild(mDragView)) { 1690 mTempVisiblePagesRange[0] = 0; 1691 mTempVisiblePagesRange[1] = getPageCount() - 1; 1692 getFreeScrollPageRange(mTempVisiblePagesRange); 1693 if (mTempVisiblePagesRange[0] <= pageUnderPointIndex && 1694 pageUnderPointIndex <= mTempVisiblePagesRange[1] && 1695 pageUnderPointIndex != mSidePageHoverIndex && mScroller.isFinished()) { 1696 mSidePageHoverIndex = pageUnderPointIndex; 1697 mSidePageHoverRunnable = new Runnable() { 1698 @Override 1699 public void run() { 1700 // Setup the scroll to the correct page before we swap the views 1701 snapToPage(pageUnderPointIndex); 1702 1703 // For each of the pages between the paged view and the drag view, 1704 // animate them from the previous position to the new position in 1705 // the layout (as a result of the drag view moving in the layout) 1706 int shiftDelta = (dragViewIndex < pageUnderPointIndex) ? -1 : 1; 1707 int lowerIndex = (dragViewIndex < pageUnderPointIndex) ? 1708 dragViewIndex + 1 : pageUnderPointIndex; 1709 int upperIndex = (dragViewIndex > pageUnderPointIndex) ? 1710 dragViewIndex - 1 : pageUnderPointIndex; 1711 for (int i = lowerIndex; i <= upperIndex; ++i) { 1712 View v = getChildAt(i); 1713 // dragViewIndex < pageUnderPointIndex, so after we remove the 1714 // drag view all subsequent views to pageUnderPointIndex will 1715 // shift down. 1716 int oldX = getViewportOffsetX() + getChildOffset(i); 1717 int newX = getViewportOffsetX() + getChildOffset(i + shiftDelta); 1718 1719 // Animate the view translation from its old position to its new 1720 // position 1721 AnimatorSet anim = (AnimatorSet) v.getTag(ANIM_TAG_KEY); 1722 if (anim != null) { 1723 anim.cancel(); 1724 } 1725 1726 v.setTranslationX(oldX - newX); 1727 anim = new AnimatorSet(); 1728 anim.setDuration(REORDERING_REORDER_REPOSITION_DURATION); 1729 anim.playTogether( 1730 ObjectAnimator.ofFloat(v, "translationX", 0f)); 1731 anim.start(); 1732 v.setTag(anim); 1733 } 1734 1735 removeView(mDragView); 1736 addView(mDragView, pageUnderPointIndex); 1737 mSidePageHoverIndex = -1; 1738 if (mPageIndicator != null) { 1739 mPageIndicator.setActiveMarker(getNextPage()); 1740 } 1741 } 1742 }; 1743 postDelayed(mSidePageHoverRunnable, REORDERING_SIDE_PAGE_HOVER_TIMEOUT); 1744 } 1745 } else { 1746 removeCallbacks(mSidePageHoverRunnable); 1747 mSidePageHoverIndex = -1; 1748 } 1749 } else { 1750 determineScrollingStart(ev); 1751 } 1752 break; 1753 1754 case MotionEvent.ACTION_UP: 1755 if (mTouchState == TOUCH_STATE_SCROLLING) { 1756 final int activePointerId = mActivePointerId; 1757 final int pointerIndex = ev.findPointerIndex(activePointerId); 1758 final float x = ev.getX(pointerIndex); 1759 final VelocityTracker velocityTracker = mVelocityTracker; 1760 velocityTracker.computeCurrentVelocity(1000, mMaximumVelocity); 1761 int velocityX = (int) velocityTracker.getXVelocity(activePointerId); 1762 final int deltaX = (int) (x - mDownMotionX); 1763 final int pageWidth = getPageAt(mCurrentPage).getMeasuredWidth(); 1764 boolean isSignificantMove = Math.abs(deltaX) > pageWidth * 1765 SIGNIFICANT_MOVE_THRESHOLD; 1766 1767 mTotalMotionX += Math.abs(mLastMotionX + mLastMotionXRemainder - x); 1768 1769 boolean isFling = mTotalMotionX > MIN_LENGTH_FOR_FLING && 1770 Math.abs(velocityX) > mFlingThresholdVelocity; 1771 1772 if (!mFreeScroll) { 1773 // In the case that the page is moved far to one direction and then is flung 1774 // in the opposite direction, we use a threshold to determine whether we should 1775 // just return to the starting page, or if we should skip one further. 1776 boolean returnToOriginalPage = false; 1777 if (Math.abs(deltaX) > pageWidth * RETURN_TO_ORIGINAL_PAGE_THRESHOLD && 1778 Math.signum(velocityX) != Math.signum(deltaX) && isFling) { 1779 returnToOriginalPage = true; 1780 } 1781 1782 int finalPage; 1783 // We give flings precedence over large moves, which is why we short-circuit our 1784 // test for a large move if a fling has been registered. That is, a large 1785 // move to the left and fling to the right will register as a fling to the right. 1786 boolean isDeltaXLeft = mIsRtl ? deltaX > 0 : deltaX < 0; 1787 boolean isVelocityXLeft = mIsRtl ? velocityX > 0 : velocityX < 0; 1788 if (((isSignificantMove && !isDeltaXLeft && !isFling) || 1789 (isFling && !isVelocityXLeft)) && mCurrentPage > 0) { 1790 finalPage = returnToOriginalPage ? mCurrentPage : mCurrentPage - 1; 1791 snapToPageWithVelocity(finalPage, velocityX); 1792 } else if (((isSignificantMove && isDeltaXLeft && !isFling) || 1793 (isFling && isVelocityXLeft)) && 1794 mCurrentPage < getChildCount() - 1) { 1795 finalPage = returnToOriginalPage ? mCurrentPage : mCurrentPage + 1; 1796 snapToPageWithVelocity(finalPage, velocityX); 1797 } else { 1798 snapToDestination(); 1799 } 1800 } else { 1801 if (!mScroller.isFinished()) { 1802 abortScrollerAnimation(true); 1803 } 1804 1805 float scaleX = getScaleX(); 1806 int vX = (int) (-velocityX * scaleX); 1807 int initialScrollX = (int) (getScrollX() * scaleX); 1808 1809 mScroller.setInterpolator(mDefaultInterpolator); 1810 mScroller.fling(initialScrollX, 1811 getScrollY(), vX, 0, Integer.MIN_VALUE, Integer.MAX_VALUE, 0, 0); 1812 invalidate(); 1813 } 1814 onScrollInteractionEnd(); 1815 } else if (mTouchState == TOUCH_STATE_PREV_PAGE) { 1816 // at this point we have not moved beyond the touch slop 1817 // (otherwise mTouchState would be TOUCH_STATE_SCROLLING), so 1818 // we can just page 1819 int nextPage = Math.max(0, mCurrentPage - 1); 1820 if (nextPage != mCurrentPage) { 1821 snapToPage(nextPage); 1822 } else { 1823 snapToDestination(); 1824 } 1825 } else if (mTouchState == TOUCH_STATE_NEXT_PAGE) { 1826 // at this point we have not moved beyond the touch slop 1827 // (otherwise mTouchState would be TOUCH_STATE_SCROLLING), so 1828 // we can just page 1829 int nextPage = Math.min(getChildCount() - 1, mCurrentPage + 1); 1830 if (nextPage != mCurrentPage) { 1831 snapToPage(nextPage); 1832 } else { 1833 snapToDestination(); 1834 } 1835 } else if (mTouchState == TOUCH_STATE_REORDERING) { 1836 // Update the last motion position 1837 mLastMotionX = ev.getX(); 1838 mLastMotionY = ev.getY(); 1839 1840 // Update the parent down so that our zoom animations take this new movement into 1841 // account 1842 float[] pt = mapPointFromViewToParent(this, mLastMotionX, mLastMotionY); 1843 mParentDownMotionX = pt[0]; 1844 mParentDownMotionY = pt[1]; 1845 updateDragViewTranslationDuringDrag(); 1846 } else { 1847 if (!mCancelTap) { 1848 onUnhandledTap(ev); 1849 } 1850 } 1851 1852 // Remove the callback to wait for the side page hover timeout 1853 removeCallbacks(mSidePageHoverRunnable); 1854 // End any intermediate reordering states 1855 resetTouchState(); 1856 break; 1857 1858 case MotionEvent.ACTION_CANCEL: 1859 if (mTouchState == TOUCH_STATE_SCROLLING) { 1860 snapToDestination(); 1861 } 1862 resetTouchState(); 1863 break; 1864 1865 case MotionEvent.ACTION_POINTER_UP: 1866 onSecondaryPointerUp(ev); 1867 releaseVelocityTracker(); 1868 break; 1869 } 1870 1871 return true; 1872 } 1873 resetTouchState()1874 private void resetTouchState() { 1875 releaseVelocityTracker(); 1876 endReordering(); 1877 mCancelTap = false; 1878 mTouchState = TOUCH_STATE_REST; 1879 mActivePointerId = INVALID_POINTER; 1880 mEdgeGlowLeft.onRelease(); 1881 mEdgeGlowRight.onRelease(); 1882 } 1883 1884 /** 1885 * Triggered by scrolling via touch 1886 */ onScrollInteractionBegin()1887 protected void onScrollInteractionBegin() { 1888 } 1889 onScrollInteractionEnd()1890 protected void onScrollInteractionEnd() { 1891 } 1892 onUnhandledTap(MotionEvent ev)1893 protected void onUnhandledTap(MotionEvent ev) { 1894 ((Launcher) getContext()).onClick(this); 1895 } 1896 1897 @Override onGenericMotionEvent(MotionEvent event)1898 public boolean onGenericMotionEvent(MotionEvent event) { 1899 if ((event.getSource() & InputDevice.SOURCE_CLASS_POINTER) != 0) { 1900 switch (event.getAction()) { 1901 case MotionEvent.ACTION_SCROLL: { 1902 // Handle mouse (or ext. device) by shifting the page depending on the scroll 1903 final float vscroll; 1904 final float hscroll; 1905 if ((event.getMetaState() & KeyEvent.META_SHIFT_ON) != 0) { 1906 vscroll = 0; 1907 hscroll = event.getAxisValue(MotionEvent.AXIS_VSCROLL); 1908 } else { 1909 vscroll = -event.getAxisValue(MotionEvent.AXIS_VSCROLL); 1910 hscroll = event.getAxisValue(MotionEvent.AXIS_HSCROLL); 1911 } 1912 if (hscroll != 0 || vscroll != 0) { 1913 boolean isForwardScroll = mIsRtl ? (hscroll < 0 || vscroll < 0) 1914 : (hscroll > 0 || vscroll > 0); 1915 if (isForwardScroll) { 1916 scrollRight(); 1917 } else { 1918 scrollLeft(); 1919 } 1920 return true; 1921 } 1922 } 1923 } 1924 } 1925 return super.onGenericMotionEvent(event); 1926 } 1927 acquireVelocityTrackerAndAddMovement(MotionEvent ev)1928 private void acquireVelocityTrackerAndAddMovement(MotionEvent ev) { 1929 if (mVelocityTracker == null) { 1930 mVelocityTracker = VelocityTracker.obtain(); 1931 } 1932 mVelocityTracker.addMovement(ev); 1933 } 1934 releaseVelocityTracker()1935 private void releaseVelocityTracker() { 1936 if (mVelocityTracker != null) { 1937 mVelocityTracker.clear(); 1938 mVelocityTracker.recycle(); 1939 mVelocityTracker = null; 1940 } 1941 } 1942 onSecondaryPointerUp(MotionEvent ev)1943 private void onSecondaryPointerUp(MotionEvent ev) { 1944 final int pointerIndex = (ev.getAction() & MotionEvent.ACTION_POINTER_INDEX_MASK) >> 1945 MotionEvent.ACTION_POINTER_INDEX_SHIFT; 1946 final int pointerId = ev.getPointerId(pointerIndex); 1947 if (pointerId == mActivePointerId) { 1948 // This was our active pointer going up. Choose a new 1949 // active pointer and adjust accordingly. 1950 // TODO: Make this decision more intelligent. 1951 final int newPointerIndex = pointerIndex == 0 ? 1 : 0; 1952 mLastMotionX = mDownMotionX = ev.getX(newPointerIndex); 1953 mLastMotionY = ev.getY(newPointerIndex); 1954 mLastMotionXRemainder = 0; 1955 mActivePointerId = ev.getPointerId(newPointerIndex); 1956 if (mVelocityTracker != null) { 1957 mVelocityTracker.clear(); 1958 } 1959 } 1960 } 1961 1962 @Override requestChildFocus(View child, View focused)1963 public void requestChildFocus(View child, View focused) { 1964 super.requestChildFocus(child, focused); 1965 int page = indexToPage(indexOfChild(child)); 1966 if (page >= 0 && page != getCurrentPage() && !isInTouchMode()) { 1967 snapToPage(page); 1968 } 1969 } 1970 getPageNearestToCenterOfScreen()1971 int getPageNearestToCenterOfScreen() { 1972 int minDistanceFromScreenCenter = Integer.MAX_VALUE; 1973 int minDistanceFromScreenCenterIndex = -1; 1974 int screenCenter = getViewportOffsetX() + getScrollX() + (getViewportWidth() / 2); 1975 final int childCount = getChildCount(); 1976 for (int i = 0; i < childCount; ++i) { 1977 View layout = (View) getPageAt(i); 1978 int childWidth = layout.getMeasuredWidth(); 1979 int halfChildWidth = (childWidth / 2); 1980 int childCenter = getViewportOffsetX() + getChildOffset(i) + halfChildWidth; 1981 int distanceFromScreenCenter = Math.abs(childCenter - screenCenter); 1982 if (distanceFromScreenCenter < minDistanceFromScreenCenter) { 1983 minDistanceFromScreenCenter = distanceFromScreenCenter; 1984 minDistanceFromScreenCenterIndex = i; 1985 } 1986 } 1987 return minDistanceFromScreenCenterIndex; 1988 } 1989 snapToDestination()1990 protected void snapToDestination() { 1991 snapToPage(getPageNearestToCenterOfScreen(), PAGE_SNAP_ANIMATION_DURATION); 1992 } 1993 1994 private static class ScrollInterpolator implements Interpolator { ScrollInterpolator()1995 public ScrollInterpolator() { 1996 } 1997 getInterpolation(float t)1998 public float getInterpolation(float t) { 1999 t -= 1.0f; 2000 return t*t*t*t*t + 1; 2001 } 2002 } 2003 2004 // We want the duration of the page snap animation to be influenced by the distance that 2005 // the screen has to travel, however, we don't want this duration to be effected in a 2006 // purely linear fashion. Instead, we use this method to moderate the effect that the distance 2007 // of travel has on the overall snap duration. distanceInfluenceForSnapDuration(float f)2008 private float distanceInfluenceForSnapDuration(float f) { 2009 f -= 0.5f; // center the values about 0. 2010 f *= 0.3f * Math.PI / 2.0f; 2011 return (float) Math.sin(f); 2012 } 2013 snapToPageWithVelocity(int whichPage, int velocity)2014 protected void snapToPageWithVelocity(int whichPage, int velocity) { 2015 whichPage = validateNewPage(whichPage); 2016 int halfScreenSize = getViewportWidth() / 2; 2017 2018 final int newX = getScrollForPage(whichPage); 2019 int delta = newX - getUnboundedScrollX(); 2020 int duration = 0; 2021 2022 if (Math.abs(velocity) < mMinFlingVelocity) { 2023 // If the velocity is low enough, then treat this more as an automatic page advance 2024 // as opposed to an apparent physical response to flinging 2025 snapToPage(whichPage, PAGE_SNAP_ANIMATION_DURATION); 2026 return; 2027 } 2028 2029 // Here we compute a "distance" that will be used in the computation of the overall 2030 // snap duration. This is a function of the actual distance that needs to be traveled; 2031 // we keep this value close to half screen size in order to reduce the variance in snap 2032 // duration as a function of the distance the page needs to travel. 2033 float distanceRatio = Math.min(1f, 1.0f * Math.abs(delta) / (2 * halfScreenSize)); 2034 float distance = halfScreenSize + halfScreenSize * 2035 distanceInfluenceForSnapDuration(distanceRatio); 2036 2037 velocity = Math.abs(velocity); 2038 velocity = Math.max(mMinSnapVelocity, velocity); 2039 2040 // we want the page's snap velocity to approximately match the velocity at which the 2041 // user flings, so we scale the duration by a value near to the derivative of the scroll 2042 // interpolator at zero, ie. 5. We use 4 to make it a little slower. 2043 duration = 4 * Math.round(1000 * Math.abs(distance / velocity)); 2044 2045 snapToPage(whichPage, delta, duration); 2046 } 2047 snapToPage(int whichPage)2048 public void snapToPage(int whichPage) { 2049 snapToPage(whichPage, PAGE_SNAP_ANIMATION_DURATION); 2050 } 2051 snapToPageImmediately(int whichPage)2052 protected void snapToPageImmediately(int whichPage) { 2053 snapToPage(whichPage, PAGE_SNAP_ANIMATION_DURATION, true, null); 2054 } 2055 snapToPage(int whichPage, int duration)2056 protected void snapToPage(int whichPage, int duration) { 2057 snapToPage(whichPage, duration, false, null); 2058 } 2059 snapToPage(int whichPage, int duration, TimeInterpolator interpolator)2060 protected void snapToPage(int whichPage, int duration, TimeInterpolator interpolator) { 2061 snapToPage(whichPage, duration, false, interpolator); 2062 } 2063 snapToPage(int whichPage, int duration, boolean immediate, TimeInterpolator interpolator)2064 protected void snapToPage(int whichPage, int duration, boolean immediate, 2065 TimeInterpolator interpolator) { 2066 whichPage = validateNewPage(whichPage); 2067 2068 int newX = getScrollForPage(whichPage); 2069 final int delta = newX - getUnboundedScrollX(); 2070 snapToPage(whichPage, delta, duration, immediate, interpolator); 2071 } 2072 snapToPage(int whichPage, int delta, int duration)2073 protected void snapToPage(int whichPage, int delta, int duration) { 2074 snapToPage(whichPage, delta, duration, false, null); 2075 } 2076 snapToPage(int whichPage, int delta, int duration, boolean immediate, TimeInterpolator interpolator)2077 protected void snapToPage(int whichPage, int delta, int duration, boolean immediate, 2078 TimeInterpolator interpolator) { 2079 whichPage = validateNewPage(whichPage); 2080 2081 mNextPage = whichPage; 2082 2083 pageBeginMoving(); 2084 awakenScrollBars(duration); 2085 if (immediate) { 2086 duration = 0; 2087 } else if (duration == 0) { 2088 duration = Math.abs(delta); 2089 } 2090 2091 if (!mScroller.isFinished()) { 2092 abortScrollerAnimation(false); 2093 } 2094 2095 if (interpolator != null) { 2096 mScroller.setInterpolator(interpolator); 2097 } else { 2098 mScroller.setInterpolator(mDefaultInterpolator); 2099 } 2100 2101 mScroller.startScroll(getUnboundedScrollX(), 0, delta, 0, duration); 2102 2103 updatePageIndicator(); 2104 2105 // Trigger a compute() to finish switching pages if necessary 2106 if (immediate) { 2107 computeScroll(); 2108 } 2109 2110 mForceScreenScrolled = true; 2111 invalidate(); 2112 } 2113 scrollLeft()2114 public void scrollLeft() { 2115 if (getNextPage() > 0) snapToPage(getNextPage() - 1); 2116 } 2117 scrollRight()2118 public void scrollRight() { 2119 if (getNextPage() < getChildCount() -1) snapToPage(getNextPage() + 1); 2120 } 2121 getPageForView(View v)2122 public int getPageForView(View v) { 2123 int result = -1; 2124 if (v != null) { 2125 ViewParent vp = v.getParent(); 2126 int count = getChildCount(); 2127 for (int i = 0; i < count; i++) { 2128 if (vp == getPageAt(i)) { 2129 return i; 2130 } 2131 } 2132 } 2133 return result; 2134 } 2135 2136 @Override performLongClick()2137 public boolean performLongClick() { 2138 mCancelTap = true; 2139 return super.performLongClick(); 2140 } 2141 2142 public static class SavedState extends BaseSavedState { 2143 int currentPage = -1; 2144 SavedState(Parcelable superState)2145 SavedState(Parcelable superState) { 2146 super(superState); 2147 } 2148 SavedState(Parcel in)2149 @Thunk SavedState(Parcel in) { 2150 super(in); 2151 currentPage = in.readInt(); 2152 } 2153 2154 @Override writeToParcel(Parcel out, int flags)2155 public void writeToParcel(Parcel out, int flags) { 2156 super.writeToParcel(out, flags); 2157 out.writeInt(currentPage); 2158 } 2159 2160 public static final Parcelable.Creator<SavedState> CREATOR = 2161 new Parcelable.Creator<SavedState>() { 2162 public SavedState createFromParcel(Parcel in) { 2163 return new SavedState(in); 2164 } 2165 2166 public SavedState[] newArray(int size) { 2167 return new SavedState[size]; 2168 } 2169 }; 2170 } 2171 2172 // Animate the drag view back to the original position animateDragViewToOriginalPosition()2173 private void animateDragViewToOriginalPosition() { 2174 if (mDragView != null) { 2175 AnimatorSet anim = new AnimatorSet(); 2176 anim.setDuration(REORDERING_DROP_REPOSITION_DURATION); 2177 anim.playTogether( 2178 ObjectAnimator.ofFloat(mDragView, "translationX", 0f), 2179 ObjectAnimator.ofFloat(mDragView, "translationY", 0f), 2180 ObjectAnimator.ofFloat(mDragView, "scaleX", 1f), 2181 ObjectAnimator.ofFloat(mDragView, "scaleY", 1f)); 2182 anim.addListener(new AnimatorListenerAdapter() { 2183 @Override 2184 public void onAnimationEnd(Animator animation) { 2185 onPostReorderingAnimationCompleted(); 2186 } 2187 }); 2188 anim.start(); 2189 } 2190 } 2191 onStartReordering()2192 public void onStartReordering() { 2193 // Set the touch state to reordering (allows snapping to pages, dragging a child, etc.) 2194 mTouchState = TOUCH_STATE_REORDERING; 2195 mIsReordering = true; 2196 2197 // We must invalidate to trigger a redraw to update the layers such that the drag view 2198 // is always drawn on top 2199 invalidate(); 2200 } 2201 onPostReorderingAnimationCompleted()2202 @Thunk void onPostReorderingAnimationCompleted() { 2203 // Trigger the callback when reordering has settled 2204 --mPostReorderingPreZoomInRemainingAnimationCount; 2205 if (mPostReorderingPreZoomInRunnable != null && 2206 mPostReorderingPreZoomInRemainingAnimationCount == 0) { 2207 mPostReorderingPreZoomInRunnable.run(); 2208 mPostReorderingPreZoomInRunnable = null; 2209 } 2210 } 2211 onEndReordering()2212 public void onEndReordering() { 2213 mIsReordering = false; 2214 } 2215 startReordering(View v)2216 public boolean startReordering(View v) { 2217 int dragViewIndex = indexOfChild(v); 2218 2219 if (mTouchState != TOUCH_STATE_REST || dragViewIndex == -1) return false; 2220 2221 mTempVisiblePagesRange[0] = 0; 2222 mTempVisiblePagesRange[1] = getPageCount() - 1; 2223 getFreeScrollPageRange(mTempVisiblePagesRange); 2224 mReorderingStarted = true; 2225 2226 // Check if we are within the reordering range 2227 if (mTempVisiblePagesRange[0] <= dragViewIndex && 2228 dragViewIndex <= mTempVisiblePagesRange[1]) { 2229 // Find the drag view under the pointer 2230 mDragView = getChildAt(dragViewIndex); 2231 mDragView.animate().scaleX(1.15f).scaleY(1.15f).setDuration(100).start(); 2232 mDragViewBaselineLeft = mDragView.getLeft(); 2233 snapToPage(getPageNearestToCenterOfScreen()); 2234 disableFreeScroll(); 2235 onStartReordering(); 2236 return true; 2237 } 2238 return false; 2239 } 2240 isReordering(boolean testTouchState)2241 boolean isReordering(boolean testTouchState) { 2242 boolean state = mIsReordering; 2243 if (testTouchState) { 2244 state &= (mTouchState == TOUCH_STATE_REORDERING); 2245 } 2246 return state; 2247 } endReordering()2248 void endReordering() { 2249 // For simplicity, we call endReordering sometimes even if reordering was never started. 2250 // In that case, we don't want to do anything. 2251 if (!mReorderingStarted) return; 2252 mReorderingStarted = false; 2253 2254 // If we haven't flung-to-delete the current child, then we just animate the drag view 2255 // back into position 2256 final Runnable onCompleteRunnable = new Runnable() { 2257 @Override 2258 public void run() { 2259 onEndReordering(); 2260 } 2261 }; 2262 2263 mPostReorderingPreZoomInRunnable = new Runnable() { 2264 public void run() { 2265 onCompleteRunnable.run(); 2266 enableFreeScroll(); 2267 }; 2268 }; 2269 2270 mPostReorderingPreZoomInRemainingAnimationCount = 2271 NUM_ANIMATIONS_RUNNING_BEFORE_ZOOM_OUT; 2272 // Snap to the current page 2273 snapToPage(indexOfChild(mDragView), 0); 2274 // Animate the drag view back to the front position 2275 animateDragViewToOriginalPosition(); 2276 } 2277 2278 private static final int ANIM_TAG_KEY = 100; 2279 2280 /* Accessibility */ 2281 @TargetApi(Build.VERSION_CODES.LOLLIPOP) 2282 @Override onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo info)2283 public void onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo info) { 2284 super.onInitializeAccessibilityNodeInfo(info); 2285 info.setScrollable(getPageCount() > 1); 2286 if (getCurrentPage() < getPageCount() - 1) { 2287 info.addAction(AccessibilityNodeInfo.ACTION_SCROLL_FORWARD); 2288 } 2289 if (getCurrentPage() > 0) { 2290 info.addAction(AccessibilityNodeInfo.ACTION_SCROLL_BACKWARD); 2291 } 2292 info.setClassName(getClass().getName()); 2293 2294 // Accessibility-wise, PagedView doesn't support long click, so disabling it. 2295 // Besides disabling the accessibility long-click, this also prevents this view from getting 2296 // accessibility focus. 2297 info.setLongClickable(false); 2298 if (Utilities.ATLEAST_LOLLIPOP) { 2299 info.removeAction(AccessibilityNodeInfo.AccessibilityAction.ACTION_LONG_CLICK); 2300 } 2301 } 2302 2303 @Override sendAccessibilityEvent(int eventType)2304 public void sendAccessibilityEvent(int eventType) { 2305 // Don't let the view send real scroll events. 2306 if (eventType != AccessibilityEvent.TYPE_VIEW_SCROLLED) { 2307 super.sendAccessibilityEvent(eventType); 2308 } 2309 } 2310 2311 @Override onInitializeAccessibilityEvent(AccessibilityEvent event)2312 public void onInitializeAccessibilityEvent(AccessibilityEvent event) { 2313 super.onInitializeAccessibilityEvent(event); 2314 event.setScrollable(getPageCount() > 1); 2315 } 2316 2317 @Override performAccessibilityAction(int action, Bundle arguments)2318 public boolean performAccessibilityAction(int action, Bundle arguments) { 2319 if (super.performAccessibilityAction(action, arguments)) { 2320 return true; 2321 } 2322 switch (action) { 2323 case AccessibilityNodeInfo.ACTION_SCROLL_FORWARD: { 2324 if (getCurrentPage() < getPageCount() - 1) { 2325 scrollRight(); 2326 return true; 2327 } 2328 } break; 2329 case AccessibilityNodeInfo.ACTION_SCROLL_BACKWARD: { 2330 if (getCurrentPage() > 0) { 2331 scrollLeft(); 2332 return true; 2333 } 2334 } break; 2335 } 2336 return false; 2337 } 2338 getCurrentPageDescription()2339 protected String getCurrentPageDescription() { 2340 return String.format(getContext().getString(R.string.default_scroll_format), 2341 getNextPage() + 1, getChildCount()); 2342 } 2343 2344 @Override onHoverEvent(android.view.MotionEvent event)2345 public boolean onHoverEvent(android.view.MotionEvent event) { 2346 return true; 2347 } 2348 } 2349