android 中文 api (43) —— Chronometer

简介:

一、结构

    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 >

本文转自博客园农民伯伯的博客,原文链接:android 中文 api (43) —— Chronometer,如需转载请自行联系原博主。


目录
相关文章
|
5月前
|
Android开发
Android 11 修改libcore update-api 遇到的问题
Android 11 修改libcore update-api 遇到的问题
138 1
|
定位技术 API 开发工具
Android 按照步骤接入百度地图API,定位显示不了解决办法
Android 按照步骤接入百度地图API,定位显示不了解决办法
356 1
|
2月前
|
编译器 API Android开发
Android经典实战之Kotlin Multiplatform 中,如何处理不同平台的 API 调用
本文介绍Kotlin Multiplatform (KMP) 中使用 `expect` 和 `actual` 关键字处理多平台API调用的方法。通过共通代码集定义预期API,各平台提供具体实现,编译器确保正确匹配,支持依赖注入、枚举类处理等,实现跨平台代码重用与原生性能。附带示例展示如何定义跨平台函数与类。
71 0
|
4月前
|
API Android开发 开发者
`RecyclerView`是Android API 21引入的UI组件,用于替代ListView和GridView
【6月更文挑战第26天】`RecyclerView`是Android API 21引入的UI组件,用于替代ListView和GridView。它提供高效的数据视图复用,优化的布局管理,支持多种布局(如线性、网格),并解耦数据、适配器和视图。RecyclerView的灵活性、性能(如局部刷新和动画支持)和扩展性使其成为现代Android开发的首选,特别是在处理大规模数据集时。
52 2
|
4月前
|
Java Linux API
微信API:探究Android平台下Hook技术的比较与应用场景分析
微信API:探究Android平台下Hook技术的比较与应用场景分析
|
5月前
|
SQL API Android开发
Android API:Activity.managedQuery()
Android API:Activity.managedQuery()
38 2
|
5月前
|
API 定位技术 开发工具
Android Studio2021.1.1 高德地图api调用这一篇就够了
Android Studio2021.1.1 高德地图api调用这一篇就够了
|
5月前
|
API Android开发
Android Framework增加API 报错 Missing nullability on parameter
Android Framework增加API 报错 Missing nullability on parameter
278 1
|
5月前
|
API Android开发
对于应用研发平台EMAS中安卓 API 32 收不到 FCM 推送的问题
对于应用研发平台EMAS中安卓 API 32 收不到 FCM 推送的问题
101 3
|
API Android开发
mPaaS(移动跨平台框架)目前已经支持了Android API级别21
mPaaS(移动跨平台框架)目前已经支持了Android API级别21
137 2