UI接口设计说明书

📎 原始文档：https://www.kdocs.cn/l/cfW0cpWoNkgdimage

UI接口设计说明书

珠海市杰理科技股份有限公司

Zhuhai Jieli Technology Co.,LTD

版权所有，未经许可，禁止外传

修改记录

版本更新日期描述
V1.02020/12/16撰写ui接口说明文档

目录
一、 引言.............................................................................................................. 6
（一） 编写目的......................................................................................................................................... 6
（二） 参考资料......................................................................................................................................... 6
（三） 术语和缩写词................................................................................................................................. 6
二、 功能概述...................................................................................................... 7
三、 其他系统/模块的调用关系........................................................................ 8
四、 UI接口模块功能介绍................................................................................ 9
（一） 显示页面......................................................................................................................................... 9
1． 功能介绍.................................................................................................................................... 9
2． 接口介绍.................................................................................................................................... 9
（二） 隐藏页面......................................................................................................................................... 9
1． 功能介绍.................................................................................................................................... 9
2． 接口介绍.................................................................................................................................. 10
（三） 隐藏当前页面............................................................................................................................... 10
1． 功能介绍.................................................................................................................................. 10
2． 接口介绍.................................................................................................................................. 10
（四） 获取当前页面ID .......................................................................................................................... 11
1． 功能介绍.................................................................................................................................. 11
2． 接口介绍.................................................................................................................................. 11
（五） 显示控件....................................................................................................................................... 11
1． 功能介绍.................................................................................................................................. 11
2． 接口介绍.................................................................................................................................. 12
（六） 隐藏控件....................................................................................................................................... 12
1． 功能介绍.................................................................................................................................. 12
2． 接口介绍.................................................................................................................................. 12
（七） 锁住触摸焦点控件....................................................................................................................... 13
1． 功能介绍.................................................................................................................................. 13
2． 接口介绍.................................................................................................................................. 13
（八） 解锁触摸焦点控件....................................................................................................................... 13
1． 功能介绍.................................................................................................................................. 13
2． 接口介绍.................................................................................................................................. 14
（九） 高亮控件....................................................................................................................................... 14
1． 功能介绍.................................................................................................................................. 14
2． 接口介绍.................................................................................................................................. 14
（十） 取消高亮控件............................................................................................................................... 15
1． 功能介绍.................................................................................................................................. 15
2． 接口介绍.................................................................................................................................. 15
（十一） 注册消息响应........................................................................................................................... 15
1． 功能介绍.................................................................................................................................. 15
2． 接口介绍.................................................................................................................................. 15
（十二） 推送消息................................................................................................................................... 16
1． 功能介绍.................................................................................................................................. 16
2． 接口介绍.................................................................................................................................. 16
（十三） 发送按键消息........................................................................................................................... 17
1． 功能介绍.................................................................................................................................. 17
2． 接口介绍.................................................................................................................................. 17
（十四） 发送触摸消息........................................................................................................................... 18
1． 功能介绍.................................................................................................................................. 18
2． 接口介绍.................................................................................................................................. 18
（十五） ui控件响应............................................................................................................................... 18
1． 功能介绍.................................................................................................................................. 18
2． 接口介绍.................................................................................................................................. 18
五、 控件接口.................................................................................................... 26
（一） 图片控件接口...............................................................................................................................26
1． 显示图片.................................................................................................................................. 26
2． 图片控件初始化...................................................................................................................... 26
（二） 按钮控件.......................................................................................................................................27
（三） 表格控件/水平列表控件/垂直列表控件.....................................................................................27
1． 选择列表项.............................................................................................................................. 27
2． 获取列表项.............................................................................................................................. 27
3． 高亮列表项.............................................................................................................................. 28
4． 设置焦点.................................................................................................................................. 28
5． 取消焦点.................................................................................................................................. 29
（四） 时间控件.......................................................................................................................................29
1． 设置时间.................................................................................................................................. 29
（五） 文本控件....................................................................................................................................... 30
1． 文本控件初始化（strpic 编码格式）.................................................................................... 31
2． 显示指定的文本（strpic 编码格式）.................................................................................... 31
3． 文本控件初始化（ascii 编码格式）......................................................................................32
4． 显示指定的ASCII码（ascii 编码格式）..............................................................................32
5． 文本控件初始化（text 编码格式）....................................................................................... 33
6． 显示内码（text 编码格式）................................................................................................... 34
7． 显示UNICODE 编码（text 编码格式）................................................................................34
8． 显示UTF8 编码（text 编码格式）........................................................................................35
（六） 电池控件....................................................................................................................................... 36
1． 改变所有电池控件的电量状态.............................................................................................. 36
2． 改变指定电池控件的电量状态.............................................................................................. 36
3． 电池控件电量状态初始化...................................................................................................... 37
（七） 数字控件....................................................................................................................................... 38
1． 设置数字.................................................................................................................................. 38
（八） 滑动条控件................................................................................................................................... 39
1． 设置滑动块进度...................................................................................................................... 39
（九） 圆环进度条控件...........................................................................................................................40
1． 设置圆环进度.......................................................................................................................... 40
（十） 多圆环进度条控件.......................................................................................................................40
1． 设置第一个圆环进度.............................................................................................................. 40
2． 设置第二个圆环进度.............................................................................................................. 41
3． 设置第三个圆环进度.............................................................................................................. 42
（十一） 模拟时钟控件...........................................................................................................................42
1． 设置模拟时钟时间.................................................................................................................. 42

