自定义view之seekbar

本文简介：在github上找了不少seekbar，有些库具备相当复杂的功能，所以我想自己写一个简单易用的seekbar。本文主要讲述为什么要自定义view，自定义view的大体步骤，编写重难点。

1、为什么要自定义view

由于工作上的需要，我们往往需要实现某种特殊的布局或者界面效果，这时候官方没有提供相应的控件支持，需要我们继承view或者其它view类扩展。一般初学者入门可以先尝试组合view，即先自己利用官方控件拼装成需要的效果，然后内置逻辑。也就是把abc等多个view组合在一起使用，比include方式多了内置逻辑的好处。（具体范例参考本人其它博客）

接下来本文讲述的是如何自定义一个seekbar。先看效果图，如下。

2、分析要绘制的自定义view
1）根据最终效果图或者需求方提供的功能说明等，去分析界面效果包含哪些动作，比如手势（点击，触摸移动），要显示的图形形状、文本（矩形，原型，弧形，随图形一起绘制的文本等等，都要仔细分析），拆解view图形为小的模块。

2）比如本文的seekbar，明显分为3个部分，一个是后面刻度的进度条，一个是当前的进度条。还有一个圆形按钮。然后手指点击刻度条，会根据点击位置当前进度跳转至此，并且圆形按钮也是如此。有一个特殊的需求是可以圆角也可以无圆角，并且圆形按钮可有可无。所以需要2个标记boolean去区分。需要注意的一点是，按照习惯一般圆形按钮的圆心的x所在坐标应该是在白色的当前进度的最右边x坐标。

3）根据图片，我们可以得出，3个模块的绘制都是自己有自身的大小控制，而为了适配左右padding，所以的绘制进度条时，要预留padding。
而上下padding，我不准备处理，直接让seekbar绘制在纵向的中间即可。即纵坐标y中心点都是height/2，并且限制3个模块的最大高度为view的高度，避免绘制出界。

3、自定义view主要方法介绍

主要方法有onmeasure、ondraw、ontouchevent、构造函数。自定义view一般围绕这几个方法进行处理，构造函数里获取自定义属性的值，初始化paint等对象，初始化一些view参数。ondraw进行绘制图形，这个主要有drawarc等方法，这个不多讲，自行搜索相关方法总览。ontouchevent就是处理点击坐标，然后触发一些绘制操作或响应某个方法动作。对于viewgroup的话还有onlayout等方法。

4、开始绘制

先准备本view需要的自定义属性，3个模块的高度大小、是否圆角、颜色等。tickBar是刻度条，circlebutton是圆形按钮，progress就是当前进度，代码如下。

 <!--自定义 seekbar-->
    <declare-styleable name="NumTipSeekBar">
        <attr name="tickBarHeight" format="dimension"/>
        <attr name="tickBarColor" format="color"/>
        <attr name="circleButtonColor" format="color"/>
        <attr name="circleButtonTextColor" format="color"/>
        <attr name="circleButtonTextSize" format="dimension"/>
        <attr name="circleButtonRadius" format="dimension"/>
        <attr name="progressHeight" format="dimension"/>
        <attr name="progressColor" format="color"/>
        <attr name="selectProgress" format="integer"/>
        <attr name="startProgress" format="integer"/>
        <attr name="maxProgress" format="integer"/>
        <attr name="isShowButtonText" format="boolean"/>
        <attr name="isShowButton" format="boolean"/>
        <attr name="isRound" format="boolean"/>
    </declare-styleable>

