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

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

当别人通过XML文件配置的方式来创建你开发的自定义组件,并且还能动态设置你自定义组件的属性时，这时候你就需要给你自己自定义的组件配上一个XML属性资源文件来完成这项工作了.

其实也可以不配上一个XML属性资源文件,也能完成如上的功能,这样你的自定义组件显得更干脆一点，一个自定义组件就是一个类文件，不拖泥带水的。但是这两种方式是有区别的，具体看自己的需求来选择了,以下为两种实现方式:

1:配合XML属性资源文件的方式

  第一步:attrs.xml文件

  首先当然是要写出自定义组件的类文件了,然后将这个类里需要外界传入值的属性定义成一个属性资源文件.

  在工程里的../res/values/目录下创建一个attrs.xml文件,文件名并不是只能写成这样,这样写只有一个目的,别人一看就知道这个文件是属性资源文件了,具体写法如下:

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解释如下

Java代码  


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文件里定义的属性为自己的属性设置值

Java代码  


package cn.com.androidtest.ui;  

4000
  
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代码  


<?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代码写法:

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资源文件配合的方式有个约束.绝对自由等于没有自由~~

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"/>