LVGL笔记20–lv_btnm矩阵按钮

最新推荐文章于 2024-04-23 08:56:01 发布

未来可期wrs

最新推荐文章于 2024-04-23 08:56:01 发布

阅读量2.2k

点赞数 2

分类专栏： LVGL学习笔记

本文链接：https://blog.csdn.net/qq_38685043/article/details/113829116

版权

LVGL学习笔记专栏收录该内容

17 篇文章 51 订阅

订阅专栏

LVGL笔记20–lv_btnm矩阵按钮

v_btnm 矩阵按钮对象你可以看作是一系列伪按钮的集合,只不过它是以行和列有序的方式来排列这些子按钮,名称中的 m 就是 matrix(矩阵)的缩写,注意了,我这里故意加了一个伪字来说明它不是真正的 lv_btn 按钮对象,而是 lv_btnm 内部纯绘制出来的具有按钮外观的图形,而且这个图形具有和 lv_btn 按钮一样的点击效果,这种伪按钮的好处是它基本不占内存消耗(一个伪按钮大概需要 8 个字节),这属于littleVGL 的一种优化操作,所以如果你有多个按钮集合的应用场景的话,请最好使用 lv_btnm 控件,而不要去使用 lv_cont 容器外加 lv_btn 按钮的方案.

lv_btnm空间可以给它每个伪按钮设置文本标题以及设置相对的大小、位置，还可以通过lv_btnm_set_btn_ctrl 接口来设置其内部按钮的各种控制属性，比如是否可见、是否处于禁用状态等，除此之外lv_btnm具有和lv_label对象一样的文本重绘色功能，以及One toggle特性，可以通过lv_btnm_set_one_toggle接口来使能One toggle特性，使能之后，同一时刻最多只能允许一个按钮处于切换状态。

当 lv_btnm 内部的按钮被点击或者被重复长按下时,它会给它的事件回调函数发送

LV_EVENT_VALUE_CHANGED事件,于此同时这个按钮的id号会作为事件自定义数据传递过去,那我们在事件回调函数中可以通过如下代码的方式来获取按钮的 id 号:
uint16_t * btn_id = (uint16_t*)lv_event_get_data();
printf(“当前被按下的按钮 id 为:%d”, *btn_id);
除了这种方式外,我们还可以通过 lv_btnm_get_active_btn(btnm)接口来获取按钮的 id 号,注意了,当按钮被重复长按下时,它也是发送 LV_EVENT_VALUE_CHANGED 事件,而不是发送前面章节介绍过的 LV_EVENT_LONG_PRESSED_REPEAT 事件,如果你不想让按钮具有重复长按效果的话,那我们是可以通过控制属性来设置的.

lv_btnm 对象内部按钮的排列方式,它是以从左往右,从上到下的方式来排列的,其内部的每一个按钮都具有一个唯一的id号,这个id号也是按照上面的排列方式来进行分配的,从 0 开始分配,然后依次增 1,整体上来说,lv_btnm 控件有点小复杂,但是只要你掌握了,就可以实现很强大的功能,我们后面要讲到的lv_kb 键盘控件也是利用 lv_btnm 控件来实现的

主要数据类型

控制属性数据类型

enum {
    LV_BTNM_CTRL_HIDDEN = 0x0008, 
    LV_BTNM_CTRL_NO_REPEAT = 0x0010,
    LV_BTNM_CTRL_INACTIVE = 0x0020,
    LV_BTNM_CTRL_TGL_ENABLE = 0x0040,
    LV_BTNM_CTRL_TGL_STATE = 0x0080, 
    LV_BTNM_CTRL_CLICK_TRIG = 0x0100, 
};
typedef uint16_t lv_btnm_ctrl_t;

LV_BTNM_CTRL_HIDDEN: 设置按钮为隐藏不可见状态

LV_BTNM_CTRL_NO_REPEAT: 设置按钮不具有重复长按的动作效果

LV_BTNM_CTRL_INACTIVE: 设置按钮为禁用状态

LV_BTNM_CTRL_TGL_ENABLE: 设置按钮为 Toggle 切换按钮

LV_BTNM_CTRL_TGL_STATE: 设置按钮当前的状态就是切换态

LV_BTNM_CTRL_CLICK_TRIG: 设置按钮的点击方式为松手触发,如果不设置的话,那默认就是按下时触发,二者只能选择一种

这些值之间是可以进行位或操作的。

