原文地址:
http://developer.android.com/training/custom-views/create-view.html#addprop
上一份代码声明了两个属性,
注意:在xml中使用自定义类时,需要使用类的全名,如 com.example.customviews.charting.PieChart ,当自定义类为一个内部类时如下 :com.example.customviews.charting.PieChart$PieView。
自定义view
android平台有大量的视图类用于用户交互和展示各种不同的数据,但是很多时候系统的组件无法满足我们的要求,我们需要自行创建,这篇文章将告诉我们如何创建强壮并可重复使用的自定义视图。
索引
1、创建视图类
2、自定义绘制
3、交互设计
4、优化
创建视图类
一个设计良好自定义视图,就像其他精心设计的类一样。它提供良好的接口,封装了特定的功能,并能最有效率的使用CPU、内存等有限的资源。所以,一个良好的应该是:
* 符合android平台规范
* 封装自定义属性,并可在android布局xml中使用
* 可访问的事件
* 适用于android各平台
android已经提供了基础的view类及xml标签,下面我们来讨论如何实现自定义view的核心功能。
子类
android中所有的视图都继承自View,我们同样需要这样做,或者我们也可以直接继承其子类,如Button。
如果我们希望自定义类能够使用在布局xml中,我们至少需要提供使用了Context和AttributeSet这两个参数的构造方法。
class PieChart extends View {
public PieChart(Context context, AttributeSet attrs) {
super(context, attrs);
}
}
设计自定义属性
上一节我们讨论了如何设置自定义属性并设置它们的值,这一节我们将来学习如何处理检索和应用这些属性。
自定义属性,先在
res/values/attrs.xml
文件中中创建<declare-styleable>标签。
<resources>
<declare-styleable name="PieChart">
<attr name="showText" format="boolean" />
<attr name="labelPosition" format="enum">
<enum name="left" value="0"/>
<enum name="right" value="1"/>
</attr>
</declare-styleable>
</resources>
showText
和
labelPosition
,属于名为PieChart的样式。根据惯例,我们会让样式名称与自定义类名称一样。当然这不是必须的,只是很多流程的代码编辑器会根据这个命名习惯来进行代码提示。
当你定义好这些属性后,就可以在布局xml文件中使用它们了。它跟内置属性的据别在于,内置属性使用http://schemas.android.com/apk/res/android的命名空间,而自定义的使用http://schemas.android.com/apk/res/[your package name],例如:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:custom="http://schemas.android.com/apk/res/com.example.customviews">
<com.example.customviews.charting.PieChart
custom:showText="true"
custom:labelPosition="left" />
</LinearLayout>
注意:在xml中使用自定义类时,需要使用类的全名,如 com.example.customviews.charting.PieChart ,当自定义类为一个内部类时如下 :com.example.customviews.charting.PieChart$PieView。
增加自定义属性
当一个组件在xml布局定义被创建时,所有的属性将会被读取并传入到view的构造函数中,参数是AttributeSet.
尽管我们可以从AttributeSet中读取到属性,但还是有一些缺点:
* 当资源文件未被解析时
* 样式文件不适用
这时候我们需要使用obtainStyledAttributes()方法来解析参数,这些参数将被解析到TypedArray中。
public PieChart(Context context, AttributeSet attrs) {
super(context, attrs);
TypedArray a = context.getTheme().obtainStyledAttributes(
attrs,
R.styleable.PieChart,
0, 0);
try {
mShowText = a.getBoolean(R.styleable.PieChart_showText, false);
mTextPos = a.getInteger(R.styleable.PieChart_labelPosition, 0);
} finally {
a.recycle();
}
}
添加属性和事件
属性是一个强有力的控制组件行为及样式的方式,不过他们只能在组件初始化时起作用,需要动态的控制组件的行为,首先我们需要给自定义属性设置
get和set方法,下面我们我们给
PieChart
设置了一个属性
showText。
public boolean isShowText() {
return mShowText;
}
public void setShowText(boolean showText) {
mShowText = showText;
invalidate();
requestLayout();
}
请注意我们在
setShowText()
中调用了invalidate()和requestLayout()方法,在改变了值后我们需要改变其样式,
或我们需要根据大小来改变其布局。
自定义组件也需要支持事件通信,在这个列子中,PieChart定义了一个自定义事件OnCurrentitemChanged(),提示用户图标的焦点到了一个新的块上。
我们很容易忘记暴露属性和事件,特别是当自由我们自己使用时。可花费一些时间慎重的定义这些,可减少以后的维护时间。一个好的原则是始终暴露那些会影响组件行为和样式的属性。