一、 引言

（一）编写目的

该文档主要介绍了ui接口的使用， 以及接口使用上的一些注意事项。

（二）参考资料

[ 1]

（三）术语和缩写词
缩写和术语解 释

image

二、功能概述

http://www.zh-jieli.com/

二、功能概述

在显示屏上显示图形文字等内容，实现人机交互界面。
image 三、其他系统/模块的调用关系
http://www.zh-jieli.com/

三、其他系统/模块的调用关系

四、UI接口模块功能介绍

（一）显示页面
1．功能介绍

显示指定ID号的页面。

2．接口介绍
函数原型int ui_show_main(int id);
功能描述显示指定页面
参数说明id : 页面的id号
输出0：显示成功 其他：显示失败
例子ui_show_main(PAGE_ 0); //PAGE_0 为页面的ID 号，参考 style.h文件
关联模块lcd_ui_api.c
补充说明
（二）隐藏页面
1．功能介绍

隐藏指定ID号的页面。

2．接口介绍
函数原型int ui_hide_main(int id);
功能描述隐藏指定页面
参数说明Id : 页面的id号
输出0：隐藏成功 其他:隐藏失败
例子ui_hide_main(PAGE_ 0); //PAGE_0 为页面的 ID 号，参考 style.h文件
关联模块lcd_ui_api.c
补充说明
（三）隐藏当前页面
1．功能介绍

用于隐藏当前的页面，用户无须关心当前页面的id号。

2．接口介绍
函数原型int ui_hide_curr_main();
功能描述隐藏当前页面
参数说明无
输出0：隐藏成功 其他：隐藏失败
例子ui_hide_curr_main();
关联模块lcd_ui_api.c
补充说明
（四）获取当前页面ID
1．功能介绍

获取当前页面的id。

2．接口介绍
函数原型int ui_get_current_window_id();
功能描述获取当前页面的id号
参数说明无
输出当前页面的id号
例子
关联模块
补充说明
（五）显示控件
1．功能介绍

将指定id 的控件显示出来。

2．接口介绍
函数原型int ui_show(int id);
功能描述显示控件
参数说明id：控件的id号
输出0：成功 其他：失败
例子ui_show(PIC_ 1);//显示图片控件PIC_ 1 , PIC_ 1 为图片控件的ID号，参考style.h
关联模块
补充说明
（六）隐藏控件
1．功能介绍

将指定id 的控件隐藏。

2．接口介绍
函数原型int ui_hide(int id);
功能描述隐藏控件
参数说明id：控件的id号
输出0：成功 其他：失败
例子ui_hide(PIC_ 1);//隐藏图片控件PIC_ 1 , PIC_ 1 为图片控件的ID号，参考style.h
关联模块
补充说明
（七）锁住触摸焦点控件
1．功能介绍

