消息框(lv_msdbox)

概述

消息框充当弹出窗口。它们由背景容器,标签和按钮的 按钮矩阵(lv_imgbtn) 构建而成。

文本将自动分成多行(具有 LV_LABEL_LONG_MODE_BREAK ),高度将自动设置为包含文本和按钮( LV_FIT_TIGHT 垂直放置)-

零件和样式

消息框的主要部分称为 LV_MSGBOX_PART_MAIN ,它使用所有典型的背景样式属性。使用填充会增加侧面的空间。pad_inner将在文本和按钮之间添加空格。标签样式属性会影响文本样式。

按钮部分与 按钮矩阵(lv_imgbtn) 的情况相同:

  • LV_MSGBOX_PART_BTN_BG 按钮的背景

  • LV_MSGBOX_PART_BTN 按钮

用法

设置文本

要设置文本,请使用 lv_msgbox_set_text(msgbox, "My text") 函数。不仅将保存文本指针,而且文本也可以位于局部变量中。

添加按钮

要添加按钮,请使用 lv_msgbox_add_btns(msgbox, btn_str) 函数。需要指定按钮的文本,例如 const char * btn_str[] = {"Apply", "Close", ""} 。有关更多信息,请访问Button矩阵文档。

仅当首次调用 lv_msgbox_add_btns() 时,才会创建 按钮矩阵(lv_imgbtn)

自动关闭

使用 lv_msgbox_start_auto_close(mbox, delay) 可以在动画 延迟(delay) 了几毫秒后自动关闭消息框。 lv_mbox_stop_auto_close(mbox) 函数停止启动的自动关闭。

关闭动画的持续时间可以通过 lv_mbox_set_anim_time(mbox, anim_time) 设置。

事件

除了 通用事件 ,复选框还支持以下 特殊事件

  • LV_EVENT_VALUE_CHANGED 单击按钮时发送。事件数据设置为单击按钮的ID。

消息框具有一个默认的事件回调,当单击按钮时,该事件回调将自行关闭。

了解有关 事件 的更多内容。

按键处理

消息框可处理以下按键:

  • LV_KEY_RIGHT/DOWN 选择下一个按钮

  • LV_KEY_LEFT/TOP 选择上一个按钮

  • LV_KEY_ENTER 单击选定的按钮

了解有关 按键 的更多内容。

范例

简单消息框

http://photos.100ask.net/lvgl/04_widgets/22_msgbox/01_lv_msgbox_1.png

简单消息框

上述效果的示例代码:

 1    #include "../../../lv_examples.h"
 2    #include <stdio.h>
 3    #if LV_USE_MSGBOX
 4
 5    static void event_handler(lv_obj_t * obj, lv_event_t event)
 6    {
 7            if(event == LV_EVENT_VALUE_CHANGED) {
 8                    printf("Button: %s\n", lv_msgbox_get_active_btn_text(obj));
 9            }
10    }
11
12    void lv_ex_msgbox_1(void)
13    {
14            static const char * btns[] ={"Apply", "Close", ""};
15
16            lv_obj_t * mbox1 = lv_msgbox_create(lv_scr_act(), NULL);
17            lv_msgbox_set_text(mbox1, "A message box with two buttons.");
18            lv_msgbox_add_btns(mbox1, btns);
19            lv_obj_set_width(mbox1, 200);
20            lv_obj_set_event_cb(mbox1, event_handler);
21            lv_obj_align(mbox1, NULL, LV_ALIGN_CENTER, 0, 0); /*Align to the corner*/
22    }
23
24    #endif

模态

http://photos.100ask.net/lvgl/04_widgets/22_msgbox/02_lv_msgbox_2.png

模态

上述效果的示例代码:

 1    #include "../../../lv_examples.h"
 2    #if LV_USE_MSGBOX
 3
 4    static void mbox_event_cb(lv_obj_t *obj, lv_event_t evt);
 5    static void btn_event_cb(lv_obj_t *btn, lv_event_t evt);
 6    static void opa_anim(void * bg, lv_anim_value_t v);
 7
 8    static lv_obj_t *mbox, *info;
 9    static lv_style_t style_modal;
