android 中文 api (43) —— Chronometer


前言

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

 

声明

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

    博客园:http://www.cnblogs.com/

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

 

正文

  一、结构

    public class Chronometer extends TextView

 

    java.lang.Object

    android.view.View

      android.widget.TextView

        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"格式的时间。(译者注:如:“This is a Chronometer %s”

 

  四、构造函数

         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时时间,比如调用本函数并设置参数baseSystemClock.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文件

    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>


结束

  这篇译文一个月前自己翻译了一半,之后一直在做校稿和发布工作:)

posted @ 2010-11-22 09:27  农民伯伯  阅读(13080)  评论(1编辑  收藏  举报