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对象(供脚本语言使用)。

• 函数原型：

widget_t* digit_clock_cast (widget_t* widget);

• 参数说明：

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);

• 参数说明：

digit_clock_set_format 函数

• 函数功能：

设置显示格式。

• 函数原型：

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

• 参数说明：

format 属性

显示格式。

• Y 代表年(完整显示)
• M 代表月(1-12)
• D 代表日(1-31)
• h 代表时(0-23)
• m 代表分(0-59)
• s 代表秒(0-59)
• w 代表星期(0-6)
• W 代表星期的英文缩写(支持翻译)
• YY 代表年(只显示末两位)
• MM 代表月(01-12)
• DD 代表日(01-31)
• hh 代表时(00-23)
• mm 代表分(00-59)
• ss 代表秒(00-59)

• MMM 代表月的英文缩写(支持翻译)

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

• “Y/D/M”显示为”2018/11/12”
• “Y-D-M”显示为”2018-11-12”
• “Y-D-M h:m:s”显示为”2018-11-12 9:10:20”
• “Y-D-M hh:mm:ss”显示为”2018-11-12 09:10:20”

• 类型：char*