合宙Air724UG LuatOS-Air LVGL API控件-页面 (Page)

页面 (Page)

当控件内容过多，无法在屏幕内完整显示时，可让其在 页面 内显示。

示例代码

page = lvgl.page_create(lvgl.scr_act(), nil)
lvgl.obj_set_size(page, 150, 200)
lvgl.obj_align(page, nil, lvgl.ALIGN_CENTER, 0, 0)
 
label = lvgl.label_create(page, nil)
lvgl.label_set_long_mode(label, lvgl.LABEL_LONG_BREAK)            
lvgl.obj_set_width(label, lvgl.page_get_width_fit(page)) 
        
 
 
lvgl.label_set_text(label, 
[[Lorem ipsum dolor sit amet, consectetur adipiscing elit,
sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse cillum dolore
eu fugiat nila pariatur.
Excepteur sint occaecat cupidatat non proident, sunt in culpa
qui officia deserunt mollit anim id est laborum.]])

创建

通过函数 lvgl.page_create 可以创建一个页面

page = lvgl.page_create(lvgl.scr_act(), nil)

添加内容

页面对象可以像容器一样设置各个方向上的匹配模式，可以把需要显示的对象添加进页面进行显示，页面可以作为控件的父容器。就像下面这样，在页面中添加了一个标签。

label = lvgl.label_create(page, nil)

滚动条

页面的滚动条可以通过 lvgl.page_set_scrlbar_mode 函数进行设置，页面的滚动条设置有以下几个参数:

lvgl.SCRLBAR_MODE_OFF 
lvgl.SCRLBAR_MODE_ON 
lvgl.SCRLBAR_MODE_DRAG 
lvgl.SCRLBAR_MODE_AUTO 
lvgl.SCRLBAR_MODE_HIDE 
lvgl.SCRLBAR_MODE_UNHIDE 

这些参数代表的含义如下：
lvgl.SCRLBAR_MODE_OFF 是从始至终不显示滚动条。
lvgl.SCRLBAR_MODE_ON 是一直会显示滚动条。
lvgl.SCRLBAR_MODE_DRAG 是只有在拖动页面时才会显示滚动条。
lvgl.SCRLBAR_MODE_AUTO 表示自适应，只有在页面没有办法完整显示的时候才会启用滚动条，这是个默认选项。
lvgl.SCRLBAR_MODE_HIDE 会将滚动条隐藏。
lvgl.SCRLBAR_MODE_UNHIDE 会把隐藏的滚动条重新显示。

下面我们看下 lvgl.SCRLBAR_MODE_DRAG 的一个显示效果，只在页面滚动时显示滚动条。

lvgl.page_set_scrollbar_mode(page, lvgl.SCRLBAR_MODE_DRAG)

焦点对象

可以通过设置焦点对象来自动滚动页面进行一些内容展示。例如，首先在页面比较偏的一个位置创建个文本标签。

hello = lvgl.label_create(page, nil)
lvgl.label_set_text(hello, "hello")
lvgl.obj_set_pos(hello, 150, 190)

然后把这个文本设置为焦点对象，等待 4S 之后，再将焦点对象移回主控件。

lvgl.page_set_anim_time(page, 4000)
lvgl.page_focus(page, hello, lvgl.ANIM_ON)
sys.wait(4000)
lvgl.page_focus(page, label, lvgl.ANIM_ON)
sys.wait(4000)

效果展示如下，实际上可以设置多个控件，在页面循环进行展示。

动画

其实除了对焦控件这种展示动画以外，页面控件可以设置一个边缘闪烁效果，在页面滚动达到边缘的时候会显示一段弧线。

lvgl.page_set_edge_flash(page, true)

滚动传播

如果在一个页面 A 之中创建了一个页面 B，那么在页面 B 滚动到边缘的时候时候就停止了，无法继续滚动。
 

但是如果设置了滚动传播，在子控件滚动到边缘的时候，会将滚动事件传给它的父对象。

lvgl.page_set_scroll_propagation(page2, true)

清除页面

页面上创建的对象都可以通过 lvgl.page_clean(page) 进行清除。

API

lvgl.page_create

lvgl.page_clean

lvgl.page_get_scrollable

lvgl.page_get_anim_time

lvgl.page_get_anim_time

lvgl.page_get_anim_time

lvgl.page_set_scroll_propagation

lvgl.page_set_edge_flash

lvgl.page_set_scrollable_fit4

lvgl.page_set_scrollable_fit4

lvgl.page_set_scrollable_fit2

lvgl.page_set_scrollable_fit

lvgl.page_set_scrl_width

lvgl.page_set_scrl_height

lvgl.page_set_scrl_layout

lvgl.page_get_scrollbar_mode

lvgl.page_get_scroll_propagation

lvgl.page_get_edge_flash

lvgl.page_get_scrl_width

lvgl.page_get_scrl_height

lvgl.page_get_scrl_layout

lvgl.page_get_scrl_fit_left

lvgl.page_get_scrl_fit_right

lvgl.page_get_scrl_fit_top

lvgl.page_get_scrl_fit_bottom

lvgl.page_focus