接下来就是获取自定义属性，然后初始化view参数了。TypedArray对象一定要记得attr.recycle();关闭，一般textsize是getDimension，而高度大小什么的是获取getDimensionPixelOffset，view本身测试出来的也是px值，但是settextsize的方法需要传入dp或者sp值。我在initview方法里初始化所需要的paint对象，避免ondraw反复绘制里new对象耗费不必要的内存。可能初学者不清楚RectF是什么东西，你百度一下会死啊。。。代码如下。

 public NumTipSeekBar(Context context) {
        this(context, null);
    }

    public NumTipSeekBar(Context context, AttributeSet attrs) {
        this(context, attrs, 0);
    }
 public NumTipSeekBar(Context context, AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        init(context, attrs);
    }


    /**
     * 初始化view的属性
     *
     * @param context
     * @param attrs
     */
    private void init(Context context, AttributeSet attrs) {

        TypedArray attr = context.obtainStyledAttributes(attrs, R.styleable.NumTipSeekBar);
        mTickBarHeight = attr.getDimensionPixelOffset(R.styleable
                .NumTipSeekBar_tickBarHeight, getDpValue(8));
        mTickBarColor = attr.getColor(R.styleable.NumTipSeekBar_tickBarColor, getResources()
                .getColor(R.color.orange_f6));
        mCircleButtonColor = attr.getColor(R.styleable.NumTipSeekBar_circleButtonColor,
                getResources().getColor(R.color.white));
        mCircleButtonTextColor = attr.getColor(R.styleable.NumTipSeekBar_circleButtonTextColor,
                getResources().getColor(R.color.purple_82));
        mCircleButtonTextSize = attr.getDimension(R.styleable
                .NumTipSeekBar_circleButtonTextSize, getDpValue(16));
        mCircleButtonRadius = attr.getDimensionPixelOffset(R.styleable
                .NumTipSeekBar_circleButtonRadius, getDpValue(16));
        mProgressHeight = attr.getDimensionPixelOffset(R.styleable
                .NumTipSeekBar_progressHeight, getDpValue(20));
        mProgressColor = attr.getColor(R.styleable.NumTipSeekBar_progressColor,
                getResources().getColor(R.color.white));
        mSelectProgress = attr.getInt(R.styleable.NumTipSeekBar_selectProgress, 0);
        mStartProgress = attr.getInt(R.styleable.NumTipSeekBar_startProgress, 0);
        mMaxProgress = attr.getInt(R.styleable.NumTipSeekBar_maxProgress, 10);
        mIsShowButtonText = attr.getBoolean(R.styleable.NumTipSeekBar_isShowButtonText, true);
        mIsShowButton = attr.getBoolean(R.styleable.NumTipSeekBar_isShowButton, true);
        mIsRound = attr.getBoolean(R.styleable.NumTipSeekBar_isRound, true);
        initView();

        attr.recycle();


    }
     private void initView() {
        mProgressPaint = new Paint();
        mProgressPaint.setColor(mProgressColor);
        mProgressPaint.setStyle(Paint.Style.FILL);
        mProgressPaint.setAntiAlias(true);

        mCircleButtonPaint = new Paint();
        mCircleButtonPaint.setColor(mCircleButtonColor);
        mCircleButtonPaint.setStyle(Paint.Style.FILL);
        mCircleButtonPaint.setAntiAlias(true);

        mCircleButtonTextPaint = new Paint();
        mCircleButtonTextPaint.setTextAlign(Paint.Align.CENTER);
        mCircleButtonTextPaint.setColor(mCircleButtonTextColor);
        mCircleButtonTextPaint.setStyle(Paint.Style.FILL);
        mCircleButtonTextPaint.setTextSize(mCircleButtonTextSize);
        mCircleButtonTextPaint.setAntiAlias(true);

        mTickBarPaint = new Paint();
        mTickBarPaint.setColor(mTickBarColor);
        mTickBarPaint.setStyle(Paint.Style.FILL);
        mTickBarPaint.setAntiAlias(true);

        mTickBarRecf = new RectF();/矩形，一会根据这个绘制刻度条在这个矩形内
        mProgressRecf = new RectF();
        mCircleRecf = new RectF();
    }

