虽然这是一个很小的控件,但是一个完整的用户界面正是由很多小的,单独的控件组成的,如果一个界面是一整个控件,那肯定是不可能的,所以我们要先将最基本的控件学习并掌握完成后,后面我们做东西才能不会出现不知道用啥控件的问题,所以现在你每学习的一个控件,到最后都会都是有作用的!
二 代码分析
用户可下载"圆弧对象(lv_arc)的使用"文章末尾的Demo工程(点击我直接下载),参考圆弧对象(lv_arc)的使用文章,将以下Demo代码复制到Demo工程test.c文件空白处.然后在test.c文件的create_test()函数中增加cb_test()函数测试。 01 | static void cb_event_handler(lv_obj_t * obj, lv_event_t event) |
03 | if (event == LV_EVENT_VALUE_CHANGED) { |
04 | printf ( "State: %s\n" , lv_cb_is_checked(obj) ? "Checked" : "Unchecked" ); |
09 | lv_obj_t * cb = lv_cb_create(lv_scr_act(), NULL); |
10 | lv_cb_set_text(cb, "I agree to terms and conditions." ); |
11 | lv_obj_align(cb, NULL, LV_ALIGN_CENTER, 0, 0); |
12 | lv_obj_set_event_cb(cb, cb_event_handler); |
可以看到这里的代码还是比较简单的,lv_cb_set_text函数是设置跟在复选框后面的文字的,然后我们通过lv_obj_set_event_cb函数设置一个回调函数,用来响应复选框选中后的事件触发,最后我们在回调函数中打印出了复选框的状态,我们再来看一下上面代码中没有提到的几个API:
1 | void lv_cb_set_static_text(lv_obj_t *cb, const char *txt); |
2 | void lv_cb_set_style(lv_obj_t *cb, lv_cb_style_t type, const lv_style_t *style); |
3 | static void lv_cb_set_checked(lv_obj_t *cb, bool checked); |
4 | static void lv_cb_set_inactive(lv_obj_t *cb); |
5 | const char *lv_cb_get_text(constlv_obj_t *cb; |
6 | static bool lv_cb_is_checked(constlv_obj_t *cb); |
7 | static bool lv_cb_is_inactive(constlv_obj_t *cb); |
8 | const lv_style_t *lv_cb_get_style(constlv_obj_t *cb, lv_cb_style_t type); |
复选框控件基本就上面这些API了,其实大家看名称应该也都能够知道是什么作用,那么这里给大家也做一下简单介绍:
lv_cb_set_static_text(lv_obj_t *cb, const char *txt);
也是设置文本,不过这里的文本要确保在复选框的声明周期内都要确保没有被释放掉,否则会出现意想不到的效果。
lv_cb_set_style(lv_obj_t * cb, lv_cb_style_t type, const lv_style_t * style);
设置复选框的样式,其中type参数指的是复选框的哪一个样式要被设置,也就是是背景样式,是选中的样式,还是未被选中的样式,具体参数可以看下面的枚举结构体:
06 | LV_CB_STYLE_BOX_TGL_REL, |
07 | LV_CB_STYLE_BOX_TGL_PR, |
10 | typedef uint8_t lv_cb_style_t; |
lv_cb_set_checked(lv_obj_t *cb, bool checked);设置复选框的状态,当参数checked为true是,复选框是选中状态,为false是未选中状态。
void lv_cb_set_inactive(lv_obj_t *cb);
禁用复选框,让复选框不再可以被选中,没发现有可以再次激活的API。
char *lv_cb_get_text(constlv_obj_t *cb;
获取我们设置的文本
bool lv_cb_is_checked(constlv_obj_t *cb);
查询复选的状态,返回未true是已被选中,false是未选中。
bool lv_cb_is_inactive(constlv_obj_t *cb);
查询是否被禁用,返回未true是已被禁用,false是未禁用。
lv_style_t *lv_cb_get_style(constlv_obj_t *cb, lv_cb_style_t type);
查询样式,同样的type参数与上面设置样式的时候参数是一样的。
OK,本节课程就到这里,大家有没有觉得很简单呢?我们下一节课来学习图表控件(lv_chart),那我们下节课再见!