将当前控件设置为焦点控件， 当有触摸事件发生时，会将触摸事件发送给焦点控件。

2．接口介绍
函数原型void ui_ontouch_lock(void *elm) ;
功能描述锁住触摸焦点控件
参数说明elm:控件的句柄
输出无
例子
关联模块
补充说明
（八）解锁触摸焦点控件
1．功能介绍

当前控件设置为非焦点控件。

2．接口介绍
函数原型void ui_ontouch_unlock(void *elm) ;
功能描述解锁触摸焦点控件
参数说明elm:控件的句柄
输出无
例子
关联模块
补充说明
（九）高亮控件
1．功能介绍

高亮某个控件的显示，表示当前选中状态，一般用于列表控件。

2．接口介绍
函数原型int ui_highlight_element_by_id(int id);
功能描述高亮控件
参数说明id:控件ID
输出0：成功 其他：失败
例子
关联模块ui_api.c
补充说明
（十）取消高亮控件
1．功能介绍

取消控件的高亮显示，一般用于列表控件。

2．接口介绍
函数原型int ui_no_highlight_element_by_id(int id);
功能描述取消控件高亮
参数说明id:控件ID
输出0：成功 其他：失败
例子
关联模块ui_api.c
补充说明
（十一）注册消息响应
1．功能介绍
2．接口介绍
函数原型int ui_register_msg_handler(int id, const struct uimsg_handl *handler)
功能描述注册消息响应，用于app 与ui进行消息交互
参数说明id: 页面的ID
struct uimsg_handl {​
const char *msg;
int ( *handler)(const char *type, u32 args);​} ;
handler: 自定义消息响应
输出0：注册成功 其他：注册失败
例子static const struct uimsg_handl ui_msg_handler[] = {​{​ "music_start", music_start ​}, / * 音乐播
放 */
{​ NULL, NULL​}, / * 必须以此结尾！ */​} ;
ui_register_msg_handler(window->[elm.id, ui_msg_handler);//](elm.id, ui_msg_handler);//)注册消息交互的回调
关联模块
补充说明
（十二）推送消息
1．功能介绍
2．接口介绍
函数原型int ui_server_msg_post(const char *msg, ...) ;
功能描述向ui发送自定义消息
参数说明msg: 消息
...: 参数
输出0：注册成功 其他：注册失败
例子ui_server_msg_pos("music_start:show_lyric=%4:dev=%4:file num=%4:total_filenum=%4", !analaz,logo, music_player_get_file_cur(), music_player_get_file_total());
关联模块
补充说明
（十三）发送按键消息
1．功能介绍
2．接口介绍
函数原型int ui_key_msg_post(int key) ;
功能描述向ui 内核发送按键消息， 由ui 内核进行消息分发
参数说明key: 按键消息
输出0：发送成功 其他：发送失败
例子
关联模块
补充说明
（十四）发送触摸消息
l．功能介绍
2．接口介绍
函数原型int ui_touch_msg_post(struct touch_event *event) ;
功能描述向ui 内核发送触摸消息， 由ui 内核进行消息分发
参数说明struct touch_event {​
int event;
int x;
int y;
​} ;
event:触摸事件
输出0：发送成功 其他：发送失败
例子
关联模块
补充说明
（十五）ui控件响应
l．功能介绍
2．接口介绍

(1)事件类型
//onchange事件
enum element_change_event {​
ON_CHANGE_INIT_PROBE, //创建控件开始前的准备
ON_CHANGE_INIT, //创建控件 ON_CHANGE_TRY_OPEN_DC, //尝试打开显示上下文 ON_CHANGE_FIRST_SHOW, //自创建以来首次显示 ON_CHANGE_SHOW_PROBE, //显示前
ON_CHANGE_SHOW, //显示、 重绘
ON_CHANGE_SHOW_POST, //显示后
ON_CHANGE_HIDE, //隐藏
ON_CHANGE_HIGHLIGHT, //高亮显示 ON_CHANGE_RELEASE_PROBE, //销毁前的准备 ON_CHANGE_RELEASE, //销毁 ON_CHANGE_ANIMATION_END, //动画播放完毕
ON_CHANGE_SHOW_COMPLETED, //显示完成​} ;
//ontouch事件 enum {​
ELM_EVENT_TOUCH_DOWN, //按下
ELM_EVENT_TOUCH_MOVE, //移动

ELM_EVENT_TOUCH_R_MOVE,//右翻
ELM_EVENT_TOUCH_L_MOVE,//左翻
ELM_EVENT_TOUCH_D_MOVE,//下翻
ELM_EVENT_TOUCH_U_MOVE,//上翻
ELM_EVENT_TOUCH_HOLD,//按住
ELM_EVENT_TOUCH_UP,//抬起
​} ;

//onkey事件 enum {​
KEY_EVENT_CLICK, //单击
KEY_EVENT_LONG, //长按
KEY_EVENT_HOLD, //按住
KEY_EVENT_DOWN, //按下
KEY_EVENT_UP, //抬起​} ;
(2)回调函数结构
struct element_event_handler {​
int id; //控件ID号
int ( *ontouch)(void * , struct element_touch_event *) ; //触摸响应函数
int ( *onkey)(void * , struct element_key_event *) ; //按键响应函数
int ( *onchange)(void * , enum element_change_event, void *) ; //控件状
态变化响应函数​} ;
(3)注册回调函数模板
/ **

  • @brief onchange 响应函数
  • @param ctrl：控件句柄，如需访问控件的变量，则需强制转换成相应控件的类型， 比如当前是图片控件的回调，则强制转换为struct ui_pic *
  • @param event : 事 件 类 型， 比 较 常 用 到 的 是 ON_CHANGE_INIT,ON_CHANGE_RELEASE，分别对应控件的初始化与控件的销毁
  • @return 0:成功 其他：失败
  • @note 该接口禁止使用ui_show、ui_hide */
    static int xxx_onchange(void *ctrl, enum element_change_event event, void *arg)
    {​
    struct ui_pic *pic = (struct ui_pic *)ctrl;//根据控件类型进行强制转换，这里假设为图片控件
    switch (event) {​
    case ON_CHANGE_INIT://控件创建，可在此初始化 break;
    case ON_CHANGE_SHOW://控件显示
    break;
    case ON_CHANGE_HIDE://控件隐藏
    break;
    case ON_CHANGE_RELEASE://控件销毁
    break;
    default:
    return FALSE;​}
    return FALSE;
    ​}
    / **
  • @brief onkey 响应函数
  • @param ctrl：控件句柄，如需访问控件的变量，需要强制转换成相应控件的结构， 比如当前是图片控件的回调，则强制转换为struct ui_pic *
  • @param event : 按键事件类型
  • @return 0:成功 其他：失败
  • @note 该接口可以使用ui_show、ui_hide控制控件的显示与隐藏*/
    static int xxx_onkey(void *ctrl, struct element_key_event *e){​
    struct ui_pic *pic = (struct ui_pic *)ctrl;//根据控件类型进行强制转换，这里假设为图片控件
    switch (e->event) {​
    case KEY_EVENT_CLICK:
    switch (e->value) {​
    case KEY_MENU:
    break;
    default:
    return false;
    ​}
    break;
    default:
    break;​}
    return true;
    ​}
    / **
  • @brief ontouch响应函数
  • @param ctrl：控件句柄，如需访问控件的变量，需要强制转换成相应控件的结构， 比如当前是图片控件的回调，则强制转换为struct ui_pic *
  • @param event : 触摸事件类型
  • @return 0:成功 其他：失败
  • @note 该接口可以使用ui_show、ui_hide控制控件的显示与隐藏*/
    static int xxx_ontouch(void *ctrl, struct element_touch_event *e){​
    struct ui_pic *pic = (struct ui_pic *)ctrl;//根据控件类型进行强制转换，这里假设为图片控件
    switch (e->event) {​
    case ELM_EVENT_TOUCH_R_MOVE:
    break;
    case ELM_EVENT_TOUCH_L_MOVE:
    break;
    case ELM_EVENT_TOUCH_D_MOVE:
    break;
    case ELM_EVENT_TOUCH_U_MOVE:
    break;
    case ELM_EVENT_TOUCH_DOWN:
    break;
    case ELM_EVENT_TOUCH_HOLD:
    break;
    case ELM_EVENT_TOUCH_MOVE:
    break;
    case ELM_EVENT_TOUCH_UP:
    break;​}
    return true;
    ​}
    REGISTER_UI_EVENT_HANDLER(控件id号) //控件id号请参考style.h
    .onchange = xxx_onchange,
    .onkey = xxx_onkey,
    .ontouch = xxx_ontouch,​} ;
    image