由于本view没有太大必要编写onmeasure方法去适配wrapcontent。所以接下来就是ondraw里进行绘制了。首先我们先绘制刻度条，首先获取当前view的高宽，刻度条设置的高宽，然后计算y坐标中心，计算出刚才RectF矩形范围。要设置上下左右的坐标起点，左就是getPaddingLeft()作为起点，即默认自定义view支持paddingleft的设置。top的起点就是(mViewHeight - mTickBarHeight) / 2，即含义是绘制在view纵坐标y的中心点，然后tickbar高度从此点分为上下2半。同理求出横向的终点的x坐标以及底部坐标等

  @Overrid
    protected void onDraw(Canvas canvas) {
        super.onDraw(canvas);
        int width = getWidth();
        int height = getHeight();
        initValues(width, height);
        // do........
    }

  private void initValues(int width, int height) {
        mViewWidth = width - getPaddingRight() - getPaddingLeft();
        mViewHeight = height;
        if (mTickBarHeight > mViewHeight) {
            //如果刻度条的高度大于view本身的高度的1/2，则显示不完整，所以处理下。
            mTickBarHeight = mViewHeight;
        }
        mTickBarRecf.set(getPaddingLeft(), (mViewHeight - mTickBarHeight) / 2,
                mViewWidth + getPaddingLeft(), mTickBarHeight / 2 +
                        mViewHeight / 2);

同理处理进度条部分的绘制，这个比刚才多了一层逻辑，起点依旧，但是终点x（矩形的right坐标）需要根据当前进度计算。mSelectProgress 是当前进度值，mMaxProgress 是最大值，mStartProgress是默认起点代表多少刻度值，比如1-10的seekbar效果（起点是1，终点是10）。求出比值然后乘以view本身的实际绘制范围的宽度（上面代码有计算），加上paddingleft，得出矩形的终点x。

  mCirclePotionX = (float) (mSelectProgress - mStartProgress) /
                (mMaxProgress - mStartProgress) * mViewWidth + getPaddingLeft();
  if (mProgressHeight > mViewHeight) {
            //如果刻度条的高度大于view本身的高度的1/2，则显示不完整，所以处理下。
            mProgressHeight = mViewHeight;
        }

        mProgressRecf.set(getPaddingLeft(), (mViewHeight - mProgressHeight) / 2,
                mCirclePotionX, mProgressHeight / 2 + mViewHeight / 2);

同理求出圆形按钮的坐标范围

    if (mCircleButtonRadius > mViewHeight / 2) {
            //如果圆形按钮的半径大于view本身的高度的1/2，则显示不完整，所以处理下。
            mCircleButtonRadius = mViewHeight / 2;
        }
        mCircleRecf.set(mCirclePotionX - mCircleButtonRadius, mViewHeight / 2 -
                        mCircleButtonRadius / 2,
                mCirclePotionX + mCircleButtonRadius, mViewHeight / 2 +
                        mCircleButtonRadius / 2);

开始绘制，mOnProgressChangeListener 是回调进度变化，mIsRound控制圆角。重点说明的是 Paint.FontMetricsInt处理文本的居中显示。
代码如下。

  @Override
    protected void onDraw(Canvas canvas) {
        super.onDraw(canvas);
        int width = getWidth();
        int height = getHeight();
        initValues(width, height);
        if (mOnProgressChangeListener != null && mIsNotifyListener) {
            mIsNotifyListener = true;//恢复默认值
            mOnProgressChangeListener.onChange(mSelectProgress);
        }
        if (mIsRound) {
            canvas.drawRoundRect(mTickBarRecf, mProgressHeight / 2, mProgressHeight / 2,
                    mTickBarPaint);
            canvas.drawRoundRect(mProgressRecf, mProgressHeight / 2, mProgressHeight / 2,
                    mProgressPaint);
        } else {
            canvas.drawRect(mTickBarRecf, mTickBarPaint);
            canvas.drawRect(mProgressRecf, mProgressPaint);
        }
//        canvas.drawArc(mCircleRecf, 0, 360, true, mCircleButtonPaint);
        if (mIsShowButton) {
            canvas.drawCircle(mCirclePotionX, mViewHeight / 2, mCircleButtonRadius,
                    mCircleButtonPaint);
        }
        if (mIsShowButtonText) {
            Paint.FontMetricsInt fontMetrics = mCircleButtonTextPaint.getFontMetricsInt();
            int baseline = (int) ((mCircleRecf.bottom + mCircleRecf.top - fontMetrics.bottom -
                    fontMetrics
                            .top) / 2);
            // 下面这行是实现水平居中，drawText对应改为传入targetRect.centerX()
            canvas.drawText(String.valueOf(mSelectProgress), mCircleRecf.centerX
                            (), baseline,
                    mCircleButtonTextPaint);

        }
    }

5、处理触摸逻辑

这里主要是依赖onTouchEvent判断手势，当event满足某个触摸条件就进行获取当前坐标计算进度。本view是ACTION_MOVE、ACTION_DOWN时触发。isEnabled判断是否设置setEnabled属性，如果设置则屏蔽触摸绘制，这是我的特殊需求。judgePosition()主要是根据x坐标进行计算进度。BigDecimal 是处理四舍五入，大概发生进度变化时重新绘制自身view。return true;是为了消费触摸事件。（触摸事件分发机制，请移步大牛的博客）

   @Override
    public boolean onTouchEvent(MotionEvent event) {
        if (!isEnabled()) {
            //如果设置不可用，则禁用触摸设置进度
            return false;
        }
        float x = event.getX();
        float y = event.getY();
        Log.i(TAG, "onTouchEvent: x：" + x);
        switch (event.getAction()) {
            case MotionEvent.ACTION_MOVE:
                judgePosition(x);
                return true;
            case MotionEvent.ACTION_DOWN:
                judgePosition(x);
                return true;
            case MotionEvent.ACTION_CANCEL:
                break;
            default:
                break;
        }

        return super.onTouchEvent(event);
    }

    private void judgePosition(float x) {
        float end = getPaddingLeft() + mViewWidth;
        float start = getPaddingLeft();
        int progress = mSelectProgress;
        Log.i(TAG, "judgePosition: x-start：" + (x - start));
        Log.i(TAG, "judgePosition: start:" + start + "  end:" + end + "  mMaxProgress:" +
                mMaxProgress);
        if (x >= start) {
            double result = (x - start) / mViewWidth * (float) mMaxProgress;
            BigDecimal bigDecimal = new BigDecimal(result).setScale(0, BigDecimal.ROUND_HALF_UP);
            Log.i(TAG, "judgePosition: progress:" + bigDecimal.intValue() + "  result:" + result
                    + "  (x - start) / end :" + (x - start) / end);
            progress = bigDecimal.intValue();
            if (progress > mMaxProgress) {
                Log.i(TAG, "judgePosition:x > end  超出坐标范围:");
                progress = mMaxProgress;
            }
        } else if (x < start) {
            Log.i(TAG, "judgePosition: x < start 超出坐标范围:");
            progress = 0;
        }
        if (progress != mSelectProgress) {
            //发生变化才通知view重新绘制
            setSelectProgress(progress, true);
        }

    }

下面是一些主要的set方法，用来更新view。

   /**
     * 设置当前选中的值
     *
     * @param selectProgress 进度
     */
    public void setSelectProgress(int selectProgress) {
        mSelectProgress = selectProgress;
        if (mSelectProgress > mMaxProgress) {
            mSelectProgress = mMaxProgress;
        } else if (mSelectProgress <= mStartProgress) {
            mSelectProgress = mStartProgress;
        }
        invalidate();
    }

    /**
     * 设置当前选中的值
     *
     * @param selectProgress   进度
     * @param isNotifyListener 是否通知progresschangelistener
     */
    public void setSelectProgress(int selectProgress, boolean isNotifyListener) {
        mSelectProgress = selectProgress;
        if (mSelectProgress > mMaxProgress) {
            mSelectProgress = mMaxProgress;
        } else if (mSelectProgress <= mStartProgress) {
            mSelectProgress = mStartProgress;
        }
        mIsNotifyListener = isNotifyListener;
        Log.i(TAG, "mSelectProgress: " + mSelectProgress + "  mMaxProgress: " +
                mMaxProgress);
        invalidate();
    }

自此本seekbar基本讲述完毕，观看下面源码，可以了解详细的内容，每个字段都有注释，初学者可以进行源码查看。
源码地址：https://github.com/389273716/highscalabilityseekbar

下一篇预告：
刻度盘view，支持外部倒计时控制，支持触摸移动，点击，带动画，支持配置界面元素，适配屏幕。