Android基礎(chǔ)到進(jìn)階UI Chronometer 使用+實(shí)例

Chronometer

Chronometer是一個簡單的計時器組件，繼承自TextView。但是Chronometer不顯示當(dāng)前時間，它顯示的是從某個起始時間開始，一共過去了多長時間。

image

主要XML屬性如下：

  • android:countDown 是否倒計時，默認(rèn)false。
  • android:format 設(shè)置顯示時間格式。如果指定，第一個 "%s" 替換為"MM:SS"或"H:MM:SS"形式的當(dāng)前計時器值。

常用方法

  • start()：開始計時
  • stop()：停止計時
  • setBase(long)：設(shè)置計時器起始時間。
  • setFormat(String)：設(shè)置顯示時間格式
  • setCountDown(boolean)：設(shè)置是否是倒計時(SDK版本大于23)。
  • setOnChronometerTickListener(OnChronometerTickListener)：為計時器綁定事件監(jiān)聽，當(dāng)計時器改變時觸發(fā)該監(jiān)聽器。

示例

看上面介紹十分簡單，咱們還是搞個實(shí)例了解一下吧，先看效果圖。

image

主界面布局文件

僅保留Chronometer相關(guān)布局

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="@dimen/dimen_20">
    <Chronometer
        android:id="@+id/chronometer"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textSize="@dimen/dimen_20"
        android:padding="@dimen/dimen_10"
        android:layout_gravity="center_horizontal"
        android:textColor="@color/color_188FFF" />
    <Chronometer
        android:id="@+id/ch_format"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textSize="@dimen/dimen_20"
        android:padding="@dimen/dimen_10"
        android:layout_gravity="center_horizontal"
        android:textColor="@color/color_ff0000" />
</LinearLayout>

主界面代碼

public class ChronometerActivity extends AppCompatActivity implements View.OnClickListener {
    private Button btn_start,btn_stop,btn_reset,btn_format_1;
    private Chronometer chronometer,ch_format;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_textview_chronometer);//加載布局文件
        initView();
    }
    private void initView() {
        btn_start = findViewById(R.id.btn_start);
        btn_stop = findViewById(R.id.btn_stop);
        btn_reset = findViewById(R.id.btn_reset);
        chronometer = findViewById(R.id.chronometer);
        btn_start.setOnClickListener(this);
        btn_stop.setOnClickListener(this);
        btn_reset.setOnClickListener(this);
        chronometer.setOnChronometerTickListener(new Chronometer.OnChronometerTickListener() {
            @RequiresApi(api = Build.VERSION_CODES.N)
            @Override
            public void onChronometerTick(Chronometer chronometer) {
                MLog.e(String.valueOf(chronometer.getBase()));
                //當(dāng)前時間-基準(zhǔn)時間>20秒
                if(SystemClock.elapsedRealtime()-chronometer.getBase()>20*1000)
                {
                    chronometer.setCountDown(true);
                }
            }
        });

        btn_format_1 = findViewById(R.id.btn_format_1);
        ch_format = findViewById(R.id.ch_format);
        btn_format_1.setOnClickListener(this);
        ch_format.setOnChronometerTickListener(new Chronometer.OnChronometerTickListener() {
            @Override
            public void onChronometerTick(Chronometer chronometer) {
                //當(dāng)前時間-基準(zhǔn)時間
                long time = SystemClock.elapsedRealtime()-chronometer.getBase();
                Date d = new Date(time);
                SimpleDateFormat sdf = new SimpleDateFormat("HH:mm:ss", Locale.US);
                sdf.setTimeZone(TimeZone.getTimeZone("UTC"));
                //設(shè)置為HH:mm:ss格式
                ch_format.setText(sdf.format(d));
            }
        });
    }

    @RequiresApi(api = Build.VERSION_CODES.N)
    @Override
    public void onClick(View v) {
        switch (v.getId()){
            case R.id.btn_start:
                //SystemClock.elapsedRealtime(),自啟動以來經(jīng)過的毫秒數(shù)。
                //設(shè)置基準(zhǔn)時間
                chronometer.setBase(SystemClock.elapsedRealtime());
                //true,倒計時
                chronometer.setCountDown(false);
                chronometer.setFormat("計時: %s 秒");
                //開始計時
                chronometer.start();
                break;
            case R.id.btn_stop:
                //結(jié)束計時
                chronometer.stop();
                //文字顯示
                ch_format.setText("00:00");
                break;
            case R.id.btn_reset:
                //重置基準(zhǔn)時間
                chronometer.setBase(SystemClock.elapsedRealtime());
                break;
            case R.id.btn_format_1:
                ch_format.setBase(SystemClock.elapsedRealtime());
                ch_format.setCountDown(false);
                ch_format.start();
                break;
        }
    }
}

Format格式修改

將Format默認(rèn)的顯示格式是00:00(MM:SS),修改為00:00:00(H:MM:SS)的顯示格式。

只要Chronometer發(fā)生變化，onChronometerTick都會被觸發(fā)，所以我們可以在觸發(fā)后進(jìn)行處理。得到我們想要顯示樣式。

        ch_format.setOnChronometerTickListener(new Chronometer.OnChronometerTickListener() {
            @Override
            public void onChronometerTick(Chronometer chronometer) {
                //當(dāng)前時間-基準(zhǔn)時間
                long time = SystemClock.elapsedRealtime()-chronometer.getBase();
                Date d = new Date(time);
                SimpleDateFormat sdf = new SimpleDateFormat("HH:mm:ss", Locale.US);
                sdf.setTimeZone(TimeZone.getTimeZone("UTC"));
                //設(shè)置為HH:mm:ss格式
                ch_format.setText(sdf.format(d));
            }
        });