五、控件接口

http://www.zh-jieli.com/

五、控件接口

（一）图片控件接口
1．显示图片

(1)功能介绍
(2)接口介绍

函数原型int ui_pic_show_image_by_id(int id, int index);
功能描述在图片列表里切换显示图片
参数说明id：控件id index： 图片列表中的索引
输出0：成功 其他：失败
例子
关联模块ui_pic.c
补充说明
2． 图片控件初始化

(1)功能介绍
(2)接口介绍

函数原型int ui_pic_set_image_index(struct ui_pic *pic, int index);
功能描述在图片控件响应里设置需要显示的图片索引
参数说明pic:图片控件句柄 index:图片列表索引
输出0：成功 其他：失败
例子
关联模块ui_pic.c
补充说明
（二）按钮控件
（三）表格控件/水平列表控件/垂直列表控件
1．选择列表项

(1)功能介绍
(2)接口介绍

函数原型void ui_grid_set_item(struct ui_grid *grid,int index);
功能描述设置表格活动项
参数说明grid：表格控件句柄 index：活动项索引
输出无
例子
关联模块ui_grid.c
补充说明
2．获取列表项

(1)功能介绍
(2)接口介绍

函数原型int ui_grid_cur_item(struct ui_grid *grid);
功能描述获取当前表格活动项
参数说明grid：表格控件句柄
输出返回当前高亮的索引或者触摸的索引
例子
关联模块ui_grid.c
补充说明
3．高亮列表项