矩阵按钮样式数据类型

enum {
    LV_BTNM_STYLE_BG,
    LV_BTNM_STYLE_BTN_REL,
    LV_BTNM_STYLE_BTN_PR,
    LV_BTNM_STYLE_BTN_TGL_REL,
    LV_BTNM_STYLE_BTN_TGL_PR,
    LV_BTNM_STYLE_BTN_INA,
};
typedef uint8_t lv_btnm_style_t;

只有 LV_BTNM_STYLE_BG 这一个样式是用来修饰 lv_btnm 对象背景的,其他的 5 个样式全部是用来修饰其内部的伪按钮.

LV_BTNM_STYLE_BG: 修饰 lv_btnm 对象的背景,其中 body.padding 下的 left,top, right,bottom 是用来设置按钮与 lv_btnm 对象边框的各种内边距,然后 inner 字段是用来设置按钮与按钮之间的距离

API函数接口

创建lv_btnm对象

/*--------------------------------------------------------------------------------
	这个函数用来创建lv_btnm对象
	par: 父对象
	copy: 拷贝的对象,如果无拷贝的话,传 NULL 值 
    返回值:
		返回创建出来的对象,如果返回 NULL 的话,说明堆空间不够了
---------------------------------------------------------------------------------*/
lv_obj_t * lv_btnm_create(lv_obj_t * par, const lv_obj_t * copy);

设置按钮映射表

/*--------------------------------------------------------------------------------
	这个函数用来设置lv_btnm对象按钮映射表
	btnm: 矩阵按钮对象
	map: 矩阵按钮对象就是根据这个 map 映射表来确定其内部的按钮个数以及按钮标题的,map 就是一个字符串数组,除了”\n”换行元素
	和””空串结尾元素外,其中的每一个元素都代表着一个按钮,字符串的内容就是这个按钮的文本标题,比如我想在其内部创建 4 个按钮,
	分为 2 行,上面 2 个,下面 2 个,那么 map 映射表具体如下:
---------------------------------------------------------------------------------*/
const char * const map[] = {"Btn1", "Btn2", "\n", "Btn3", "Btn4", ""};//其中的”\n”元素仅仅是用来换行的,没有其
//他的实际含义,然后 map 映射表的末尾必须要以一个””空串来作为结束标志,然后其默认样式效果如下:

void lv_btnm_set_map(const lv_obj_t * btnm, const char * map[]);

//有一点需要注意了,那就是 lv_btnm 矩阵按钮对象只是在内部简单的引用了map 映射表,没有做拷贝操作的,所以你得保证这个 map 映射
//表资源在外部不能被释放了

在这里插入图片描述

设置某个按钮的控制属性

/*--------------------------------------------------------------------------------
	这个函数用来设置某个按钮的控制属性
	btnm: 矩阵按钮对象
	btn_id: 设置哪一个按钮的控制属性,由此按钮的 id 来指定,注意”\n”换行元素不是按钮,因此它是没有按钮 id 的
	ctrl: 控制属性,有如下 6 个可选值:
    LV_BTNM_CTRL_HIDDEN:设置按钮为隐藏不可见状态
    LV_BTNM_CTRL_NO_REPEAT:设置按钮不具有重复长按的动作效果
    LV_BTNM_CTRL_INACTIVE:设置按钮为禁用状态
    LV_BTNM_CTRL_TGL_ENABLE:设置按钮为 Toggle 切换按钮
    LV_BTNM_CTRL_TGL_STATE:设置按钮当前的状态就是切换态
    LV_BTNM_CTRL_CLICK_TRIG:设置按钮的点击方式为松手触发,如果不设置的话,那默认就是按下时触发,二者只能选择一种
	这些属性值之间是可以进行位或操作的
---------------------------------------------------------------------------------*/
void lv_btnm_set_btn_ctrl(const lv_obj_t * btnm, uint16_t btn_id, lv_btnm_ctrl_t ctrl);

给所有按钮设置共同的控制属性

/*--------------------------------------------------------------------------------
	这个函数用来给lv_btnm对象的所有按钮设置共同的控制属性
	btnm: 矩阵按钮对象
	ctrl: 控制属性,和 lv_btnm_set_btn_ctrl 接口中的含义相同
---------------------------------------------------------------------------------*/
void lv_btnm_set_btn_ctrl_all(lv_obj_t * btnm, lv_btnm_ctrl_t ctrl);

清除某个按钮的控制属性

