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 填充的布局。