android 中文 api （43） —— Chronometer
正文
一、结构
public class Chronometer extends TextView
java.lang.Object
android.widget.Chronometer
二、概述
类实现了一个简单的计时器。
你可以通过elapsedRealtime()来给它一个基准时间，并从该时间开始计数。如果你不给它基准时间，它将使用你调用start()时的时间。默认它将显示当前"MM:SS"或 "H:MM:SS"格式的时间,或者你能通过setFormat(String)设置一个任意字符串来格式化显示计时器显示的时间。
三、XML属性
| 属性名称 |
描述 |
| android:format |
格式化字符串:如果指定，计时器将根据这个字符串来显示，替换字符串中第一个“%s”为当前"MM:SS"或"H:MM:SS"格式的时间显示。如果不指定，计时器将简单的显示"MM:SS" or "H:MM:SS"格式的时间。（译者注：如： |
四、构造函数
public Chronometer (Context context)
初始化计时器对象。设置当前时间为基准时间。（译者注：通过程序动态创建计时器对象）
public Chronometer (Context context, AttributeSet attrs)
初始化标准视图布局信息。设置当前时间为基准时间。（译者注：指通过XML来指定一个计时器）
public Chronometer (Context context, AttributeSet attrs, int defStyle)
初始化标准视图布局信息和风格。设置当前时间为基准时间。
五、公共方法
public long getBase ()
返回先前由setBase(long)设置的基准时间。
public String getFormat ()
返回先前由setFormat(String)设置的格式化字符串。
public Chronometer.OnChronometerTickListener getOnChronometerTickListener ()
返回值
返回这个监听器（可能为空）是用于监听计时器变化的事件。
public void setBase (long base)
设置基准时间（译者注：基准时间为真正意义上开始计时的时间，而不是调用start时时间，比如调用本函数并设置参数base为SystemClock.elapsedRealtime()即表示从当前时间开始重新计时）。
参数
base 使用elapsedRealtime()为基准时间
public void setFormat (String format)
设置用于显示的格式化字符串。格式化字符串:如果指定，计时器将根据这个字符串来显示，替换字符串中第一个“%s”为当前"MM:SS"或 "H:MM:SS"格式的时间显示。如果这个格式化字符串为空，或者你从未调用过setFormat()方法，计时器将简单的显示"MM:SS" or "H:MM:SS"格式的时间。（译者注：如："This is a Chronometer %s"）
参数
format 格式化字符串
public void setOnChronometerTickListener(Chronometer.OnChronometerTickListener listener)
设置计时器变化时调用的监听事件。
参数
listener The listener.
public void start ()
开始计时。不会影响到由setBase(long)设置的基准时间，仅显示视图。即使部件不显示，计时器也会通过定时处理消息来工作。为了确保不发生资源泄漏，用户应确保每个start()方法都有对应的stop()调用（译者注：有一个start就有一个stop）。（译者注：start只是显示计时，实际上计时是从基准时间开始的，所以通过stop停止计时若干秒后再start时，显示的计时会突然跳到当前显示的计时后的若干秒后继续计时，见此帖子。）
public void stop ()
停止计时。不会影响到由setBase(long)设置的基准时间，仅显示视图。这将停止消息发送，有效地释放计时器运行时start()占用的资源。
六、受保护方法
protected void onDetachedFromWindow ()
视图从窗体上移除时调用，同时窗体表面不再显示视图。
protected void onWindowVisibilityChanged (int visibility)
当窗体中视图的可视性（GONE, INVISIBLE, VISIBLE）发生改变时调用。注意它将告诉你你的窗口是否可以被窗口管理器识别，这并不能说明窗口是否被屏幕上的其他窗口遮挡，即使它本身是可见的。
参数
visibility 窗口新的可见性
七、补充
文章链接
android中的时间服务–Chronometer计时器服务
示例代码
Java文件
private Chronometer cher1;
@Override
protected void onCreate(Bundle savedInstanceState) {
super .onCreate(savedInstanceState);
setContentView(R.layout.chronometer);
cher1 = (Chronometer) findViewById(R.id.cher1);
cher1.setFormat( " 计时：%s " );
}
/**
* 开始计时
* @param view
*/
public void onStart(View view) {
cher1.start();
}
/**
* 停止计时
* @param view
*/
public void onStop(View view) {
cher1.stop();
}
/**
* 重置
* @param view
*/
public void onReset(View view) {
cher1.setBase(SystemClock.elapsedRealtime());
}
}
XML文件
android:layout_width ="wrap_content" android:layout_height ="wrap_content" >
< Chronometer android:id ="@+id/cher1" android:layout_width ="wrap_content"
android:layout_height ="wrap_content" ></ Chronometer >
< LinearLayout android:layout_width ="wrap_content" android:layout_height ="wrap_content" >
< Button android:onClick ="onStart" android:text ="开始计时" android:layout_width ="wrap_content" android:layout_height ="wrap_content" ></ Button >
< Button android:onClick ="onStop" android:text ="停止计时" android:layout_width ="wrap_content" android:layout_height ="wrap_content" ></ Button >
< Button android:onClick ="onReset" android:text ="重置" android:layout_width ="wrap_content" android:layout_height ="wrap_content" ></ Button >
</ LinearLayout >
</ LinearLayout >
