Android自定义控件的属性

Android中可以自定义控件,有时候我们需要为这些自定义的空间加上一些属性,Java代码中可以定义属性变量没有问题,那么XML文件中怎么使用属性呢?那么就需要在XML文件中自定义控件属性。(可以参照D:\android-sdk\platforms\android-16\data\res\values\attrs.xml,只是Android系统的属性定义的文件)


假如我们现在写了一个CommonTitle自定义控件

[java]  view plain copy
  1. public class CommonTitle extends LinearLayout {  
  2.   
  3.         private Color textColor;  
  4.   
  5.         private float textSize;  
  6.   
  7.         private String text;  
  8.   
  9. }  

这个CommonTitle有三个属性:textColor,textSize,text


当我在布局文件中使用这个CommonTitle的时候,怎么对这3个属性设值呢?你可能会想起来android:textColor,但是这是我们自己写的控件,所以你设了android:textColor也没有用,那么可不可以自己定义一个属性呢?比如说myAndroid:textColor,答案是完全可以!


一、定义自定义控件属性需要在res/values文件下定义一个attrs.xml文件,代码如下:

[html]  view plain copy
  1. <?xml version="1.0" encoding="utf-8"?>  
  2. <resources>  
  3.     <declare-styleable name="CommonTitle">  
  4.         <attr name="text" format="string"></attr>  
  5.         <attr name="textColor" format="color"></attr>  
  6.         <attr name="textSize" format="dimension"></attr>  
  7.     </declare-styleable>  
  8. </resources>  
这样我们就自定义了三个控件属性

二、在布局xml中如下使用该属性:

[html]  view plain copy
  1. <?xml version="1.0" encoding="utf-8"?>  
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
  3.     xmlns:myAndroid="http://schemas.android.com/apk/res/com.tianjf"  
  4.     android:layout_width="fill_parent"  
  5.     android:layout_height="fill_parent" >  
  6.       
  7.     <com.tianjf.view.CommonTitle  
  8.         android:layout_width="fill_parent"  
  9.         android:layout_height="50dip"  
  10.         myAndroid:text="@string/str_weightlist_title"  
  11.         myAndroid:textColor="@android:color/darker_gray"  
  12.         myAndroid:textsize="@dimen/weight_list_title_text_size" />  
  13.   
  14. </LinearLayout>  

三、在自定义组件中,可以如下获得xml中定义的值:

[java]  view plain copy
  1. public CommonTitle(Context context, AttributeSet attrs) {  
  2.     super(context, attrs);  
  3.     mContext = context;  
  4.     TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.CommonTitle);  
  5.     mText = a.getString(R.styleable.CommonTitle_text);  
  6.     mTextColor = a.getColor(R.styleable.CommonTitle_textColor,    
  7.             0XFFFFFFFF);    
  8.     mTextSize = a.getDimensionPixelSize(R.styleable.CommonTitle_textSize, 0);  
  9.     a.recycle();  
  10. }  

以上三步就完成了自定义属性的创建和使用


首先来看看attrs.xml文件

<declare-styleable name="CommonTitle">中的name会在java代码中用到,可以看第三步

属性的formart可以有下面几种

string , integer , dimension , reference , color , enum.

前面几种的声明方式都是一致的,例如:<attr name="buttonNum" format="integer"/>。 
只有enum是不同的,用法举例:

[html]  view plain copy
  1. <attr name="testEnum">  
  2.     <enum name="fill_parent" value="-1"/>  
  3.     <enum name="wrap_content" value="-2"/>  
  4. </attr>   

如果该属性可同时传两种不同的属性,则可以用“|”分割开即可。


让我们再来看看布局xml中需要注意的事项。

首先得声明一下:xmlns:myAndroid=http://schemas.android.com/apk/res/com.tianjf
注意,“myAndroid”可以换成其他的任何名字,后面的url地址必须最后一部分必须用上自定义组件的包名。自定义属性了,在属性名前加上“myAndroid”即可。


最后来看看java代码中的注意事项。

在自定义组件的构造函数中,用

[java]  view plain copy
  1. TypedArray a = context.obtainStyledAttributes(attrs,R.styleable.CommonTitle);  
来获得对属性集的引用,然后就可以用“a”的各种方法来获取相应的属性值了。这里需要注意的是,如果使用的方法和获取值的类型不对的话,则会返回默认值。因此,如果一个属性是带两个及以上不用类型的属性,需要做多次判断,知道读取完毕后才能判断应该赋予何值。当然,在取完值的时候别忘了回收资源哦!

你可能感兴趣的:(Android自定义控件的属性)