Android自定义控件系列二：如何自定义属性，android控件,对于一个完整的或者说真正

Android自定义控件系列二：如何自定义属性，android控件,对于一个完整的或者说真正

上一篇Android自定义控件系列一：如何测量控件尺寸 我们讲了如何确定控件的属性，这篇接着也是讲个必要的知识-如何自定义属性。对于一个完整的或者说真正有实用价值的控件，自定义属性是必不可少的。

如何为控件定义属性

在res/values/attrs.xml(attrs.xml如果不存在，可以创建个)中使用<declare-styleable>标签定义属性，比如我想定义个显示头像的圆形的图片控件(AvatarImageView)：

<?xml version="1.0" encoding="utf-8"?>
<resources>  
<declare-styleable name="avatarimageview">
  <attr name="src" format="reference" />
  <attr name="border" format="dimension" />
  <attr name="borderColor" format="reference|color" />
  <attr name="borderAlpha" format="integer" />
  </declare-styleable>
</resources>

name="avatarimageview"指定这组属性的名称，一般可以写成控件名称，标识这些属性是某个控件的。<attr>定义具体的属性，如src--定义图片的来源，border--定义控件的边框大小，borderColor--边框颜色等等。format指定属性值的类型，reference是引用类型，如引用图片、引用颜色、引用文字等。dimension是dp值。integer是整形。color是颜色编码，如果颜色编码是在colors.xml中定义的，此时要用reference，如果俩种方式都支持，中间用竖线分割。

如何获得属性值

属性的定义实际上是为了构建控件的，如上例，只有通过src拿到图片才能画，只有拿到border，才知道我要画多大的边框，所以在实例化控件之前必须能够获得属性及属性值。

为此我们必须要重写View的俩个构造方法，通过AttributeSet参数获得属性值：

	View(Context context) Simple constructor to use when creating a view from code. 用于通过java代码实例化控件时使用
	View(Context context, AttributeSet attrs) Constructor that is called when inflating a view from XML. 用于在布局文件中，通过xml代码创建的控件

对于第一个构造方法，完全可以通过setXXX()来注入属性，对于上面的属性定义是没有意义，我们着重说下如何获得布局文件中的属性值。

public AvatarImageView(Context context, AttributeSet attrs) {
		super(context, attrs);
		TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.avatarimageview);
		src = a.getResourceId(R.styleable.avatarimageview_src, 0);
		if(src != 0)
		    bitmap = BitmapFactory.decodeResource(this.getResources(), src);
		
		border = (int)a.getDimension(R.styleable.avatarimageview_border, dip2px(this.getContext(), 6));
		
		borderColor = (int)a.getColor(R.styleable.avatarimageview_borderColor, 0);
		if(borderColor == 0)
			borderColor = a.getResourceId(R.styleable.avatarimageview_borderColor, 0);
		if(borderColor == 0)
			borderColor = 0x9F7A97EA;
		
		borderAlpha = a.getInt(R.styleable.avatarimageview_borderAlpha, -1);
	}

通过obtainStyledAttributes()方法获得名称avatarimageview下的所有属性的集合TypedArray。通过TypedArray就可以获得具体的属性值了。如上面代码。

如何在布局文件中使用属性

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:my="http://schemas.android.com/apk/res/com.kanyuan.avatarimageview"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" 
    android:gravity="center">
    <LinearLayout android:layout_width="wrap_content" android:layout_height="wrap_content" android:orientation="vertical">
        <com.kanyuan.avatarimageview.AvatarImageView android:id="@+id/avatarImageView" my:src="@drawable/head" my:border="2dp" android:layout_width="200dp" android:layout_height="200dp"/>
        <Button android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_marginTop="20dp" android:text="改变头像" android:onClick="changeAvatar"/>
    </LinearLayout>
    
</LinearLayout>

假如我的控件定义在了com.kanyuan.avatarimageview包下。

首先要引入命名空间：xmlns:命名空间名称="http://schemas.android.com/apk/res/app的包名"，然后通过这个命名空间引用属性，如：my:src="@drawable/head"、my:border="2dp"。之后就可以在构造方法中获得属性值了。

这样就和上篇的测量尺寸的文章接上了，通过获得padding、border等属性来计算控件实际需要多大的空间。

具体关于这个头像控件的完整源码：http://www.see-source.com/androidwidget/detail.html?wid=28