应用资源系列之属性[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"/>