Android通用圆点指示器——android-Universal-CircleIndicator

转载请注明出处：http://blog.csdn.net/footballclub/

前言

最近项目中需要加一个圆点指示器，在切换页面的时候使用，网上有开源的项目viewflow和viewpageIndicator,这两者都有很好的效果，但遗憾的是都有局限性，一个是只能用于viewflow，另一个只能用在viewpage上面，而我项目中的页面切换用的是自定义View，上面两个项目中的圆点指示器都不能拿来直接用，于是就借鉴viewflow做了一个简单易用的通用圆点指示器。

效果图

用法介绍

简单用法

@Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        ......
        gridview.setOnPageChangedListener(new OnPageChangedListener() {            
            @Override
            public void onPageChanged(PagedDragDropGrid sender, int newPageNumber) {
                //当页面切换的时候调用此方法改变被选中的圆点
                indicator.setCurrentPage(newPageNumber);
            }
        });
        //设置总共的页数
        indicator.initData(adapter.pageCount(), 0);
        //设置当前的页面
        indicator.setCurrentPage(0);
        //注：如果需要在切换页面时同时改变pagecount，initData和setCurrentPage可以同时使用。
    }

按照上面做了以后就能正常使用了，如果你想定制圆点的大小，圆点间的间距，选中圆点和未选中圆点的颜色，那么请继续往下看吧。

详细用法

可配置的属性：

<declare-styleable name="XCircleIndicator">
        <!-- 被选中圆点的颜色 -->
        <attr name="fillColor" format="color" />
        <!-- 未选中圆点的颜色 -->
        <attr name="strokeColor" format="color" />
        <!-- 圆点的大小 -->
        <attr name="radius" format="dimension" />
        <!-- 圆点间间距的大小 -->
        <attr name="circleInterval" format="dimension" />
    </declare-styleable>

属性在xml中的用法：

  <com.andwidget.xcircleindicator.XCircleIndicator
        android:id="@+id/xCircleIndicator"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignParentBottom="true"
        android:layout_centerHorizontal="true"
        android:layout_marginBottom="@dimen/indicator_bottom_margin"
        indicator:circleInterval="@dimen/circleInterval"
        indicator:fillColor="#F96A0E"
        indicator:radius="@dimen/radius"
        indicator:strokeColor="#cecece" />

当然设置参数不会局限于xml配置，也可以在java代码中动态设置

/** * Sets the fill color * * @param color * ARGB value for the text */
    public void setFillColor(int color) {
        mPaintFill.setColor(color);
        invalidate();
    }

    /** * Sets the stroke color * * @param color * ARGB value for the text */
    public void setStrokeColor(int color) {
        mPaintStroke.setColor(color);
        invalidate();
    }

    /** * Sets the circle interval * * @param circleInterval * unit px */
    public void setCircleInterval(int circleInterval) {
        this.circleInterval = circleInterval;
        invalidate();
    }

    /** * Sets the circle radius * * @param circleInterval * unit px */
    public void setRadius(int radius) {
        this.radius = radius;
        invalidate();
    }

可以看到，在改变参数以后都调用了view.invalidate()方法，invalidate()函数的主要作用是请求View树进行重绘，然后在我们自定义view中会依次回调onMeasure(),onLayout()和onDraw()。在我们需要在onMeasure中完成测量，并在onDraw中完成了最终的绘制。

@Override
    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
        setMeasuredDimension(measureWidth(widthMeasureSpec),
                measureHeight(heightMeasureSpec));
    }

    @Override
    protected void onDraw(Canvas canvas) {
        super.onDraw(canvas);
        // Draw stroked circles
        for (int iLoop = 0; iLoop < pageTotalCount; iLoop++) {
            canvas.drawCircle(getPaddingLeft() + radius
                    + (iLoop * (2 * radius + circleInterval)), getPaddingTop()
                    + radius, radius, mPaintStroke);
        }
        int cx = 0;
        // if (flowWidth != 0) {
        // // Draw the filled circle according to the current scroll
        // cx = (currentScroll * (2 * radius + radius)) / flowWidth;
        // }
        cx = (2 * radius + circleInterval) * currentPage;
        // The flow width has been upadated yet. Draw the default position
        canvas.drawCircle(getPaddingLeft() + radius + cx, getPaddingTop()
                + radius, radius, mPaintFill);
    }

    /** * Determines the width of this view * * @param measureSpec * A measureSpec packed into an int * @return The width of the view, honoring constraints from measureSpec */
    private int measureWidth(int measureSpec) {
        int result = 0;
        int specMode = MeasureSpec.getMode(measureSpec);
        int specSize = MeasureSpec.getSize(measureSpec);

        // We were told how big to be
        if (specMode == MeasureSpec.EXACTLY) {
            result = specSize;
        } else { // Calculate the width according the views count
            result = getPaddingLeft() + getPaddingRight()
                    + (pageTotalCount * 2 * radius) + (pageTotalCount - 1)
                    * circleInterval;
            // Respect AT_MOST value if that was what is called for by
            // measureSpec
            if (specMode == MeasureSpec.AT_MOST) {
                result = Math.min(result, specSize);
            }
        }
        return result;
    }

    /** * Determines the height of this view * * @param measureSpec * A measureSpec packed into an int * @return The height of the view, honoring constraints from measureSpec */
    private int measureHeight(int measureSpec) {
        int result = 0;
        int specMode = MeasureSpec.getMode(measureSpec);
        int specSize = MeasureSpec.getSize(measureSpec);

        // We were told how big to be
        if (specMode == MeasureSpec.EXACTLY) {
            result = specSize;
        }
        // Measure the height
        else {
            result = 2 * radius + getPaddingTop() + getPaddingBottom();
            // Respect AT_MOST value if that was what is called for by
            // measureSpec
            if (specMode == MeasureSpec.AT_MOST) {
                result = Math.min(result, specSize);
            }
        }
        return result;
    }

以上就全部介绍完了，如果你对android-Universal-CircleIndicator感兴趣，可以在github上关注android-Universal-CircleIndicator

当然你也可以点此直接下载