mirror of
https://gitee.com/zlgopen/awtk.git
synced 2024-12-10 16:46:14 +08:00
4.6 KiB
4.6 KiB
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 代表时(0-11)
- m 代表分(0-59)
- s 代表秒(0-59)
- w 代表星期(0-6)
- W 代表星期的英文缩写(支持翻译)
- T 代表时段AM/PM(支持翻译)
- YY 代表年(只显示末两位)
- MM 代表月(01-12)
- DD 代表日(01-31)
- hh 代表时(00-23)
- HH 代表时(00-11)
- 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修改 | 是 |