Android中可以自定义控件,有时候我们需要为这些自定义的空间加上一些属性,Java代码中可以定义属性变量没有问题,那么XML文件中怎么使用属性呢?那么就需要在XML文件中自定义控件属性。(可以参照D:\android-sdk\platforms\android-16\data\res\values\attrs.xml,只是Android系统的属性定义的文件)
假如我们现在写了一个CommonTitle自定义控件
- public class CommonTitle extends LinearLayout {
-
- private Color textColor;
-
- private float textSize;
-
- private String text;
-
- }
这个CommonTitle有三个属性:textColor,textSize,text
当我在布局文件中使用这个CommonTitle的时候,怎么对这3个属性设值呢?你可能会想起来android:textColor,但是这是我们自己写的控件,所以你设了android:textColor也没有用,那么可不可以自己定义一个属性呢?比如说myAndroid:textColor,答案是完全可以!
一、定义自定义控件属性需要在res/values文件下定义一个attrs.xml文件,代码如下:
- <?xml version="1.0" encoding="utf-8"?>
- <resources>
- <declare-styleable name="CommonTitle">
- <attr name="text" format="string"></attr>
- <attr name="textColor" format="color"></attr>
- <attr name="textSize" format="dimension"></attr>
- </declare-styleable>
- </resources>
这样我们就自定义了三个控件属性
二、在布局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/com.tianjf"
- android:layout_width="fill_parent"
- android:layout_height="fill_parent" >
-
- <com.tianjf.view.CommonTitle
- android:layout_width="fill_parent"
- android:layout_height="50dip"
- myAndroid:text="@string/str_weightlist_title"
- myAndroid:textColor="@android:color/darker_gray"
- myAndroid:textsize="@dimen/weight_list_title_text_size" />
-
- </LinearLayout>
三、在自定义组件中,可以如下获得xml中定义的值:
- public CommonTitle(Context context, AttributeSet attrs) {
- super(context, attrs);
- mContext = context;
- TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.CommonTitle);
- mText = a.getString(R.styleable.CommonTitle_text);
- mTextColor = a.getColor(R.styleable.CommonTitle_textColor,
- 0XFFFFFFFF);
- mTextSize = a.getDimensionPixelSize(R.styleable.CommonTitle_textSize, 0);
- a.recycle();
- }
以上三步就完成了自定义属性的创建和使用
首先来看看attrs.xml文件
<declare-styleable name="CommonTitle">中的name会在java代码中用到,可以看第三步
属性的formart可以有下面几种
string , integer , dimension , reference , color , enum.
前面几种的声明方式都是一致的,例如:<attr name="buttonNum" format="integer"/>。
只有enum是不同的,用法举例:
- <attr name="testEnum">
- <enum name="fill_parent" value="-1"/>
- <enum name="wrap_content" value="-2"/>
- </attr>
如果该属性可同时传两种不同的属性,则可以用“|”分割开即可。
让我们再来看看布局xml中需要注意的事项。
首先得声明一下:xmlns:myAndroid=http://schemas.android.com/apk/res/com.tianjf
注意,“myAndroid”可以换成其他的任何名字,后面的url地址必须最后一部分必须用上自定义组件的包名。自定义属性了,在属性名前加上“myAndroid”即可。
最后来看看java代码中的注意事项。
在自定义组件的构造函数中,用
- TypedArray a = context.obtainStyledAttributes(attrs,R.styleable.CommonTitle);
来获得对属性集的引用,然后就可以用“a”的各种方法来获取相应的属性值了。这里需要注意的是,如果使用的方法和获取值的类型不对的话,则会返回默认值。因此,如果一个属性是带两个及以上不用类型的属性,需要做多次判断,知道读取完毕后才能判断应该赋予何值。当然,在取完值的时候别忘了回收资源哦!