源碼分析

setBase()

public void setBase(long base) {
        //設(shè)置基準(zhǔn)時間
        mBase = base;
        //觸發(fā)監(jiān)聽事件
        dispatchChronometerTick();
        //修改當(dāng)前界面
        updateText(SystemClock.elapsedRealtime());
    }

dispatchChronometerTick()

//觸發(fā)監(jiān)聽事件
void dispatchChronometerTick() {
        if (mOnChronometerTickListener != null) {
            mOnChronometerTickListener.onChronometerTick(this);
        }
    }

updateText()

修改當(dāng)前界面，首先拿當(dāng)前時間和mBase時間作比較，second是兩種之間的差值。DateUtils把second格式化，一般是"MM:SS"或"H:MM:SS"，輸出text。

如果定義了format格式，利用Formatter將text進(jìn)一步格式化。

//修改
private synchronized void updateText(long now) {
        mNow = now;
        long seconds = mCountDown ? mBase - now : now - mBase;
        seconds /= 1000;
        boolean negative = false;
        if (seconds < 0) {
            seconds = -seconds;
            negative = true;
        }
        String text = DateUtils.formatElapsedTime(mRecycle, seconds);
        if (negative) {
            text = getResources().getString(R.string.negative_duration, text);
        }

        if (mFormat != null) {
            Locale loc = Locale.getDefault();
            if (mFormatter == null || !loc.equals(mFormatterLocale)) {
                mFormatterLocale = loc;
                mFormatter = new Formatter(mFormatBuilder, loc);
            }
            mFormatBuilder.setLength(0);
            mFormatterArgs[0] = text;
            try {
                mFormatter.format(mFormat, mFormatterArgs);
                text = mFormatBuilder.toString();
            } catch (IllegalFormatException ex) {
                if (!mLogged) {
                    Log.w(TAG, "Illegal format string: " + mFormat);
                    mLogged = true;
                }
            }
        }
        setText(text);
    }

start()

public void start() {
        mStarted = true;
        updateRunning();
    }

stop()

public void stop() {
        mStarted = false;
        updateRunning();
    }

updateRunning()

start() 和stop() 方法修改了mStarted的狀態(tài)，然后調(diào)用updateRunning()。
Chronometer狀態(tài)由三部分組成，mVisible（Window是否可見）、mStarted(Chronometer開始計時)和isShown(View是否可見)。

如果狀態(tài)變化，修改當(dāng)前控件。

  • updateText(long)修改界面。
  • dispatchChronometerTick()觸發(fā)監(jiān)聽事件。
  • postDelayed(Runnable, long)在一秒后修改界面。
private void updateRunning() {
        boolean running = mVisible && mStarted && isShown();
        if (running != mRunning) {
            if (running) {
                updateText(SystemClock.elapsedRealtime());
                dispatchChronometerTick();
                postDelayed(mTickRunnable, 1000);
            } else {
                removeCallbacks(mTickRunnable);
            }
            mRunning = running;
        }
    }

setFormat(String)

    //默認(rèn)"MM:SS"或"H:MM:SS"形式
    public void setFormat(String format) {
        mFormat = format;
        if (format != null && mFormatBuilder == null) {
            mFormatBuilder = new StringBuilder(format.length() * 2);
        }
    }

setCountDown()

public void setCountDown(boolean countDown) {
        mCountDown = countDown;
        updateText(SystemClock.elapsedRealtime());
    }

還有updateText()

image

當(dāng)你setCountDown(true)時，直接在當(dāng)前計時數(shù)值前加"-"。如:

  • setCountDown(false)顯示：計時器：20秒，
  • setCountDown(true)顯示：計時器：-20秒，

以上就是本文的全部內(nèi)容，希望對大家學(xué)習(xí)Android Chronometer有所幫助和啟發(fā)。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡書系信息發(fā)布平臺，僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • TextView是什么 向用戶顯示文本，并可選擇允許他們編輯文本。TextView是一個完整的文本編輯器，但是基類...
    帥次閱讀 747評論 0贊 1
  • 父類實(shí)現(xiàn)深拷貝時，子類如何實(shí)現(xiàn)深度拷貝。父類沒有實(shí)現(xiàn)深拷貝時，子類如何實(shí)現(xiàn)深度拷貝。? 深拷貝同淺拷貝的區(qū)別：淺拷...
    JonesCxy閱讀 1,189評論 1贊 7
  • ? 深拷貝同淺拷貝的區(qū)別：淺拷貝是指針拷貝，對一個對象進(jìn)行淺拷貝，相當(dāng)于對指向?qū)ο蟮闹羔樳M(jìn)行復(fù)制，產(chǎn)生一個新的指向...
    WSGNSLog閱讀 1,384評論 0贊 1
  • 1、工具類 Java中提供了大量的類和接口完成特定的功能。每個類都會有自己的屬性和行為（功能）。但是這些功能還是不...
    Villain丶Cc閱讀 1,784評論 0贊 1
  • 我是黑夜里大雨紛飛的人啊 1 “又到一年六月，有人笑有人哭，有人歡樂有人憂愁，有人驚喜有人失落，有的覺得收獲滿滿有...
    陌忘宇閱讀 8,814評論 28贊 54

友情鏈接更多精彩內(nèi)容