public
abstract
class
CountDownTimer
extends Object
| java.lang.Object | |
| ↳ | android.os.CountDownTimer |
Schedule a countdown until a time in the future, with regular notifications on intervals along the way. Example of showing a 30 second countdown in a text field:
Developers
new CountDownTimer(30000, 1000) {
public void onTick(long millisUntilFinished) {
mTextField.setText("seconds remaining: " + millisUntilFinished / 1000);
}
public void onFinish() {
mTextField.setText("done!");
}
}.start();
The calls to onTick(long) are synchronized to this object so that
one call to onTick(long) won't ever occur before the previous
callback is complete. This is only relevant when the implementation of
onTick(long) takes an amount of time to execute that is significant
compared to the countdown interval.
Public constructors | |
|---|---|
CountDownTimer(long millisInFuture, long countDownInterval)
|
|
Public methods | |
|---|---|
final
void
|
cancel()
Cancel the countdown. |
abstract
void
|
onFinish()
Callback fired when the time is up. |
abstract
void
|
onTick(long millisUntilFinished)
Callback fired on regular interval. |
final
CountDownTimer
|
start()
Start the countdown. |
Inherited methods | |
|---|---|
 From
class
java.lang.Object
| |
CountDownTimer (long millisInFuture,
long countDownInterval)
| Parameters | |
|---|---|
millisInFuture |
long:
The number of millis in the future from the call
to start() until the countdown is done and onFinish()
is called. |
countDownInterval |
long:
The interval along the way to receive
onTick(long) callbacks.
|
void onTick (long millisUntilFinished)
Callback fired on regular interval.
| Parameters | |
|---|---|
millisUntilFinished |
long:
The amount of time until finished.
|