(1)功能介绍
(2)接口介绍

函数原型int ui_grid_highlight_item(struct ui_grid *grid, int item, boolyes);
功能描述高亮指定子项
参数说明grid：表格控件句柄 item：子项序号 yes：是否高亮
输出0：成功 其他：失败
例子
关联模块ui_gird.c
补充说明
4．设置焦点

(1)功能介绍
(2)接口介绍

函数原型void ui_grid_on_focus(struct ui_grid *grid);
功能描述设置表格控件为焦点控件，按键、触摸消息直接发给焦点控件
参数说明grid：表格控件句柄
输出无
例子
关联模块
补充说明
5．取消焦点

(1)功能介绍
(2)接口介绍

函数原型void ui_grid_lose_focus(struct ui_grid *grid);
功能描述设置表格控件为非焦点控件
参数说明grid：表格控件句柄
输出无
例子
关联模块
补充说明
（四）时间控件
1．设置时间

(1)功能介绍
(2)接口介绍

函数原型int ui_time_update_by_id(int id, struct utime *time);
功能描述设置时间
参数说明id：时间控件ID
struct utime {​
u16 year; //年
u8 month ; //月
u8 day; //日
u8 hour; //时
u8 min; //分
u8 sec; //秒
​} ;
time：时间
输出0：成功 其他：失败
例子
关联模块ui_time.c
补充说明
（五）文本控件

文本控件支持ascii、strpic、text 的编码格式。ascii主要用于显示ASCII 码的场合，strpic主要用于固定文字的场合，一般用于多国语言的菜单显示。 text格式主要用于非固定文字的场合，例如短信，歌词显示等需要字库的支持。

1．文本控件初始化（strpic编码格式）

