Launcher源码学习 PageView中的ScrollIndicator分页指示器

           看Launcher2源码忽然看到分页指示器，想看看源码，于是记录下看代码的过程

           直接看代码了，Launcher2中的PageView.java可以说是Launcher2中非常核心的代码了，因为可以说Launcher2的页面显示和滑动可以说是支撑了整个Launcher风格的一个核心，因此很多人在应用中都会参考PageView的很多地方做滑动或者页面显示等操作。

           今天看的是其中一个功能，分页指示器的代码，先看Launcher.xml中的布局

           

    <include
        android:id="@+id/paged_view_indicator"
        layout="@layout/scroll_indicator"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="bottom" />

          可以看到是在整个布局中添加了一个指示器的布局，其实这个布局很简单就是一个ImageView，接着看scroll_indicator.xml

       

<ImageView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:visibility="gone"
    android:alpha="0"
    android:scaleType="fitXY"
    android:src="@drawable/hotseat_scrubber_holo" />

        看到这里就可以直接看下原图了，可以发现是一张.9的图片，此刻才发现原来这个指示器的图片是由一张.9图用fitXY的样式横向拉宽并分为5个指示器图片用来表示当前页。

        说道fitXY这个属性有必要看下这个地方，下面的是论坛博友总结的，如果不是很清楚可以自己动手设置下这些属性来看效果。

         

     android:scaleType是控制图片如何resized/moved来匹对ImageView的size。

     ImageView.ScaleType / android:scaleType值的意义区别：

     CENTER /center  按图片的原来size居中显示，当图片长/宽超过View的长/宽，则截取图片的居中部分显示

     CENTER_CROP / centerCrop  按比例扩大图片的size居中显示，使得图片长(宽)等于或大于View的长(宽)

     CENTER_INSIDE / centerInside  将图片的内容完整居中显示，通过按比例缩小或原来的size使得图片长/宽等于或小于View的长/宽

     FIT_CENTER / fitCenter  把图片按比例扩大/缩小到View的宽度，居中显示

     FIT_END / fitEnd   把图片按比例扩大/缩小到View的宽度，显示在View的下部分位置

     FIT_START / fitStart  把图片按比例扩大/缩小到View的宽度，显示在View的上部分位置

     FIT_XY / fitXY  把图片不按比例扩大/缩小到View的大小显示

     MATRIX / matrix 用矩阵来绘制，动态缩小放大图片来显示。

        接着看代码，这回看到的就是分页指示器View的初始状态了，因为launcher2中默认的分页指示器是不显示的，只有在滑动的时候指示器才会显示，因此并不会在最开始的时候就给予初始化和设置可见，而是在后面滑动的时候动态更新指示器位置和状态，等滑动停止则继续隐藏。

        

    protected View getScrollingIndicator() {
        // We use mHasScrollIndicator to prevent future lookups if there is no sibling indicator
        // found
        if (mHasScrollIndicator && mScrollIndicator == null) {
            ViewGroup parent = (ViewGroup) getParent();
            if (parent != null) {
                mScrollIndicator = (View) (parent.findViewById(R.id.paged_view_indicator));
                mHasScrollIndicator = mScrollIndicator != null;
                if (mHasScrollIndicator) {
                    mScrollIndicator.setVisibility(View.VISIBLE);
                }
            }
        }
        return mScrollIndicator;
    }

       接下来是更新指示器的代码

       

    private void updateScrollingIndicator() {
        if (getChildCount() <= 1) return;
        if (!isScrollingIndicatorEnabled()) return;

        getScrollingIndicator();
        if (mScrollIndicator != null) {
            updateScrollingIndicatorPosition();
        }
        if (mShouldShowScrollIndicator) {
            showScrollingIndicator(mShouldShowScrollIndicatorImmediately);
        }
    }

       其中updateScrollingIndicatorPosition这个函数是设置和更新指示器详细参数的函数

       

    private void updateScrollingIndicatorPosition() {
        if (!isScrollingIndicatorEnabled()) return;
        if (mScrollIndicator == null) return;
        int numPages = getChildCount();
        int pageWidth = getMeasuredWidth();
        int lastChildIndex = Math.max(0, getChildCount() - 1);
        int maxScrollX = getChildOffset(lastChildIndex) - getRelativeChildOffset(lastChildIndex);
        int trackWidth = pageWidth - mScrollIndicatorPaddingLeft - mScrollIndicatorPaddingRight;
        int indicatorWidth = mScrollIndicator.getMeasuredWidth() -
                mScrollIndicator.getPaddingLeft() - mScrollIndicator.getPaddingRight();

        float offset = Math.max(0f, Math.min(1f, (float) getScrollX() / maxScrollX));
        int indicatorSpace = trackWidth / numPages;
        int indicatorPos = (int) (offset * (trackWidth - indicatorSpace)) + mScrollIndicatorPaddingLeft;
        if (hasElasticScrollIndicator()) {
            if (mScrollIndicator.getMeasuredWidth() != indicatorSpace) {
                mScrollIndicator.getLayoutParams().width = indicatorSpace;
                mScrollIndicator.requestLayout();
            }
        } else {
            int indicatorCenterOffset = indicatorSpace / 2 - indicatorWidth / 2;
            indicatorPos += indicatorCenterOffset;
        }
        mScrollIndicator.setTranslationX(indicatorPos);
    }

         可以大概看出其中的重要参数的意义，

        pageWidth  是当前显示的页的宽度，即我们launcher中workspace显示的那个区域宽度

        trackWidth  是实际指示器需要显示的范围宽度

        indicatorSpace 是每个单独的指示器图片的实际显示宽度

        indicatorPos 是实际的指示器图片显示位置偏移量

       以上就是指示器的显示和更新的详细设置了，另外就是每次翻页的时候是如何调用的问题了

       这里可以参考下代码，无非就是设置当前页数和指定某一页的时候会用到

       

    void setCurrentPage(int currentPage) {
        if (!mScroller.isFinished()) {
            mScroller.abortAnimation();
        }
        // don't introduce any checks like mCurrentPage == currentPage here-- if we change the
        // the default
        if (getChildCount() == 0) {
            return;
        }

        mCurrentPage = Math.max(0, Math.min(currentPage, getPageCount() - 1));
        updateCurrentPageScroll();
        updateScrollingIndicator();
        notifyPageSwitchListener();
        invalidate();
    }

         可以看出就是当前页变化的时候会更新分页指示器的状态并有一个动画的过程，如果需要修改分页指示器应该要从这里入手了。

         后面的工作就是想想怎么修改了，代码暂时就到这里了，感觉写的好乱估计后面自己都看不懂了，不过起码能看的懂大概流程，这就没算浪费时间了。