# win.ui.lcdClock 库模块帮助文档

## win.ui 成员列表 <a id="win.ui" href="#win.ui">&#x23;</a>

### win.ui.lcdClock <a id="win.ui.lcdClock" href="#win.ui.lcdClock">&#x23;</a>
创建长方形液晶时钟控件。可用于创建计时器，倒计时器。

### win.ui.lcdClock() <a id="win.ui.lcdClock" href="#win.ui.lcdClock">&#x23;</a>
[返回对象:winUiLcdClockObject](#winUiLcdClockObject)

### win.ui.lcdClock(plus控件) <a id="win.ui.lcdClock" href="#win.ui.lcdClock">&#x23;</a>
参数 @1 必须指定一个 plus 控件。  
plus 控件可以使用 fontCharMap 属性自定义每个数字对应的输出图像，  
如果未指定 fontCharMap 则默认设定为液晶时钟效果图像。

## winUiLcdClockObject 成员列表 <a id="winUiLcdClockObject" href="#winUiLcdClockObject">&#x23;</a>

### winUiLcdClockObject.millisCountDown <a id="winUiLcdClockObject.millisCountDown" href="#winUiLcdClockObject.millisCountDown">&#x23;</a>
倒计时已经过的毫秒数。  
不要直接改动此值。

### winUiLcdClockObject.millisInFuture <a id="winUiLcdClockObject.millisInFuture" href="#winUiLcdClockObject.millisInFuture">&#x23;</a>
倒计时设定的总毫秒数。  
不要直接改动此值。

### winUiLcdClockObject.mode <a id="winUiLcdClockObject.mode" href="#winUiLcdClockObject.mode">&#x23;</a>
当前﻿工作模式。  
倒计时为"countdown"，  
计时器为"timer"，  
时钟为"clock"，  
切换到倒计时器、或计时器模式总会重置另一个。  
切换到时钟模式不会重置计时器，

### winUiLcdClockObject.pause() <a id="winUiLcdClockObject.pause" href="#winUiLcdClockObject.pause">&#x23;</a>
暂停时钟或计时器。

### winUiLcdClockObject.resetCountDownTimer() <a id="winUiLcdClockObject.resetCountDownTimer" href="#winUiLcdClockObject.resetCountDownTimer">&#x23;</a>
重置倒计时器。  
参数可指定倒计时总毫秒数，也可以使用一个 time 对象指定倒计时的时间。

### winUiLcdClockObject.resetTimer() <a id="winUiLcdClockObject.resetTimer" href="#winUiLcdClockObject.resetTimer">&#x23;</a>
重置计时器

### winUiLcdClockObject.setColor() <a id="winUiLcdClockObject.setColor" href="#winUiLcdClockObject.setColor">&#x23;</a>
替换颜色，  
参数 @1 支持 RGBA 格式（0xAARRGGBB）颜色数值，  
此函数不负责重绘 plus 控件。

### winUiLcdClockObject.setImageAttributes() <a id="winUiLcdClockObject.setImageAttributes" href="#winUiLcdClockObject.setImageAttributes">&#x23;</a>
使用参数指定的 gdip.imageAttributes 对象调色。  
此函数不负责重绘 plus 控件。

### winUiLcdClockObject.startClock() <a id="winUiLcdClockObject.startClock" href="#winUiLcdClockObject.startClock">&#x23;</a>
启动时钟，用于实时显示当前时间。  
不会清零计时器。

### winUiLcdClockObject.startCountDownTimer(倒计时毫秒数,结束回调函数) <a id="winUiLcdClockObject.startCountDownTimer" href="#winUiLcdClockObject.startCountDownTimer">&#x23;</a>

```aardio
winUiLcdClockObject.startCountDownTimer(,function(){
	/*倒计时结束触发此回调函数。  
也可以使用 setCountDownMillisInFuture 事先指定倒计时毫秒数。  
倒计时毫秒数必须大于 0*/
})
```

### winUiLcdClockObject.startTimer() <a id="winUiLcdClockObject.startTimer" href="#winUiLcdClockObject.startTimer">&#x23;</a>
启动计时器，或自暂停状态恢复计时。  
调用此函数也会重置倒计时数据。

### winUiLcdClockObject.stop() <a id="winUiLcdClockObject.stop" href="#winUiLcdClockObject.stop">&#x23;</a>
重置清零计时、倒计时数据并停止计时。
