# digit_clock_t

# 概述

image
image

数字时钟控件。

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 (opens new window)

在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 (opens new window)

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

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

更多用法请参考:theme default (opens new window)

# 函数

函数名称 说明
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修改