Most visited

Recently visited

Added in API level 1

Chronometer

public class Chronometer
extends TextView

java.lang.Object
   ↳ android.view.View
     ↳ android.widget.TextView
       ↳ android.widget.Chronometer


实现简单定时器的类。

您可以在 elapsedRealtime()时基中给它一个开始时间,并 elapsedRealtime()计算出来,或者如果您不给它一个基准时间,它将使用您拨打 start()的时间。

通过将 setCountDown(boolean)设置为true,计时器也可以向下计算基准时间。

默认情况下,它将以“MM:SS”或“H:MM:SS”的形式显示当前计时器值,或者可以使用 setFormat(String)将计时器值格式化为任意字符串。

Summary

Nested classes

interface Chronometer.OnChronometerTickListener

一个回调,通知天文钟自己增加的时间。

XML attributes

android:countDown Specifies whether this Chronometer counts down or counts up from the base. 
android:format Format string: if specified, the Chronometer will display this string, with the first "%s" replaced by the current timer value in "MM:SS" or "H:MM:SS" form. 

Inherited XML attributes

From class android.widget.TextView
From class android.view.View

Inherited constants

From class android.view.View

Inherited fields

From class android.view.View

Public constructors

Chronometer(Context context)

初始化此Chronometer对象。

Chronometer(Context context, AttributeSet attrs)

使用标准视图布局信息进行初始化。

Chronometer(Context context, AttributeSet attrs, int defStyleAttr)

使用标准视图布局信息和样式进行初始化。

Chronometer(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)

Public methods

CharSequence getAccessibilityClassName()

返回此对象的类名称以用于辅助功能。

long getBase()

通过 setBase(long)返回基准时间。

CharSequence getContentDescription()

返回 View的内容描述。

String getFormat()

返回通过 setFormat(String)设置的当前格式字符串。

Chronometer.OnChronometerTickListener getOnChronometerTickListener()
boolean isCountDown()
void setBase(long base)

设置递增计时器参考的时间。

void setCountDown(boolean countDown)

将此视图设置为倒数到基数,而不是从倒数开始倒数。

void setFormat(String format)

设置用于显示的格式字符串。

void setOnChronometerTickListener(Chronometer.OnChronometerTickListener listener)

设置在计时器更改时调用侦听器。

void start()

开始数起来。

void stop()

停止计数。

Protected methods

void onDetachedFromWindow()

这是在视图从窗口分离时调用的。

void onWindowVisibilityChanged(int visibility)

叫当包含窗口具有改变其可见性(间 GONEINVISIBLE ,和 VISIBLE )。

Inherited methods

From class android.widget.TextView
From class android.view.View
From class java.lang.Object
From interface android.view.ViewTreeObserver.OnPreDrawListener
From interface android.graphics.drawable.Drawable.Callback
From interface android.view.KeyEvent.Callback
From interface android.view.accessibility.AccessibilityEventSource

XML attributes

android:countDown

指定此计时器是否倒计时或从基点向上计数。 如果没有指定,这是错误的,天文钟计数。

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 countDown

android:format

格式化字符串:如果指定,天文台将显示此字符串,其中第一个“%s”由当前定时器值替换为“MM:SS”或“H:MM:SS”形式。 如果没有指定格式字符串,天文台将显示“MM:SS”或“H:MM:SS”。

必须是字符串值,使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 format

Public constructors

Chronometer

Added in API level 1
Chronometer (Context context)

初始化此Chronometer对象。 将基础设置为当前时间。

Parameters
context Context

Chronometer

Added in API level 1
Chronometer (Context context, 
                AttributeSet attrs)

使用标准视图布局信息进行初始化。 将基础设置为当前时间。

Parameters
context Context
attrs AttributeSet

Chronometer

Added in API level 1
Chronometer (Context context, 
                AttributeSet attrs, 
                int defStyleAttr)

使用标准视图布局信息和样式进行初始化。 将基础设置为当前时间。

Parameters
context Context
attrs AttributeSet
defStyleAttr int

Chronometer

Added in API level 21
Chronometer (Context context, 
                AttributeSet attrs, 
                int defStyleAttr, 
                int defStyleRes)

Parameters
context Context
attrs AttributeSet
defStyleAttr int
defStyleRes int

Public methods

getAccessibilityClassName

Added in API level 23
CharSequence getAccessibilityClassName ()

返回此对象的类名称以用于辅助功能。 如果子类正在实现的东西应该被视为一个全新的视图类,当它被可访问性使用时,子类只应该覆盖这个子类,与它所源自的类无关。 这用于填写AccessibilityNodeInfo.setClassName

Returns
CharSequence

getBase

Added in API level 1
long getBase ()

通过 setBase(long)返回基准时间。

Returns
long

getContentDescription

Added in API level 4
CharSequence getContentDescription ()

返回 View的内容描述。

注意:不要重写此方法,因为它将不会影响呈现给辅助功能服务的内容描述。 您必须致电setContentDescription(CharSequence)修改内容说明。

Returns
CharSequence the content description

getFormat

Added in API level 1
String getFormat ()

返回通过 setFormat(String)设置的当前格式字符串。

Returns
String

getOnChronometerTickListener

Added in API level 3
Chronometer.OnChronometerTickListener getOnChronometerTickListener ()

Returns
Chronometer.OnChronometerTickListener The listener (may be null) that is listening for chronometer change events.

isCountDown

Added in API level 24
boolean isCountDown ()

Returns
boolean whether this view counts down

也可以看看:

setBase

Added in API level 1
void setBase (long base)

设置递增计时器参考的时间。

Parameters
base long: Use the elapsedRealtime() time base.

setCountDown

Added in API level 24
void setCountDown (boolean countDown)

将此视图设置为倒数到基数,而不是从倒数开始倒数。

Parameters
countDown boolean: whether this view should count down

也可以看看:

setFormat

Added in API level 1
void setFormat (String format)

设置用于显示的格式字符串。 计时器将显示此字符串,第一个“%s”由当前定时器值替换为“MM:SS”或“H:MM:SS”形式。 如果格式字符串为空,或者您从不调用setFormat(),则计时器将以“MM:SS”或“H:MM:SS”形式显示计时器值。

Parameters
format String: the format string.

setOnChronometerTickListener

Added in API level 3
void setOnChronometerTickListener (Chronometer.OnChronometerTickListener listener)

设置在计时器更改时调用侦听器。

Parameters
listener Chronometer.OnChronometerTickListener: The listener.

start

Added in API level 1
void start ()

开始数起来。 这不会影响从setBase(long)设置的setBase(long) ,只是视图显示。 即使在Widget不可见的情况下,计时器也会定期将消息安排到处理程序。 为了确保不会发生资源泄漏,用户应确保每个start()调用与stop()有相互呼叫。

stop

Added in API level 1
void stop ()

停止计数。 这不会影响从setBase(long)设置的setBase(long) ,只是视图显示。 这将停止向处理程序发送消息,通过start()有效释放将在计时器运行时start()

Protected methods

onDetachedFromWindow

Added in API level 1
void onDetachedFromWindow ()

这是在视图从窗口分离时调用的。 此时它不再有绘图表面。

onWindowVisibilityChanged

Added in API level 1
void onWindowVisibilityChanged (int visibility)

叫当包含窗口具有改变其可见性(间GONEINVISIBLE ,和VISIBLE )。 请注意,这会告诉您窗口管理器是否使您的窗口可见; 这并不能告诉你你的窗口是否被屏幕上的其他窗口遮挡,即使它本身是可见的。

Parameters
visibility int: The new visibility of the window.

Hooray!