Android应用资源--之属性(Attribute)资源

原文链接：

http://wujiandong.iteye.com/blog/1184921

属性(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"/>