Android ApiDemos示例解析(109):Views->Custom

Android 系统提供了很多功能强大的UI组件，包括Button,TextView, EditText, ListView, CheckBox, RadioButton, Gallery, Spinner ,AutoCompleteTestView 等以及LinerLayout, FrameLayout ,RelativeLayout 等布局管理组件可以应用于大部分的应用。

如果执行系统自带的UI控件不能满足应用的需要，Android允许你自定义UI控件，可以有多种方法来构造新的自定义UI控件：

• 修改或扩展系统自带的UI控件，这些系统定义的UI控件定义其对应的基本UI功能，比如Button 提供了按钮的功能，可以通过重载这些UI控件的事件和onDraw事件来扩充UI功能以及显示。
• 提供组合多个基本UI控件构造较为复杂的UI直接，比如可以使用TextView和Button（点击后显示一个浮点的ListView）来创建一个Dropdown 组合框控件。
• 以View 或ViewGroup 为基类构造一个全新的UI控件。

本例采用了第三种方法，创建了一个全新的LabelView：

android:background=”@drawable/red”
android:layout_width=”match_parent”
android:layout_height=”wrap_content”
app:text=”Red”/>

下面为构造完全自定义UI控件的一般步骤和注意事项，完全自定义UI控件的给开发人员最大的控制能力，可以显示任意的外观或实现系统定义的UI控件无法实现的功能。

1. 以View 为基类派生自定义View组件。
2. 实现使用Context, ArributeSet 为参数的构造函数，这些函数是使用XML描述UI时需调用的。
3. 创建所需要的自定义的事件Listener，属性等这一步不是必须的，可以根据UI组件功能自行决定。
4. 重载onMeasure 和onDraw ，缺省的onMeasure 将UI控件的大小定义为100X100大小，如果这个大小恰巧正是你需要的，你可以使用缺省的onMeasure，
5. 根据需要重载其它所需的on…方法。

这个自定义LabelView可以用来显示一行文字，定义了三个属性：

• text: 文字内容
• textSize：文字大小
• textColor:文字颜色

这些属性在layout 中使用 app:text=”Red”,app:textSize=”20dp”,app:textColor=”#ffffffff”

来看看LabelView 的具体实现:

首先以View为基类，并定义了LabelView的几个属性，用来保存文字的大小，内容和颜色，mText为文字内容，其它两个保存了颜色和大小。

public class LabelView extends View {
 private Paint mTextPaint;
 private String mText;
 private int mAscent;

然后实现构造函数

public LabelView(Context context) {
 super(context);
 initLabelView();
}

public LabelView(Context context, AttributeSet attrs) {
 super(context, attrs);
 initLabelView();
 ...
}

其中public LabelView(Context context, AttributeSet attrs) 是使用Layout定义LabelView必须实现的。而且一般需要调用基类的对应方法。如果不定义该构造函数，此时如果在Layout定义LabelView，Android展开Layout资源文件时找不到所需构造函数，应用将抛出异常退出。

因为LabelView定义了三个自定义属性Text, TextSize,TextColor ，并可以用在Layout定义中，在构造函数中可以获取这些属性值。

自定义属性的步骤如下：

1. 在 values\attrs.xml 中定义属性 ，如LabelView定义的属性如下：

< /declare-styleable>

如果使用系统支持的属性如android:text 则不需要定义format 属性。这个attrs 对应的ID为 R.styleable.LableView (自动生成在R.java 中）

2. 使用Context 的 obtainStyledAttributes 获取属性值

 TypedArray a = context.obtainStyledAttributes(attrs,
 R.styleable.LabelView);

CharSequence s
 = a.getString(R.styleable.LabelView_text);

setTextColor(a.getColor(R.styleable.LabelView_textColor,
 0xFF000000));

int textSize
 = a.getDimensionPixelOffset(R.styleable.LabelView_textSize, 0);

obtainStyledAttributes 返回的类型为TypedArray ,然后就可以使用TypedArray的getXXX方法来取得所需的属性值，第一个参数为属性的ID，第二个参数为找不到对应属性时缺省值。

3.在Layout XML 文件中添加 属性对应的namespace 定义，如

xmlns:app=”http://schemas.android.com/apk/res/com.example.android.apis

然后就可以使用app:xxx 来引用自定义控件的属性了，如：

android:background=”@drawable/blue”
android:layout_width=”match_parent”
android:layout_height=”wrap_content”
app:text=”Blue” app:textSize=”20dp”/>

4.属性property对应的代码为 getProperty, setProperty

如text 的设置方法：

public void setText(String text) {
 mText = text;
 requestLayout();
 invalidate();
}

然后一个重要的方法是onMeausre ,在这个方法在必须调用setMeasureDimension 方法来告诉本View的Container类（各种Layout类型）所需占据的大小，如果没有设置setMeasureDimension ，Layout将会抛出异常。

 protected void onMeasure(int widthMeasureSpec,
 int heightMeasureSpec) {
 setMeasuredDimension(measureWidth(widthMeasureSpec),
 measureHeight(heightMeasureSpec));
}

onMeasure方法来父Layout类为其子类布局时调用，它为某个子类“你需要多大的空间”，传入两个参数：widthMeasureSpec 和heighMeasureSpec ,它们给出了这个UI控件可以使用的空间大小规格参数。 本例使用的measureWidth和measureHeight 代码基本上可以重用到所有的自定义控件中。

最后一步是重载onDraw方法，在屏幕上显示控件的内容：

protected void onDraw(Canvas canvas) {
 super.onDraw(canvas);
 canvas.drawText(mText, getPaddingLeft(),
 getPaddingTop() - mAscent, mTextPaint);
}

onDraw 传入的参数类型为Canvas ，可以使用Canvas绘制任意图形，可以参见ApiDemos 中Graphics 例子。本例根据文本的颜色，大小绘制文本。

如果需要使用3D （OpenGL ES )图形，就不能从View 派生，而应使用SurfaceView 作为基类。

本例代码：