android自定义控件(1)-自定义控件属性
那么还是针对我们之前写的自定义控件：开关按钮为例来说，在之前的基础上，我们来看看有哪些属性是可以自定义的：按钮的背景图片，按钮的滑块图片，和按钮的状态（是开还是关），实际上都应该是可以在xml文件中直接定义的。
不妨先来看看之前我们在代码中不依靠自定义属性的时候，是如何写的，我们可以在initView方法中找到这样几行代码：
backgroundBitmap = BitmapFactory.decodeResource(getResources(), R.drawable.switch_background); slideButton = BitmapFactory.decodeResource(getResources(), R.drawable.slide_button); currentState=false;
会发现，我们是直接引用的资源文件，而不是在布局xml文件中使用的定义属性的方式，下面我们一步步来看看要怎么样做才可以定义使用上自定义属性：
第一步：在res/values文件夹中添加attrs.xml文件
实际上，这个文件名并不一定要写成attrs.xml，但是按照android源码的写法并且也便于别人查看代码的时候明确这个文件的用意，还是写成attrs.xml。
下面要如何写呢，我们还是可以参看一下安卓的源码：打开源码文件夹下\frameworks\base\core\res\res\values\attrs.xml文件,我们会发现这里面定义了很多attr的标签，里面不乏一些我们常见的属性:
<attr name="layout_width" format="dimension">
等等，在layout_width这个标签上面我们还可以发现一个
<declare-styleable name="ViewGroup_Layout">
declare-styleable标签的里包含了很多根ViewGruop相关的属性。
而在这个attrs.xml文件的最外面，是一个<resources>的标签
到这里，我们基本上就明白了一个attrs.xml文件的结构了：
首先要一个<resources>的父标签，然后里面可以包含一个declare-styleable的标签，在这个标签里面我们再定义出三个attr 标签，分别代表我们需要定义的三个属性：按钮的背景图片，按钮的滑块图片，和按钮的状态；那么剩下的一个问题就是attr标签中的format代表什么意思。实际上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.xml文件写成下面这样：
<?xml version="1.0" encoding="utf-8"?> <resources> <declare-styleable name="DJSwitch"> <attr name="current_state" format="boolean"/> <attr name="backgroundImage" format="reference"/> <attr name="slideImage" format="reference"/> </declare-styleable> </resources>
第二步：在自定义控件的类中拿到attrs.xml文件中定义的属性的对应的值，然后赋值给我们需要设置的变量，在这里就是 背景图片，滑块图片和开关状态 这三个值。
要如何做呢？我们先将上面给出的
backgroundBitmap = BitmapFactory.decodeResource(getResources(), R.drawable.switch_background); slideButton = BitmapFactory.decodeResource(getResources(), R.drawable.slide_button); currentState=false;
这三句注释掉，然后换成下面的代码
/** * 初始化View */ private void initView(Context context, AttributeSet attrs) { /* * 从资源库中加载一个image对象 * ios UIImage *backgroundImage = [UIImage imageNamed:@"app_switch_bg"]; * 也就是说,android里面的图像实体bitmap,可以当成是ios中的UIImage * 区别在于,ios中UIImage可以通过类方法来获取，android里面则是通过工厂方法来实现 */ /*switch_bg_img = BitmapFactory.decodeResource(getResources(), R.drawable.app_switch_bg); switch_btn_img = BitmapFactory.decodeResource(getResources(), R.drawable.app_switch_btn); */ // 可以把这个TypedArray看成是一个包含了DJSwitch属性集合的HashMap TypedArray typedArray = context.obtainStyledAttributes(attrs,R.styleable.DJSwitch); // 获取该集合中共有多少个index int indexCount = typedArray.getIndexCount(); for (int i = 0; i < indexCount; i++) { int id = typedArray.getIndex(i); switch (id) { case R.styleable.DJSwitch_backgroundImage: switch_bg_img = ((BitmapDrawable)typedArray.getDrawable(id)).getBitmap(); break; case R.styleable.DJSwitch_slideImage: switch_btn_img = ((BitmapDrawable)typedArray.getDrawable(id)).getBitmap(); break; case R.styleable.DJSwitch_current_state: currentState = typedArray.getBoolean(id, false); break; default: break; } } switchBtnMaxSlideDistance = switch_bg_img.getWidth() - switch_btn_img.getWidth(); if (currentState) { switchBtnX = switchBtnMaxSlideDistance; } else { switchBtnX = 0; } typedArray.recycle(); // 添加监听 setOnClickListener(new MyOnSwitchClickListener()); // 可以理解为ios中的addTarget方法，或addGestureRecognizer }
注释上面已经写得很清楚了，TypedArray会把XML文件所引用的自定义属性和值保存在一个Map表中，因此我们可以根据该Map的键(即：属性的ID)取出该属性对应的值。
第三步：在布局文件中使用自定义属性，并设置属性值：
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:alex="http://schemas.android.com/apk/res/com.example.test" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" > <!-- 为了清楚的看见该View的大小及位置，给其定义背景 --> <com.example.test.view.DJSwitch android:id="@+id/sw_switch" android:layout_width="wrap_content" android:layout_height="wrap_content" android:background="#ff0000" android:layout_centerInParent="true" alex:current_state="false" alex:backgroundImage="@drawable/app_switch_bg" alex:slideImage="@drawable/app_switch_btn" /> </RelativeLayout>
在上面的代码，我们发现我们写成了alex:这样的标头，这个实际上是命名空间的简写(默认是app)，所以我们必须要添加一个命名空间，参看一下Android的命名空间是如何写的：
xmlns:android="http://schemas.android.com/apk/res/android"
在这里xmlns:android里面的android，是可以变化的，这里我们就改为alex，然后对于http://schemas.android.com/apk/res/android这个部分，最后的android也要改的，这里必须改成整个应用的包名，我们可以去清单文件中查找，这里是com.example.togglebutton，所以整个写下来就是：xmlns:alex="http://schemas.android.com/apk/res/com.example.test"
于是这里一个完整的布局文件写为：
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:alex="http://schemas.android.com/apk/res/com.example.test" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" > <!-- 为了清楚的看见该View的大小及位置，给其定义背景 --> <com.example.test.view.DJSwitch android:id="@+id/sw_switch" android:layout_width="wrap_content" android:layout_height="wrap_content" android:background="#ff0000" android:layout_centerInParent="true" alex:current_state="false" alex:backgroundImage="@drawable/app_switch_bg" alex:slideImage="@drawable/app_switch_btn" /> </RelativeLayout>
至此，在XML自定义按钮属性的基本步骤已经全部完毕了。不过如果我们想同时在代码中设置该按钮的属性该如何做呢？，很简单，在代码中为这三个自定义的按钮属性分别建立一个成员变量。
DJSwitch.java
/** * 标识当前按钮状态 * 类似于iOS中.h文件里声明property 为BOOL类型的属性 */ private boolean currentState; /** 滑动按钮背景 */ private Bitmap switch_bg_img; /** 滑动按钮滑块 */ private Bitmap switch_btn_img;
同时提供三个接口方法
/** * 设置当前按钮开关状态 * @param isOpen true: 开,false: 关 */ public void setCurrentSwitchState(boolean isOpen) { this.currentState = isOpen; if (isOpen) { switchBtnX = switchBtnMaxSlideDistance; } else { switchBtnX = 0; } invalidate(); } /** * 设置当前按钮背景图片 * @param resId 资源ID */ public void setBackgroundImage(int resId) { switch_bg_img = BitmapFactory.decodeResource(getResources(), resId); // 因背景图片更改,须同时更新滑块最大移动距离 switchBtnMaxSlideDistance = switch_bg_img.getWidth() - switch_btn_img.getWidth(); invalidate(); // 相当于iOS中setNeedDisplay方法 } /** * 设置滑动按钮图片 * @param resId 资源ID */ public void setSlideBtnImage(int resId) { switch_btn_img = BitmapFactory.decodeResource(getResources(), resId); switchBtnMaxSlideDistance = switch_bg_img.getWidth() - switch_btn_img.getWidth(); invalidate(); }
MainActivity.java
package com.example.test; import com.example.test.view.DJSwitch; import android.app.Activity; import android.os.Bundle; public class MainActivity extends Activity { private DJSwitch sw_switch; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); initUIView(); } private void initUIView() { sw_switch = (DJSwitch) findViewById(R.id.sw_switch); sw_switch.setCurrentSwitchState(true); sw_switch.setSlideBtnImage(R.drawable.ic_launcher); } }
最终效果：
