LVGL-消息框

lv_msgbox_create

用于创建消息框(Message Box)的函数,用于显示提示信息、警告或用户交互对话框

lv_obj_t* lv_msgbox_create(
    lv_obj_t* parent,          // 父容器(通常为当前屏幕 `lv_scr_act()` 或 NULL)
    const char* title,         // 消息框标题(可设为 NULL)
    const char* txt,           // 消息正文内容
    const char* btn_txts[],    // 按钮文本数组(以 NULL 结尾)
    bool add_close_btn         // 是否添加右上角关闭按钮
);
//ret:消息框对象指针(lv_obj_t*)

lv_msgbox_get_title

用于获取消息框(Message Box)标题对象的函数

lv_obj_t* lv_msgbox_get_title(lv_obj_t* msgbox);
//msgbox:消息框对象指针
//ret:指向标题标签对象(lv_label)的指针,若消息框无标题则返回 NULL

lv_msgbox_get_close_btn

用于获取消息框(Message Box)右上角关闭按钮对象的函数

lv_obj_t* lv_msgbox_get_close_btn(lv_obj_t* msgbox);
//msgbox:消息框对象指针
//ret:指向关闭按钮对象(lv_btn)的指针,若消息框未启用关闭按钮则返回 NULL

lv_msgbox_get_text

用于获取消息框(Message Box)正文文本标签对象的函数

lv_obj_t* lv_msgbox_get_text(lv_obj_t* msgbox);
//msgbox:消息框对象指针
//ret:指向正文文本标签对象(lv_label)的指针,若消息框无正文则返回 NULL

lv_msgbox_get_content

用于获取消息框(Message Box)内容区对象指针的函数

lv_obj_t* lv_msgbox_get_content(lv_obj_t* msgbox);
//msgbox:消息框对象指针
//ret:指向内容区容器对象(lv_obj)的指针,可用于添加或管理子控件

lv_msgbox_get_btns

用于获取消息框(Message Box)底部按钮矩阵对象的函数

lv_obj_t* lv_msgbox_get_btns(lv_obj_t* msgbox);
//msgbox:消息框对象指针
//ret:指向按钮矩阵对象(lv_btnmatrix)的指针,可直接操作按钮布局、样式和事件

lv_msgbox_get_active_btn

用于获取消息框(Message Box)当前被点击按钮索引的函数

uint16_t lv_msgbox_get_active_btn(lv_obj_t* msgbox);
////msgbox:消息框对象指针
//ret:被点击按钮的索引(从 0 开始),若无按钮被点击,返回 LV_BTNMATRIX_BTN_NONE

lv_msgbox_get_active_btn_text

用于获取消息框(Message Box)当前被点击按钮文本的函数

const char* lv_msgbox_get_active_btn_text(lv_obj_t* msgbox);
//msgbox:消息框对象指针
//ret:被点击按钮的文本字符串(如 "OK"、"Cancel"),若无按钮被点击,返回 NULL

lv_msgbox_close

用于关闭(销毁)消息框(Message Box)的函数

void lv_msgbox_close(lv_obj_t* msgbox);
//msgbox:消息框对象指针

lv_msgbox_close_async

用于异步关闭消息框的函数,与同步关闭函数 lv_msgbox_close() 相比,它通过延迟销毁操作避免界面阻塞

void lv_msgbox_close_async(lv_obj_t* msgbox);
//msgbox:消息框对象指针
posted @ 2025-06-30 19:32  LRadian  阅读(152)  评论(0)    收藏  举报