一、在res/values文件下定义一个attrs.xml文件,代码如下:
1 <?xml version="1.0" encoding="utf-8"?>
2 <resources>
3 <declare-styleable name="ToolBar">
4 <attr name="buttonNum" format="integer"/>
5 <attr name="itemBackground" format="reference|color"/>
6 </declare-styleable>
7 </resources>
二、在布局xml中如下使用该属性:
1 <?xml version="1.0" encoding="utf-8"?>
2 <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
3 xmlns:toolbar="http://schemas.android.com/apk/res/cn.zzm.toolbar"
4 android:orientation="vertical"
5 android:layout_width="fill_parent"
6 android:layout_height="fill_parent"
7 >
8 <cn.zzm.toolbar.ToolBar android:id="@+id/gridview_toolbar"
9 android:layout_width="fill_parent"
10 android:layout_height="wrap_content"
11 android:layout_alignParentBottom="true"
12 android:background="@drawable/control_bar"
13 android:gravity="center"
14 toolbar:buttonNum="5"
15 toolbar:itemBackground="@drawable/control_bar_item_bg"/>
16 </RelativeLayout>
三、在自定义组件中,可以如下获得xml中定义的值:
1 TypedArray a = context.obtainStyledAttributes(attrs,R.styleable.ToolBar);
2 buttonNum = a.getInt(R.styleable.ToolBar_buttonNum, 5);
3 itemBg = a.getResourceId(R.styleable.ToolBar_itemBackground, -1);
4
5 a.recycle();
就这么简单的三步,即可完成对自定义属性的使用。
*********************************************************************
好了,基本用法已经讲完了,现在来看看一些注意点和知识点吧。
首先来看看attrs.xml文件。
该文件是定义属性名和格式的地方,需要用<declare-styleable name="ToolBar"></declare-styleable>包围所有属性。其中name为该属性集的名字,主要用途是标识该属性集。那在什么地方会用到呢?主要是在第三步。看到没?在获取某属性标识时,用到"R.styleable.ToolBar_buttonNum",很显然,他在每个属性前面都加了"ToolBar_"。
在来看看各种属性都有些什么类型吧:string , integer , dimension , reference , color , enum.
前面几种的声明方式都是一致的,例如:<attr name="buttonNum" format="integer"/>。
只有enum是不同的,用法举例:
1 <attr name="testEnum">
2 <enum name="fill_parent" value="-1"/>
3 <enum name="wrap_content" value="-2"/>
4 </attr>
如果该属性可同时传两种不同的属性,则可以用“|”分割开即可。
让我们再来看看布局xml中需要注意的事项。
首先得声明一下:xmlns:toolbar=http://schemas.android.com/apk/res/cn.zzm.toolbar
注意,"toolbar"代指xml文件所用的命名空间:http://schemas.android.com/apk/res/cn.zzm.toolbar (包括xmlns:android="http://schemas.android.com/apk/res/android"的命名空间也可以换成别的,如xmlns:hello="http://schemas.android.com/apk/res/android"但在其后指定命名空间的时候就只能用"hello"了),可以换成其他的任何名字,后面的url地址必须最后一部分必须加上R文件所在的包名。自定义属性了,在属性名前加上“toolbar”即可。
最后来看看java代码中的注意事项。
在自定义组件的构造函数中,用
TypedArray a = context.obtainStyledAttributes(attrs,R.styleable.ToolBar);
来获得对属性集的引用,然后就可以用“a”的各种方法来获取相应的属性值了。这里需要注意的是,如果使用的方法和获取值的类型不对的话,则会返回默认值。因此,如果一个属性是带两个及以上不用类型的属性,需要做多次判断,知道读取完毕后才能判断应该赋予何值。当然,在取完值的时候别忘了回收资源哦!