awtk/docs/manual/digit_clock_t.md

digit_clock_t

概述

数字时钟控件。

digit_clock_t是widget_t的子类控件，widget_t的函数均适用于digit_clock_t控件。

在xml中使用"digit_clock"标签创建数字时钟控件。如：

<digit_clock format="YY/MM/DD h:mm:ss"/>

更多用法请参考：digit_clock.xml

在c代码中使用函数digit_clock_create创建数字时钟控件。如：

widget_t* tc = digit_clock_create(win, 10, 10, 240, 30);
digit_clock_set_format(tc, "YY/MM/DD h:mm:ss");

完整示例请参考：digit_clock demo

可用通过style来设置控件的显示风格，如字体的大小和颜色等等。如：

<style name="default">
<normal text_color="black" />
</style>

更多用法请参考：theme default

---

函数

函数名称	说明
digit_clock_cast	转换为digit_clock对象(供脚本语言使用)。
digit_clock_create	创建digit_clock对象
digit_clock_get_widget_vtable	获取 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_get_widget_vtable 函数

---

• 函数功能：

获取 digit_clock 虚表。

• 函数原型：

const widget_vtable_t* digit_clock_get_widget_vtable ();

• 参数说明：

参数	类型	说明
返回值	const widget_vtable_t*	成功返回 digit_clock 虚表。

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)
• H 代表时(1-12)
• m 代表分(0-59)
• s 代表秒(0-59)
• w 代表星期(0-6)
• W 代表星期的英文缩写(支持翻译)
• T 代表时段AM/PM(支持翻译)
• YY 代表年(只显示末两位)
• MM 代表月(01-12)
• DD 代表日(01-31)
• hh 代表时(00-23)
• HH 代表时(01-12)
• mm 代表分(00-59)
• ss 代表秒(00-59)
• MMM 代表月的英文缩写(支持翻译)

如 日期时间为：2018/11/12 9:10:20

• "Y/M/D"显示为"2018/11/12"

• "Y-M-D"显示为"2018-11-12"

• "Y-M-D hⓂ️s"显示为"2018-11-12 9:10:20"

• "Y-M-D hh:mm:ss"显示为"2018-11-12 09:10:20"

• 类型：char*

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