/*--------------------------------------------------------------------------------
	这个函数用来清除lv_btnm对象的某个按钮的属性
	btnm: 矩阵按钮对象
	btn_id: 按钮 id
	ctrl: 控制属性,和 lv_btnm_set_btn_ctrl 接口中的含义相同
---------------------------------------------------------------------------------*/
void lv_btnm_clear_btn_ctrl(const lv_obj_t * btnm, uint16_t btn_id, lv_btnm_ctrl_t ctrl);

清除所有按钮的共同的控制属性

/*--------------------------------------------------------------------------------
	这个函数用来清除lv_btnm对象的所有按钮的属性
	btnm: 矩阵按钮对象
	ctrl: 控制属性,和 lv_btnm_set_btn_ctrl 接口中的含义相同
---------------------------------------------------------------------------------*/
void lv_btnm_clear_btn_ctrl_all(lv_obj_t * btnm, lv_btnm_ctrl_t ctrl);

设置某个按钮的相对宽度

/*--------------------------------------------------------------------------------
	这个函数用来设置lv_btnm对象某个按钮的相对宽度
	btnm: 矩阵按钮对象
	btn_id: 设置矩阵按钮对象中的哪一个按钮的相对宽度,由此按钮的id来指定,注意”\n”换行元素不是按钮,因此它是没有按钮 id 的
	width: 指定在同一行按钮中此按钮所占的宽度比例,它是一个当前行的相对大小哦,并不是 指定具体的宽度数值,此 width 参数的范
	围为[1,7],如果不设置的话,那么默认值就是 1, 此值越大,那么在同一行中,此按钮具有的宽度也就越大,举个简单的例子,比如在某一
	行中具有 btn1 和 btn2 俩个按钮,btn1 的 width 值为 4,而 btn2 的 width 值为 2,那么最后btn1 的在此行中的宽度是
	 btn2 的 4/2=2 倍,
---------------------------------------------------------------------------------*/
void lv_btnm_set_btn_width(const lv_obj_t * btnm, uint16_t btn_id, uint8_t width);

设置控制映射表

/*--------------------------------------------------------------------------------
	这个函数用来设置lv_btnm对象的控制映射表
	btnm: 矩阵按钮对象
	ctrl_map: 控制映射表,其中的每一个元素控制其相应的按钮,在每一个元素里面,你可以设置按钮的控制属性以及还有按钮的相对宽度,
	如下所示:	ctrl_map[0] = width | LV_BTNM_CTRL_NO_REPEAT | LV_BTNM_CTRL_TGL_ENABLE;
	这个接口会在内部对 ctrl_map 进行拷贝操作的,所以 ctrl_map 这个资源在外面被释放掉是没有关系的
---------------------------------------------------------------------------------*/
void lv_btnm_set_ctrl_map(const lv_obj_t * btnm, const lv_btnm_ctrl_t ctrl_map[]);

设置某个按钮为按下状态

/*--------------------------------------------------------------------------------
	这个函数用来设置lv_btnm对象的某个按钮为按下状态
	btnm: 矩阵按钮对象
	btn_id: 按钮 id
---------------------------------------------------------------------------------*/
void lv_btnm_set_pressed(const lv_obj_t * btnm, uint16_t id);

设置样式

/*--------------------------------------------------------------------------------
	这个函数用来设置lv_btnm对象的按钮样式
	btnm: 矩阵按钮对象
	type: 要设置那部分的样式,有如下 6 个可选值
        LV_BTNM_STYLE_BG
        LV_BTNM_STYLE_BTN_REL
        LV_BTNM_STYLE_BTN_PR
        LV_BTNM_STYLE_BTN_TGL_REL
        LV_BTNM_STYLE_BTN_TGL_PR
    	LV_BTNM_STYLE_BTN_INA
	style: 样式
---------------------------------------------------------------------------------*/
void lv_btnm_set_style(lv_obj_t * btnm, lv_btnm_style_t type, const lv_style_t * style);

是否使能文本重绘色功能

/*--------------------------------------------------------------------------------
	这个函数用来设置lv_btnm对象的文本重绘色功能
	btnm: 矩阵按钮对象
	en: 是否使能重绘色,true 是使能,false 是不使能
矩阵按钮对象的文本重绘色功能和 lv_label 标签对象的文本重绘色功能是一样的,格式也是#十六进制颜色 文本#
例如：static const char * const btnm_map[] = {"#ff0000 Red# btn", "#00ff00 Green# btn",""};
---------------------------------------------------------------------------------*/
void lv_btnm_set_recolor(const lv_obj_t * btnm, bool en);