(1)功能介绍
(2)接口介绍

函数原型int ui_text_set_index(struct ui_text *text, int index);
功能描述在文字列表里切换显示（strpic编码格式）
参数说明text：文本控件句柄 index:文字索引
输出0：成功 其他：失败
例子
关联模块ui_text.c
补充说明
2．显示指定的文本（strpic编码格式）

(1)功能介绍
(2)接口介绍

函数原型int ui_text_show_index_by_id(int id, int index);
功能描述在文字列表里切换显示（strpic编码格式）
参数说明id：文本控件id号 index:文字索引
输出0：成功 其他：失败
例子
关联模块ui_text.c
补充说明
3．文本控件初始化（ascii编码格式）

(1)功能介绍
(2)接口介绍

函数原型int ui_text_set_str(struct ui_text *text, const char *format, const char *str, int strlen, u32 flags);
功能描述ascii编码的初始化函数
参数说明text：文本控件句柄
format:格式
str：ascii编码
strlen：编码长度
flags：标志位
输出
例子
关联模块ui_text.c
补充说明
4．显示指定的ASCII码（ascii编码格式）

(1)功能介绍
(2)接口介绍

函数原型int ui_text_set_str_by_id(int id, const char *format, const char *str);
功能描述显示ascii码（ascii编码格式，ascii 字库默认已添加）
参数说明id：文本控件id
format:文本控件格式
str：ascii编码
输出0：成功 其他：失败
例子
关联模块
补充说明
5．文本控件初始化（text编码格式）

(1)功能介绍
(2)接口介绍

函数原型void ui_text_set_text_attrs(struct ui_text *text, const char *str, int strlen, u8 encode, u8 endian, u32 flags);
功能描述text编码的初始化函数
参数说明text：文本控件句柄
str：编码
strlen：编码长度
encode：编码类型
endian：大小端
flags：标志位
输出0：成功 其他：失败
例子
关联模块
补充说明
6．显示内码（text编码格式）

(1)功能介绍
(2)接口介绍

函数原型int ui_text_set_text_by_id(int id, const char *str, int strlen, u32 flags);
功能描述内码显示接口
参数说明id：文本控件id
str:内码
strlen：编码长度
flags:标志位
输出0：成功 其他：失败
例子
关联模块
补充说明
7．显示UNICODE编码（text编码格式）

(1)功能介绍
(2)接口介绍

函数原型int ui_text_set_textw_by_id(int id, const char *str, int strlen,
int endian, u32 flags);
功能描述unicode编码显示接口
参数说明id：文本控件id
str:unicode编码
strlen：编码长度
endian:大小端
flags:标志位
输出
例子
关联模块
补充说明
8．显示UTF8编码（text编码格式）

(1)功能介绍
(2)接口介绍

函数原型int ui_text_set_textu_by_id(int id, const char *str, int strlen, u32 flags);
功能描述utf8编码显示接口
参数说明id：文本控件id
str:utf8编码
strlen：编码长度
flags:标志位
输出0：成功 其他：失败
例子
关联模块
补充说明
（六）电池控件
1．改变所有电池控件的电量状态

(1)功能介绍
(2)接口介绍

函数原型void ui_battery_level_change(int persent, int incharge);
功能描述改变所有电池控件的状态
参数说明persent： 电池电量百分比
incharge:是否充电状态
输出0：成功 其他：失败
例子
关联模块ui_battery.c
补充说明
2．改变指定电池控件的电量状态

(1)功能介绍
(2)接口介绍

函数原型int ui_battery_set_level_by_id(int id, int persent, int
incharge);
功能描述改变指定电池控件的状态
参数说明persent： 电池电量百分比
incharge:是否充电状态
输出0：成功 其他：失败
例子
关联模块ui_battery.c
补充说明
3． 电池控件电量状态初始化

(1)功能介绍
(2)接口介绍

