Android自定义控件开发系列(一)——第一次动手做自定义控件

        Android系统提供的控件多种多样,以至于很多初学者经常忘了还有这样那样的控件没用过甚至没听过。尽管如此,但是系统控件大多比较死板,而且不够美观,很多多样化的显示或是交互方式都没法完成。每每遇到这种情况,就需要我们来开发我们自己的控件了——所谓的“自定义控件”。接下来我们就一步一步扎扎实实的从头开始Android自定义控件的开发。

        废话少说,开始吧:

        一、实现自定义控件的3种主要方式

        (1)修改已有控件——继承已有控件,重写其显示、响应等;

        (2)组合已有控件——将已有的系统控件组合成一个独特的控件(接下来的示例中就是这种演示);

        (3)开发全新的控件——一般继承View或SurfaceView。他们都提供一个Canvas(画布)和一系列的画的方法,还有Paint(画笔)。使用它们去创建一个自定义的UI。你可以重写事件,包括屏幕接触或者按键按下等等,用来提供与用户交互。这种方式比较高阶,需要熟悉View的工作原理并熟悉其各个回调方法。

        二、为自定义控件增加属性的两种方法:

        (1)在自定义类中定义属性字段

         本文通过开发一个可以显示文字和图片组合的控件来加以说明。

       通过构造函数中引入的AttributeSet 去查找XML布局的属性名称,然后找到它对应引用的资源ID去找值:

public class MyView1 extends View {
    private String mtext;
    private int msrc;

    public MyView1(Context context) {
        super(context);
    }

    public MyView1(Context context, AttributeSet attrs) {
        super(context, attrs);

        //方法attrs.getAttributeResourceValue(String nameSpace, String attriName, int default)的nameSpace参数传null即可————
        int textId = attrs.getAttributeResourceValue(null, "Text", 0);
        int imgId = attrs.getAttributeResourceValue(null, "Img", 0);

        //根据传来的id找出字符串,比如示例代码中传入的是@stirng/hello_world
        //这里也可以直接在xml文件中设置字符串的参数但是获取属性值的方法就要相应变成
        //mtext = attrs.getAttributeValue(null, "Text")直接获取传入的字符串
        mtext = getResources().getText(textId).toString();
        msrc = imgId;
    }

    @Override
    protected void onDraw(Canvas canvas) {
        Paint paint = new Paint();
        paint.setColor(Color.RED);
        paint.setTextSize(30);

        InputStream is = getResources().openRawResource(msrc);
        Bitmap bitmap = BitmapFactory.decodeStream(is);
        int imgWid = bitmap.getWidth();
        int imgHei = bitmap.getHeight();
        canvas.drawBitmap(bitmap, 0, 0, paint);
        canvas.drawText(mtext,imgWid/3, imgHei/2, paint);
    }
}

        然后在布局文件中使用我们自定义的控件(控件名要用包名+类名):

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <com.wangj.cusview.MyView1
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        Img="@drawable/xx"
        Text="@string/hello_world" />
