创建一个视图类
精心设计的自定义视图与其他精心设计的类非常相似。它使用易于使用的界面封装了一组特定的功能,它可以高效地使用CPU和内存,等等。不过,作为一个设计良好的设计,自定义视图应该:
符合Android标准
提供适用于Android XML布局的自定义样式属性
发送无障碍事件
与多个Android平台兼容。
Android框架提供了一组基本类和XML标签,可帮助您创建满足所有这些要求的视图。本课讨论如何使用Android框架来创建视图类的核心功能。
子视图
所有在Android框架中定义的视图类都会扩展View。您的自定义视图也可以View直接扩展,或者您可以通过扩展其中一个现有视图子类来节省时间,例如Button。
要允许Android Studio与视图进行交互,至少必须提供一个构造函数,该构造函数将 参数Context和AttributeSet对象作为参数。该构造函数允许布局编辑器创建和编辑视图的实例。
class PieChart extends View {
public PieChart (Context context ,AttributeSet attrs )
{
super (context ,attrs );
}
}
定义自定义属性
要View为您的用户界面添加内置内容,您需要在XML元素中指定它并使用元素属性控制其外观和行为。写得很好的自定义视图也可以通过XML添加和设置样式。要在自定义视图中启用此行为,您必须:
在 资源元素中 定义视图的自定义属性
在XML布局中指定属性的值
在运行时检索属性值
将检索到的属性值应用于您的视图
本节讨论如何定义自定义属性并指定它们的值。下一节将讨论在运行时检索和应用这些值。
要定义自定义属性,请将 资源添加到您的项目中。习惯上把这些资源放到一个res/values/attrs.xml文件中。这是一个attrs.xml文件的例子:
<resource> name = “ PieChart ” >
<attr name = “labelPosition” format = “enum” >
<enum name = ”right“ value = ”1“ />
</ resources>
此代码声明了两个自定义属性,showText并且labelPosition属于名为的可修改实体PieChart。按照惯例,可修改实体的名称与定义自定义视图的类的名称相同。尽管遵循这个约定并不是严格必要的,但是许多流行的代码编辑器依赖于这个命名约定来提供语句完成。
一旦定义了自定义属性,自定义属性名称空间。http://schemas.android.com/apk/res/[your package name]。例如,以下是如何使用为以下内容定义的属性 PieChart:
<?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>
为了避免重复使用长名称空间URI,示例使用了一个xmlns指令。该指令将别名分配custom给名称空间http://schemas.android.com/apk/res/com.example.customviews。你可以选择任何你想要的命名空间的别名。
注意将自定义视图添加到布局的XML标记的名称。它是自定义视图类的完全限定名称。如果你的视图类是一个内部类,你必须进一步用视图外部类的名称来限定它。进一步。例如, PieChart该类有一个名为的内部类PieView。要使用这个类的自定义属性,你可以使用标签com.example.customviews.charting.PieChart$PieView。
应用自定义属性
从XML布局创建视图时,将从资源束中读取XML标记中的所有属性,并以视图的形式传递到视图的构造函数中AttributeSet。尽管可以AttributeSet直接读取值,但这样做有一些缺点:
属性值中的资源引用未解析
样式不适用
相反,传递AttributeSet给obtainStyledAttributes()。该方法返回TypedArray已经解除引用和样式化的值数组。
Android资源编译器为您的调用做了很多工作obtainStyledAttributes() 。对于 res目录中的每个资源,生成的R.java都定义了一个属性ID数组和一组定义数组中每个属性索引的常量。您使用预定义的常量从中读取属性TypedArray。以下是PieChart该类如何读取其属性:
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();
}
}
添加属性和事件
属性是控制视图行为和外观的有效方式,但只有在初始化视图时才能读取它们。要提供动态行为,请为每个自定义属性公开属性getter和setter对。以下片段显示了如何PieChart公开一个名为的属性showText:
public boolean isShowText (){
return mShowText ;
}
public void setShowText (boolean showText ){
mShowText = showText ;
requestLayout ();
}
注意setShowText呼叫invalidate() 和requestLayout()。这些调用对于确保视图可靠运行至关重要。在对其属性进行任何更改后,必须使该视图无效,这可能会改变其外观,以便系统知道它需要重绘。同样,如果属性更改可能会影响视图的大小或形状,则需要请求新布局。忘记这些方法调用会导致难以发现的错误。
自定义视图还应该支持事件监听器来传达重要事件。例如,PieChart 公开调用的自定义事件OnCurrentItemChanged以通知侦听器用户已将饼图旋转到专注于新饼图片段。
很容易忘记公开属性和事件,特别是当您是自定义视图的唯一用户时。花一些时间仔细确定您的视图界面可以减少未来的维护成本。遵循的一条好规则是始终公开影响自定义视图的可见外观或行为的任何属性。
无障碍设计
您的自定义视图应该支持最广泛的用户。这包括防止他们看到或使用触摸屏的残障用户。为了支持残疾用户,您应该:
使用android:contentDescription属性 标记您的输入字段
sendAccessibilityEvent()适当时通过呼叫发送辅助功能事件。
支持备用控制器,如D-pad和轨迹球
参考文章
https://developer.android.google.cn/training/custom-views/create-view.html#addprop