函数原型int ui_battery_set_level(struct ui_battery *battery, int persent, int incharge);
功能描述改变电池控件的状态
参数说明battery:电池控件句柄
persent：百分比
incharge:是否充电
输出0：成功 其他：失败
例子ui_battery_set_level(battery, 30, 0);//非充电状态， 电池电量为30%，根据电量显示相应的电量图标
关联模块ui_battery.c
补充说明
（七）数字控件
1．设置数字

(1)功能介绍更新数字控件的显示内容
(2)接口介绍

函数原型int ui_number_update_by_id(int id, struct unumber *n);
功能描述更新数字显示
参数说明id：数字控件IDenum {​
TYPE_NUM,//数字
TYPE_STRING, //数字字符串​} ;
struct unumber {​
u8 numbs; //数字个数
u8 type; //类型
u32 number[2] ; //数值， 当TYPE_NUM 时有效
u8 *num_str; //字符串,当TYPE_STRING 时有效​} ;
n:需要显示的数字参数
输出0：成功 其他：失败
例子struct unumber n;
n.type = TYPE_NUM;
n.numbs = 1 ;
n.number[0] = 10;
ui_number_update_by_id(NUMBER,&n);
关联模块ui_number.c
补充说明这个接口的参数需要与数字控件的格式参数对应， 比如格式是”%d”,这里就要填数值类型的参数
（八）滑动条控件
1．设置滑动块进度

(1)功能介绍根据百分比更新滑动块的显示位置
(2)接口介绍

函数原型int ui_slider_set_persent_by_id(int id, int persent) ;
功能描述设置滑动块进度
参数说明id：控件id persent：百分比（0~ 100%）
输出0：成功 其他：失败
例子ui_slider_set_persent_by_id( SLIDER, 20);
关联模块ui_slider.c
补充说明
（九）圆环进度条控件
1．设置圆环进度

(1)功能介绍更新圆环的显示百分比
(2)接口介绍

函数原型int ui_progress_set_persent_by_id(int id, int persent) ;
功能描述设置圆环进度
参数说明id：控件id persent：百分比（0~ 100%）
输出0：成功 其他：失败
例子ui_progress_set_persent_by_id(PROGRESS, 10);
关联模块ui_progress.c
补充说明
（十）多圆环进度条控件
1．设置第一个圆环进度

(1)功能介绍更新第一个圆环的显示百分比
(2)接口介绍

函数原型int ui_multiprogress_set_first_persent_by_id(int id, int persent) ;
功能描述设置第一个圆环进度
参数说明id：多圆环控件ID
persent：进度（0~ 100%）
输出0：成功 其他：失败
例子ui_multiprogress_set_first_persent_by_id(MULTIPROGRESS, 25) ;
关联模块ui_progress_multi.c
补充说明
2．设置第二个圆环进度

(1)功能介绍更新第二个圆环的显示百分比
(2)接口介绍

函数原型int ui_multiprogress_set_second_persent_by_id(int id, int percent) ;
功能描述设置第二个圆环进度
参数说明id：多圆环控件ID
persent：进度（0~ 100%）
输出0：成功 其他：失败
例子ui_multiprogress_set_second_persent_by_id(MULTIPROGRESS, 50);
关联模块ui_progress_multi.c
补充说明
3．设置第三个圆环进度

(1)功能介绍更新第三个圆环的显示百分比
(2)接口介绍

函数原型int ui_multiprogress_set_third_persent_by_id(int id, int percent) ;
功能描述设置第三个圆环进度
参数说明id：多圆环控件ID
persent：进度（0~ 100%）
输出0：成功 其他：失败
例子ui_multiprogress_set_third_persent_by_id(MULTIPROGRESS, 30);
关联模块ui_progress_multi.c
补充说明
（十一）模拟时钟控件
1．设置模拟时钟时间

(1)功能介绍更新模拟时钟控件时、分、秒针的位置
(2)接口介绍

函数原型int ui_watch_set_time_by_id(int id, int hour, int min, int sec);
功能描述设置模拟时钟时间
参数说明id：时钟控件ID
hour：时
min：分
sec：秒
输出0：成功 其他：失败
例子ui_watch_set_time_by_id(WATCH, 12, 10,30);
关联模块ui_watch.c
补充说明