android 中文 api （43） —— Chronometer

前言

　　本章内容是 android.widget.Chronometer，译为"计时器"，版本为Android 2.2 r1 。期待你一块儿参与Android API 的中文翻译，联系我over140@gmail.com。

 

声明

　　欢迎转载，但请保留文章原始出处:)
 

　　　　农民伯伯：http://over140.blog.51cto.com/

　　　　Android中文翻译组：http://www.cnblogs.com/over140/  

 

正文

　　1、结构

　　　　public class Chronometer extends TextView

 
 

　　　　java.lang.Object

　　　　android.view.View

　　　　　　android.widget.TextView

　　　　　　　　android.widget.Chronometer

 

　　2、概述

　　　　
 

　　类实现了一个简单的计时器。

　　　　你能够经过elapsedRealtime()来给它一个基准时间，并从该时间开始计数。若是你不给它基准时间，它将使用你调用start()时的时间。默认它将显示当前"MM:SS"或 "H:MM:SS"格式的时间,或者你能经过setFormat(String)设置一个任意字符串来格式化显示计时器显示的时间。

 

　　3、XML属性

属性名称	描述
android:format	格式化字符串:若是指定，计时器将根据这个字符串来显示，替换字符串中第一个“%s”为当前"MM:SS"或 "H:MM:SS"格式的时间显示。若是不指定，计时器将简单的显示"MM:SS" or "H:MM:SS"格式的时间。（译者注：如：“This is a Chronometer %s”）

 

　　4、构造函数

 

         public Chronometer (Context context)

　 初始化计时器对象。设置当前时间为基准时间。（译者注：经过程序动态建立计时器对象）

 

　 public Chronometer (Context context, AttributeSet attrs)

　 初始化标准视图布局信息。设置当前时间为基准时间。（译者注：指经过XML来指定一个计时器）

 

　 public Chronometer (Context context, AttributeSet attrs, int defStyle)

　　　 初始化标准视图布局信息和风格。设置当前时间为基准时间。 

 

　　5、公共方法

 

         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()占用的资源。

 

　　6、受保护方法

 

         protected void onDetachedFromWindow ()

         视图从窗体上移除时调用，同时窗体表面再也不显示视图。

 

         protected void onWindowVisibilityChanged (int visibility)

         当窗体中视图的可视性（GONE, INVISIBLE, VISIBLE）发生改变时调用。注意它将告诉你你的窗口是否能够被窗口管理器识别，这并不能说明窗口是否被屏幕上的其余窗口遮挡，即便它自己是可见的。

                   参数

                            visibility 窗口新的可见性

 

　　7、补充

　　　　文章连接

　　　　　　android中的时间服务–Chronometer计时器服务

　　　　示例代码

　　　　　　Java文件

　　　　 public   class  ChronometerDemo  extends  Activity {
             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文件

         < LinearLayout  xmlns:android ="http://schemas.android.com/apk/res/android"  android:orientation ="vertical"
    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 >

 

结束

　　这篇译文一个月前本身翻译了一半，以后一直在作校稿和发布工做:)