是否使能One toggle特性

/*--------------------------------------------------------------------------------
	这个函数用来设置lv_btnm对象的是否使能One toggle特性
	btnm: 矩阵按钮对象
	one_toggle: 是否使能 One toggle 特性,true 代表使能,false 代表不使能
---------------------------------------------------------------------------------*/
void lv_btnm_set_one_toggle(lv_obj_t * btnm, bool one_toggle);

使能 One toggle 特性之后,在所有被设置了 LV_BTNM_CTRL_TGL_ENABLE 控制属性的按钮中,同一时刻就只能允许最多一个按钮处于切换态了,所以要想看到正确的效果,这里是有一个前提的,那就是至少得有 2 个按钮设置了 LV_BTNM_CTRL_TGL_ENABLE 控制属性,即至少得有 2 个 Toggle 按钮

获取当前被点击的按钮id

/*--------------------------------------------------------------------------------
	这个函数用来获取lv_btnm对象当前被点击的按钮id
	btnm: 矩阵按钮对象
	返回值:
		返回当前被点击的按钮 id,如果获取失败,则返回 LV_BTNM_BTN_NONE
---------------------------------------------------------------------------------*/
uint16_t lv_btnm_get_active_btn(const lv_obj_t * btnm);

这里的 active 是指当前活跃的按钮,也就是被点击了的按钮,点击这俩个字就包含了 2 个含义,按下时触发的或者松手时触发的,至于到底是哪一种方式触发的,取决于它有没有设置LV_BTNM_CTRL_CLICK_TRIG控制属性,此API接口一般用在事件回调函数中,用来判断当前事件是被哪一个按钮触发的

获取当前被点击的按钮文本标题

/*--------------------------------------------------------------------------------
	这个函数用来获取lv_btnm对象当前被点击的按钮的文本标题
	btnm: 矩阵按钮对象
	返回值:
		返回当前被点击的按钮文本标题,获取失败,则返回 NULL
---------------------------------------------------------------------------------*/
const char * lv_btnm_get_active_btn_text(const lv_obj_t * btnm);

此 API 接口一般用在事件回调函数中,也可以用来判断当前事件是被哪一个按钮触发的

获取当前被按下的按钮id

/*--------------------------------------------------------------------------------
	这个函数用来获取lv_btnm对象当前被点击的按钮id
	btnm: 矩阵按钮对象
	返回值:
		返回当前被点击的按钮 id,如果获取失败,则返回 LV_BTNM_BTN_NONE
---------------------------------------------------------------------------------*/
uint16_t lv_btnm_get_pressed_btn(const lv_obj_t * btnm);

此 API 接口和 lv_btnm_get_active_btn 接口功能差不多,但是此 API 接口更为具体一点,它指的是按下时,不包括松手时的情况

判断某个按钮是否已经设置过了某控制属性

/*--------------------------------------------------------------------------------
	这个函数用来判断lv_btnm对象是否已经设置了某控制属性
	btnm: 矩阵按钮对象
    btn_id: 按钮 id
    ctrl: 判断 ctrl 控制属性是否被设置过了
    返回值:
    	返回 true 代表已经被设置过了,返回 false 代表没有被设置过
---------------------------------------------------------------------------------*/
bool lv_btnm_get_btn_ctrl(lv_obj_t * btnm, uint16_t btn_id, lv_btnm_ctrl_t ctrl);

2021–2--16-wrs

未来可期wrs

关注

2
点赞
踩
10

收藏

觉得还不错? 一键收藏
2
评论
LVGL笔记20–lv_btnm矩阵按钮

LVGL笔记20–lv_btnm矩阵按钮 v_btnm 矩阵按钮对象你可以看作是一系列伪按钮的集合,只不过它是以行和列有序的方式来排列这些子按钮,名称中的 m 就是 matrix(矩阵)的缩写,注意了,我这里故意加了一个伪字来说明它不是真正的 lv_btn 按钮对象,而是 lv_btnm 内部纯绘制出来的具有按钮外观的图形,而且这个图形具有和 lv_btn 按钮一样的点击效果,这种伪按钮的好处是它基本不占内存消耗(一个伪按钮大概需要 8 个字节),这属于littleVGL 的一种优化操作,所以如果你有
复制链接

扫一扫