10
11    static const char welcome_info[] = "Welcome to the modal message box demo!\n"
12                    "Press the button to display a message box.";
13
14    static const char in_msg_info[] = "Notice that you cannot touch "
15                    "the button again while the message box is open.";
16
17    void lv_ex_msgbox_2(void)
18    {
19            lv_style_init(&style_modal);
20            lv_style_set_bg_color(&style_modal, LV_STATE_DEFAULT, LV_COLOR_BLACK);
21
22            /* Create a button, then set its position and event callback */
23            lv_obj_t *btn = lv_btn_create(lv_scr_act(), NULL);
24            lv_obj_set_size(btn, 200, 60);
25            lv_obj_set_event_cb(btn, btn_event_cb);
26            lv_obj_align(btn, NULL, LV_ALIGN_IN_TOP_LEFT, 20, 20);
27
28            /* Create a label on the button */
29            lv_obj_t *label = lv_label_create(btn, NULL);
30            lv_label_set_text(label, "Display a message box!");
31
32            /* Create an informative label on the screen */
33            info = lv_label_create(lv_scr_act(), NULL);
34            lv_label_set_text(info, welcome_info);
35            lv_label_set_long_mode(info, LV_LABEL_LONG_BREAK); /* Make sure text will wrap */
36            lv_obj_set_width(info, LV_HOR_RES - 10);
37            lv_obj_align(info, NULL, LV_ALIGN_IN_BOTTOM_LEFT, 5, -5);
38
39    }
40
41    static void mbox_event_cb(lv_obj_t *obj, lv_event_t evt)
42    {
43            if(evt == LV_EVENT_DELETE && obj == mbox) {
44                    /* Delete the parent modal background */
45                    lv_obj_del_async(lv_obj_get_parent(mbox));
46                    mbox = NULL; /* happens before object is actually deleted! */
47                    lv_label_set_text(info, welcome_info);
48            } else if(evt == LV_EVENT_VALUE_CHANGED) {
49                    /* A button was clicked */
50                    lv_msgbox_start_auto_close(mbox, 0);
51            }
52    }
53
54    static void btn_event_cb(lv_obj_t *btn, lv_event_t evt)
55    {
56            if(evt == LV_EVENT_CLICKED) {
57                    /* Create a full-screen background */
58
59                    /* Create a base object for the modal background */
60                    lv_obj_t *obj = lv_obj_create(lv_scr_act(), NULL);
61                    lv_obj_reset_style_list(obj, LV_OBJ_PART_MAIN);
62                    lv_obj_add_style(obj, LV_OBJ_PART_MAIN, &style_modal);
63                    lv_obj_set_pos(obj, 0, 0);
64                    lv_obj_set_size(obj, LV_HOR_RES, LV_VER_RES);
65
66                    static const char * btns2[] = {"Ok", "Cancel", ""};
67
68                    /* Create the message box as a child of the modal background */
69                    mbox = lv_msgbox_create(obj, NULL);
70                    lv_msgbox_add_btns(mbox, btns2);
71                    lv_msgbox_set_text(mbox, "Hello world!");
72                    lv_obj_align(mbox, NULL, LV_ALIGN_CENTER, 0, 0);
73                    lv_obj_set_event_cb(mbox, mbox_event_cb);
74
75                    /* Fade the message box in with an animation */
76                    lv_anim_t a;
77                    lv_anim_init(&a);
78                    lv_anim_set_var(&a, obj);
79                    lv_anim_set_time(&a, 500);
80                    lv_anim_set_values(&a, LV_OPA_TRANSP, LV_OPA_50);
81                    lv_anim_set_exec_cb(&a, (lv_anim_exec_xcb_t)opa_anim);
82                    lv_anim_start(&a);
83
84                    lv_label_set_text(info, in_msg_info);
85                    lv_obj_align(info, NULL, LV_ALIGN_IN_BOTTOM_LEFT, 5, -5);
86            }
87    }
88
89    static void opa_anim(void * bg, lv_anim_value_t v)
90    {
91            lv_obj_set_style_local_bg_opa(bg, LV_OBJ_PART_MAIN, LV_STATE_DEFAULT, v);
92    }
93
94    #endif

相关API

函数

 1    lv_obj_t * lv_objmask_create(lv_obj_t * par,constlv_obj_t *copy)
 2    创建对象遮罩对象
 3    返回:
 4    指向创建的对象掩码的指针
 5    形参:
 6    par:指向对象的指针,它将是新对象蒙版的父对象
 7    copy:指向对象掩码对象的指针,如果不为NULL,则将从其复制新对象
 8
 9
10    lv_objmask_mask_t * lv_objmask_add_mask(lv_obj_t * objmask,void *param)
11    添加面膜
12    返回:
13    指向添加的蒙版的指针
14    形参:
15    objmask:指向对象遮罩对象的指针
16    param:初始化的mask参数
17
18
19    void lv_objmask_update_mask(lv_obj_t * objmask,lv_objmask_mask_t * mask,void * param )
20    更新已创建的蒙版
21    形参:
22    objmask:指向对象遮罩对象的指针
23    mask:指向创建的遮罩的指针(由返回:lv_objmask_add_mask)
24    param:初始化的mask参数(由初始化lv_draw_mask_line/angle/.../_init)
25
26
27    void lv_objmask_remove_mask(lv_obj_t * objmask,lv_objmask_mask_t * mask )
28    取下口罩
29    形参:
30    objmask:指向对象遮罩对象的指针
31    mask:指向创建的遮罩的指针(由返回:lv_objmask_add_mask)如果NULL通过,则将删除所