Android ApiDemos示例解析(106):Views->Chronometer

本例介绍了UI组件Chronometer的用法，Chronometer实现了一个简单的计时器。可以为计时器设置基准时间，Chronometer 的父类为一TextView，显示时间的格式为”MM:SS” 或”H:MM:SS” ，也允许使用setFormat 设置自定义的时间显示格式。

Chronometer 在Layout 中的定义，可以使用android:format 为计时器指定显示格式。

<Chronometer android:id=”@+id/chronometer”
 android:format=”@string/chronometer_initial_format”
 android:layout_width=”wrap_content”
 android:layout_height=”wrap_content”
 android:layout_weight=”0″
 android:paddingBottom=”30dip”
 android:paddingTop=”30dip”
 />

chronometer_initial_format 的定义如下：

Initial format: <xliff:g id=”initial-format”>%s</xliff:g>

xliff 定义用于帮助本地化，它的namespace 定义在文件顶部 <resources xmlns:xliff=”urn:oasis:names:tc:xliff:document:1.2″> ，可以参见文档

代码中取得Chronometer对象

mChronometer = (Chronometer) findViewById(R.id.chronometer);

启动计时器

mChronometer.start();

停止计时器

mChronometer.stop();

复位计时器，是通过重置计时器基准时间来实现的，SystemClock.elapsedRealtime() 为系统启动到目前为止的时间。

mChronometer.setBase(SystemClock.elapsedRealtime());

设置时间显示格式

mChronometer.setFormat("Formatted time (%s)");

其中%s 代表 MM:SS 或H:MM:SS

取消时间显示格式

mChronometer.setFormat(null);

恢复到缺省MM:SS或H:MM:SS

此外还可以为Chronometer 添加处理事件

public void setOnChronometerTickListener(Chronometer.OnChronometerTickListener listener)