android按钮高亮,Android 指向性高亮按钮

前言

本文章，是对于github上开源库的介绍使用， 简单记载方便查看。

https://github.com/hongyangAndroid/Highlight

为了以后使用时候方便查阅。

效果图：

01.png

看到效果图就知道要做的是什么了？

像“账户信息移到这里了，点击查看”，就是高亮View的提示文字。

思考

假设如图所示有四个按钮要弄成高亮的，那么必须要考虑一下问题：

(1)这四个按钮一起展示出来还是一个一个的展示？

(2)这些高亮按钮是点击背景消失，还是点击某些提示文字才可以消失

上述提到的问题，不同的相互组合，就是不同的效果。

初步介绍

mHighLight = new HighLight(MainActivity.this)

.addHighLight(R.id.Text_1, R.layout.info_gravity_left_down, new OnRightPosCallback(), new RectLightShape())

.addHighLight(R.id.Text_2, R.layout.info_gravity_left_down, new OnLeftPosCallback(), new RectLightShape())

.addHighLight(R.id.Text_3, R.layout.info_gravity_left_down, new OnTopPosCallback(), new CircleLightShape())

.addHighLight(R.id.Text_4, R.layout.info_gravity_left_down, new MySelfPosCallback(), new CircleLightShape());

mHighLight.show();

上述代码，实现了，一次性展示四个高亮按钮，用户点击背景就可以都取消。

(1)addHighLight()方法

参数一：你想高亮的View的控件

参数二：提示文字，你希望在高亮按钮傍边展示什么，是以布局形式，可以随便自定义

参数三：设置提示文字在高亮按钮的什么位置，这个库中已经提供了上下左右，如果不满意，可以自己定义，如图，MyselfPosCallBack就是我自己自定义：

public class MySelfPosCallback extends OnBaseCallback {

public MySelfPosCallback() {

}

public MySelfPosCallback(float offset) {

super(offset);

}

@Override

public void getPosition(float rightMargin, float bottomMargin, RectF rectF, HighLight.MarginInfo marginInfo) {

marginInfo.rightMargin = rightMargin+rectF.width()+offset;

marginInfo.topMargin = rectF.top-200;

}

}

参数四：用什么样式包裹高亮的View,效果看图，这个库中提供了矩形、圆形、椭圆，当然也支持自定义。

.addHighLight(R.id.text_4,R.layout.info_known,new OnRightPosCallback(5),new BaseLightShape(TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP,5,getResources().getDisplayMetrics()), TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP,5,getResources().getDisplayMetrics()),0) {

@Override

protected void resetRectF4Shape(RectF viewPosInfoRectF, float dx, float dy) {

//缩小高亮控件范围

viewPosInfoRectF.inset(dx,dy);

}

@Override

protected void drawShape(Bitmap bitmap, HighLight.ViewPosInfo viewPosInfo) {

//custom your hight light shape 自定义高亮形状

Canvas canvas = new Canvas(bitmap);

Paint paint = new Paint(Paint.ANTI_ALIAS_FLAG);

paint.setDither(true);

paint.setAntiAlias(true);

//blurRadius必须大于0

if(blurRadius>0){

paint.setMaskFilter(new BlurMaskFilter(blurRadius, BlurMaskFilter.Blur.SOLID));

}

RectF rectF = viewPosInfo.rectF;

canvas.drawOval(rectF, paint);

}

})

另外，方法是addxxxx，那么说明是支持可以无限添加的，这个是随意的，但是需要主要的是，你添加的顺序就是展示的顺序，当然了这个战士的顺序是基于一个一个出现才能看到，否则只能看到一下子全部展示出来。

autoRemove()

这个方法默认是ture，就是说，你点击背景就可以取消高亮View。

如果你设置了false,那么就不能取消高亮View。

如何让其一个一个的展示

mHighLight = new HighLight(MainActivity.this)

.addHighLight(R.id.Text_1, R.layout.info_gravity_left_down, new OnRightPosCallback(), new RectLightShape())

.addHighLight(R.id.Text_2, R.layout.info_gravity_left_down, new OnLeftPosCallback(), new RectLightShape())

.addHighLight(R.id.Text_3, R.layout.info_gravity_left_down, new OnTopPosCallback(), new CircleLightShape())

.addHighLight(R.id.Text_4, R.layout.info_gravity_left_down, new MySelfPosCallback(), new CircleLightShape())

.autoRemove(false)//如果设置为true，那么就是自动移除，那么mHighLight对象就会自动移除了，会出现空指针错误。

.enableNext()

.setClickCallback(new HighLightInterface.OnClickCallback() {

@Override

public void onClick() {

Toast.makeText(MainActivity.this,"请点击下一个",Toast.LENGTH_SHORT).show();

mHighLight.next();//必须要这个，要不然只展示一个指示性高亮的，就不往下走了

}

});

mHighLight.setOnNextCallback(new HighLightInterface.OnNextCallback() {

@Override

public void onNext(HightLightView hightLightView, View targetView, View tipView) {

Log.d("xljxjlx","zoule de shi onNextCallback");

//和onClickCallback可以一起回调；

}

});

mHighLight.show();

其中，enableNext()是关键，作用是开始mHighLight.next()

这两个属性配合就可以完成了一个一个展示高亮，所以这个一个一个出现是要手动调用next()方法的。

需要注意，autoRemove必须设置为false，否则在使用一个一个出现时候会出现空指针，因为autoRemove会移除mHighLight。

一些监听介绍

前面提到的有

(1)setClickCallback()

点击背景时候就会触发。

(2)setOnNextCallback()

当enableNext()出现，执行一次，当next()方法执行一次，就会回调一次。

setOnRemoveCallback()

当HighLight中所有设置的高亮按钮移除的时候，就会自动调用

setOnShowCallback()

当HighLight开始出现的时候，就会自动调用

需要注意

前面所有的监听 ，都是这个库本身提供的源码如下：

if (intercept) {

hightLightView.setOnClickListener(new View.OnClickListener() {

@Override

public void onClick(View v) {

//added autoRemove by isanwenyu@163.com

if (autoRemove) remove();

sendClickMessage();

}

});

}

提到了一个关键属相intercept，默认的是true,

所以这些监听方法才有效果。

如果设置了intercept = false ,那么监听方法会失效，具体实践试试，但好处是，如果你界面有一个滑动的布局，那么就不会影响它滑动，一般默认的情况下，他是不可以滑动的。

不想通过点击背景来使得高亮View消失

可以通过在提示文字布局中添加一个View,比如“我知道了”但是要在相应的acitivy中重写这个“我知道了”的点击事件，将autoRemove设置为 false就可以了。

public void clickKnown(View view) {

if(mHighLight.isShowing() && mHighLight.isNext())//如果开启next模式

{

mHighLight.next();

}else

{

mHighLight.remove();

}

}

实现这个点击事件，也是在里面完成HighLight的操作。next()针对于下一个，remove()针对于移除给HighLight添加的高亮View.

不在Activity中使用

如果不在Activity中使用，需要调用方法

.anchor(findViewById(R.id.id_container))//如果是Activity上增加引导层，不需要设置anchor

其中anchor参数是想添加高亮View的跟布局的id 填充的布局。