awtk/docs/manual/digit_clock_t.md

digit_clock_t

概述

数字时钟控件。

函数

函数名称	说明
digit_clock_cast	转换为digit_clock对象(供脚本语言使用)。
digit_clock_create	创建digit_clock对象
digit_clock_set_format	设置显示格式。

属性

名属性称	类型	说明
format	char*	显示格式。

digit_clock_cast 函数

---

• 函数功能：

转换为digit_clock对象(供脚本语言使用)。

• 函数原型：

widget_t* digit_clock_cast (widget_t* widget);

• 参数说明：

参数	类型	说明
返回值	widget_t*	digit_clock对象。
widget	widget_t*	digit_clock对象。

digit_clock_create 函数

---

• 函数功能：

创建digit_clock对象

• 函数原型：

widget_t* digit_clock_create (widget_t* parent, xy_t x, xy_t y, wh_t w, wh_t h);

• 参数说明：

参数	类型	说明
返回值	widget_t*	对象。
parent	widget_t*	父控件
x	xy_t	x坐标
y	xy_t	y坐标
w	wh_t	宽度
h	wh_t	高度

digit_clock_set_format 函数

---

• 函数功能：

设置显示格式。

• 函数原型：

ret_t digit_clock_set_format (widget_t* widget, const char* format);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
widget	widget_t*	控件对象。
format	const char*	格式。

format 属性

---

显示格式。

Y 代表年(完整显示) M 代表月(1-12) D 代表日(1-31) h 代表时(0-23) m 代表分(0-59) s 代表秒(0-59) YY 代表年(只显示末两位) MM 代表月(01-12) DD 代表日(01-31) hh 代表时(00-23) mm 代表分(00-59) ss 代表秒(00-59)

如 日期时间为：2018/11/12 9:10:20 "Y/D/M"显示为"2018/11/12" "Y-D-M"显示为"2018-11-12" "Y-D-M hⓂ️s"显示为"2018-11-12 9:10:20" "Y-D-M hh:mm:ss"显示为"2018-11-12 09:10:20"

• 类型：char*

特性	是否支持
可直接读取	是
可直接修改	否
可持久化	是
可脚本化	是
可在IDE中设置	是
可在XML中设置	是
可通过widget_get_prop读取	是
可通过widget_set_prop修改	是