自定义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，支持外部倒计时控制，支持触摸移动，点击，带动画，支持配置界面元素，适配屏幕。
