原文链接:
http://wujiandong.iteye.com/blog/1184921
当别人通过XML文件配置的方式来创建你开发的自定义组件,并且还能动态设置你自定义组件的属性时,这时候你就需要给你自己自定义的组件配上一个XML属性资源文件来完成这项工作了.
其实也可以不配上一个XML属性资源文件,也能完成如上的功能,这样你的自定义组件显得更干脆一点,一个自定义组件就是一个类文件,不拖泥带水的。但是这两种方式是有区别的,具体看自己的需求来选择了,以下为两种实现方式:
1:配合XML属性资源文件的方式
第一步:attrs.xml文件
首先当然是要写出自定义组件的类文件了,然后将这个类里需要外界传入值的属性定义成一个属性资源文件.
在工程里的../res/values/目录下创建一个attrs.xml文件,文件名并不是只能写成这样,这样写只有一个目的,别人一看就知道这个文件是属性资源文件了,具体写法如下:
- <?xml version="1.0" encoding="utf-8"?>
- <resources>
- <attr name="test1" format="string" />
- <declare-styleable name="MyView">
- <attr name="textColor" format="color" />
- <attr name="textSize" format="dimension" />
- <attr name="text" format="string" />
- </declare-styleable>
- </resources>
attrs.xml解释如下
- attr子元素:
- 定义具体的属性,format表示这个属性的值的类型,类型有以下几种:
- 1.reference:参考指定Theme中资源ID,这个类型意思就是你传的值可以是引用资源
- 2.string:字符串,如果你想别人既能直接写值也可以用类似"@string/test"引用资源的方式,可以写成format="string|reference"
- 3.Color:颜色
- 4.boolean:布尔值
- 5.dimension:尺寸值
- 6.float:浮点型
- 7.integer:整型
- 8.fraction:百分数
- 9.enum:枚举 ,如果你提供的属性只能让别人选择,不能随便传入,就可以写成这样
- <attr name="language">
- <enum name="china" value="1"/>
- <enum name="English" value="2"/>
- </attr>
- 10.flag:位或运算
- declare-styleable子元素:
- 定义一个styleable对象,每个styleable对象就是一组attr属性的集合 注意:这里的name属性并不是一定要和自定义类名相同,只是为了好区分对应类的属性而已
- 注意:上面的属性资源文件定义了该属性之后,至于到底是哪个自定义View组件中来使用该属性,该属性到底能发挥什么作用, 就不归该属性资源文件管了,也就是说这个属性资源文件是个公共的,大家都可以用,但是为了方便管理,一般都是一个自定义View里的属性写成一个declare-styleable集合.属性资源所定义的属性到底可以返回什么作用,取决于自定义组件的代码实现
第二步:在自定义类里引用attrs文件里定义的属性为自己的属性设置值
- package cn.com.androidtest.ui;
- import cn.com.androidtest.R;
- import android.content.Context;
- import android.content.res.TypedArray;
- import android.graphics.Canvas;
- import android.graphics.Color;
- import android.graphics.Paint;
- import android.graphics.Paint.Style;
- import android.graphics.Rect;
- import android.util.AttributeSet;
- import android.view.View;
- public class MyView extends View
- {
- private Paint mPaint;
- private Context mContext;
- private static String mString;
- private String test;
- public MyView(Context context)
- {
- super(context);
- mPaint = new Paint();
- }
- public MyView(Context context,AttributeSet attrs)
- {
- super(context,attrs);
- mPaint = new Paint();
- /*这里取得declare-styleable集合*/
- TypedArray typeArray = context.obtainStyledAttributes(attrs,R.styleable.MyView);
- /*这里从集合里取出相对应的属性值,第二参数是如果使用者没用配置该属性时所用的默认值*/
- int textColor = typeArray.getColor(R.styleable.MyView_textColor,0XFFFFFFFF);
- float textSize = typeArray.getDimension(R.styleable.MyView_textSize, 36);
- mString = typeArray.getString(R.styleable.MyView_text);
- /*设置自己的类成员变量*/
- mPaint.setTextSize(textSize);
- mPaint.setColor(textColor);
- /*关闭资源*/
- typeArray.recycle();
- }
- @Override
- protected void onDraw(Canvas canvas)
- {
- super.onDraw(canvas);
- mPaint.setStyle(Style.FILL);
- canvas.drawRect(new Rect(10, 10, 90, 90), mPaint);
- mPaint.setColor(Color.BLUE);
- canvas.drawText(mString, 10, 110, mPaint);
- }
- }
第三步:使用自定义组件,并设置属性
- <?xml version="1.0" encoding="utf-8"?>
- <LinearLayout
- xmlns:android="http://schemas.android.com/apk/res/android"
- xmlns:myandroid="http://schemas.android.com/apk/res/cn.com.androidtest"
- android:orientation="vertical"
- android:layout_width="fill_parent"
- android:layout_height="fill_parent"
- >
- <TextView
- android:layout_width="fill_parent"
- android:layout_height="wrap_content"
- android:text="@string/hello"/>
- <cn.com.androidtest.ui.MyView
- android:layout_width="fill_parent"
- android:layout_height="wrap_content"
- myandroid:textColor="#ff0000"
- myandroid:textSize="20px"
- myandroid:text="http://wujiandong.iteye.com"/>
- </LinearLayout>
注意:java代码里那种取属性值的方式,那么在XML使用该组件的时候一定要为该自定义组件设置一个命名空间[xmlns:myandroid="http://schemas.android.com/apk/res/cn.com.androidtest"],不然组件属性设置不了
命名空间写法:xmlns:空间名="http://schemas.android.com/apk/res/自定义组件所在包名"
写包名时候也有个要注意的地方:
如果你的自定义View所在包类似如下两图,那么包名只能写成最顶层包[cn.com.androidtest],而不能是[cn.com.androidtest.ui]
第四步:终于完成了,看下效果图
2:不需要配合XML资源文件的方式
基本与第一种方式相同,只是java代码取属性值的部分,和别人用你自义View时有点区别
java代码写法:
- /*资源ID号引用*/
- int resouceId = -1;
- /*取得资源ID号,第一个参数:命名空间名.第二个参数:xml文件里设置的属性名.第三个参数:默认值*/
- resouceId = attrs.getAttributeResourceValue(null, "textColor", 0);
- if (resouceId > 0)
- textColor = context.getResources().getColor(resouceId);
- resouceId = attrs.getAttributeResourceValue(null, "textColor", 0);
- if(resouceId > 0)
- mString = context.getResources().getText(resouceId, "http://wujiandong.iteye.com").toString();
XML中使用的时候,命名空间可以不要,属性名就要自己对应好了,不然程序取不到,不像有XML资源文件配合的方式有个约束.绝对*等于没有*~~
- <cn.com.androidtest.ui.MyView
- android:layout_width="fill_parent"
- android:layout_height="wrap_content"
- textColor="#ff0000"
- textSize="20px"
- text="http://wujiandong.iteye.com"/>