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 >

 

結束

　　這篇譯文一個月前本身翻譯了一半，以後一直在作校稿和發佈工做:)