</RelativeLayout>

         运行一下如下图:

        Android自定义控件开发系列(一)——第一次动手做自定义控件_第1张图片

        到这里,可能会有人问,布局文件里自定义控件的属性设置直接用Img="@drawable/xx"和Text="@string/hello_world",怎么不像系统控件的属性那样的写法android:layout_height="wrap_content"呢?这里就需要回顾一下上边我们在上边MyView1类中用attrs.getAttributeResourceValue(String nameSpace, String attriName, int default)方法时的nameSpace参数传了个null,没有使用命名空间

        ----------------------------------------------好了,上边这种方法完成了,下边的和上边的一样,只是更规范而已----------------------------------------------

        什么是命名空间呢?呵呵,你就先理解成一个归属吧,就像你们学校有好多个叫“王小二”的同学,校长要叫王二小同学来办公室聊聊,这是就要指出是“哪个班的王二小”了,命名空间就相当于这个班级的作用。我们看布局文件,根节点属性中都会有xmlns:android="http://schemas.android.com/apk/res/android"这一句,这就是声明一个命名空间,“命名空间的名字”就叫android,接下来就可以用android:layout_height="wrap_content"这种写法了。

        接下来我们也将上边的布局文件改成这种方式(我们也自己给一个命名空间)(这里需要说明一下,有人认为系统组件的命名空间必须要用“android”,其实不是的。“android”只是命名空间的名称,“http://schemas.android.com/apk/res/android”才是命名空间,你把xmlns:android="http://schemas.android.com/apk/res/android"改成xmlns:abcd="http://schemas.android.com/apk/res/android",在系统组件属性用abcd:layout_width也是没有问题的):   

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:myview="http://blog.csdn.net/a_running_wolf"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <!--这里第二行xmlns:my="http://blog.csdn.net/a_running_wolf"就是自己定义的命名空间-->
    <!--***注意这里的http://blog.csdn.net/a_running_wolf要和自定义类中的nameSpace一致,否则属性找不出来的-->

    <com.wangj.cusview.MyView1
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        myview:Img="@drawable/xx"
        myview:Text="@string/hello_world" />  <!--上边定义了命名空间,这里就可以像系统控件的属性一样的写法了-->

</RelativeLayout>

        相应的,在MyView1中就应该使用我们声明的这个命名空间了,直接看代码(这个类应该先于布局文件创建,不然在布局文件中怎么会有自己的控件可以用呢?这里放在后边主要是让大家重点看“命名空间”)

public class MyView1 extends View {
    //要和布局文件中声明的命名空间一致
    private final String nameSpace = "http://blog.csdn.net/a_running_wolf";
    private String mtext;
    private int msrc;

    public MyView1(Context context) {
        super(context);
    }

    public MyView1(Context context, AttributeSet attrs) {
        super(context, attrs);
        int textId = attrs.getAttributeResourceValue(nameSpace, "Text", 0);   //参数nameSpace用我们的命名空间
        int imgId = attrs.getAttributeResourceValue(nameSpace, "Img", 0);
        mtext = getResources().getText(textId).toString();
        msrc = imgId;
    }

    //onDraw方法和上边的一样
    .......
 }
        改造完毕,运行一下和上边一致:

       

        显然这种方式能实现相应的效果,但是效果很不好,文字显示在图片的什么地方、如果文字很多图片很小呢、如果我要改文字位置还要手动改drawText的位置参数,那么我们来看更规范的做法——往下看。

        (2)通过XML资源文件为自定义控件注册属性(和Android系统提供属性的方式一致)

        通过XML资源文件为控件注册属性,并使用命名空间的方式就是Android系统控件的属性提供方法,所以这种方式是推荐的自定义控件开发方法。首先在value目录下创建attrs.xml文件(有的话就不用创建了,直接往进写),写入如下的属性字段和相应的值(当然这里是根据自己的需要写,如下只是示例):

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <declare-styleable name="MyView2">
        <attr name="Text" format="reference|string" />
        <attr name="Oriental">
            <enum name="Herizontal" value="1" />
            <enum name="Vertical" value="0" />
        </attr>
        <attr name="Img" format="reference|integer" />
    </declare-styleable>
</resources>

        创建好attrs.xml后就可以用这些属性字段了(前提是你先创建好MyView2,否则控件啊!可以先创建一个空类,构造方法具体实现先不写,等后边在具体实现):

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:TV="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="@dimen/activity_vertical_margin">
    <!-- 有的博客上说这里自己的命名空间要用“http://schemas.android.com/apk/包名”,但是我在AndroidStudio1.3.2、Android5.0时
    用“http://schemas.android.com/apk/res-auto”更智能一点 -->

    <com.wangj.cusview.MyView2
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        TV:Text="@string/app_name"
        TV:Img="@drawable/xx"
        TV:Oriental="Herizontal"/>
</RelativeLayout>

       附上MyView2的实现类: 

public class MyView2 extends LinearLayout {   //为了简单,这里继承LinearLayout
    public MyView2(Context context) {
        super(context);
    }

    public MyView2(Context context, AttributeSet attrs) {
        super(context, attrs);
        int resourceId = -1;
        
        //获取布局文件中对应控件的属性
        TypedArray typedArray = context.obtainStyledAttributes(attrs, R.styleable.MyView2);
        ImageView iv = new ImageView(context);
        TextView tv = new TextView(context);
        int N = typedArray.getIndexCount();
        for (int i = 0; i < N; i++){
            int attr = typedArray.getIndex(i);
            switch (attr){
                case R.styleable.MyView2_Text:
                    resourceId = typedArray.getResourceId(R.styleable.MyView2_Text, 0);
                    tv.setText(resourceId > 0 ? getResources().getText(resourceId) : typedArray.getString(R.styleable.MyView2_Text));
                    break;
                case R.styleable.MyView2_Img:
                    resourceId = typedArray.getResourceId(R.styleable.MyView2_Img, 0);
                    iv.setImageResource(resourceId > 0 ? resourceId : R.mipmap.ic_launcher);
                    break;
                case R.styleable.MyView2_Oriental:
                    resourceId = typedArray.getInt(R.styleable.MyView2_Oriental, 0);
                    this.setOrientation(resourceId == 1 ? LinearLayout.HORIZONTAL : LinearLayout.VERTICAL );
                    break;
            }
        }

        //记住要将TextView和ImageView都addView,否则什么都显示不了
        addView(iv);
        addView(tv);
        typedArray.recycle();   //释放资源
    }

    @Override
    protected void onDraw(Canvas canvas) {
        super.onDraw(canvas);
    }
}

      MainActivity中没有做任何逻辑。直接运行,看效果:

Android自定义控件开发系列(一)——第一次动手做自定义控件_第2张图片

        这里看到这个红色框中就是我们的MyView2控件(不包括红色框)。肯定有人问,这里看起来这个控件就和一个ImageView和一个TextView水平线性排列就一个样子啊? 其实是的,但是区别在于——这里是一个控件,而不是两个控件——这里是为了简单演示,就简单的让MyView2继承了LineraLayout。根据实际的需求,我们可已让它继承RelativeLayout......各种布局,再创建自己的属性根据属性来做出漂亮的控件;可以继承已有的系统控件,重写其构造方法或是覆盖其onDraw方法来扩展出自己的个性化控件

        这些都是自定义控件开发最基础的知识,接下来我们将逐步深入,开发更高级和更美观的自定义控件,我也是在边学边写,如有不足希望大家指出,一起讨论,一起进步,也希望大家继续关注我的文章。

你可能感兴趣的:(Android开发,自定义控件,自定义组件,Android自定义)