Android应用资源系列之属性(Attribute)资源

属性(Attribute)资源:属于整个Android应用资源的一部分.其实就是网上一堆介绍怎么给自定义View添加自己的属性文章里的attrs文件,此文件位于../res/values/目录下

当别人通过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"/>

评论

1 楼 xiaobojava 2013-12-15  

<attr name="test1" format="string" />
这个属性值怎么获取呢？