[English]

Tile view（平铺视图） (lv_tileview)

Overview（概述）

显示原文

The Tile view is a container object whose elements (called tiles) can be arranged in grid form. A user can navigate between the tiles by swiping. Any direction of swiping can be disabled on the tiles individually to not allow moving from one tile to another.

If the Tile view is screen sized, the user interface resembles what you may have seen on smartwatches.


平铺视图(lv_tileview)平铺视图(Tileview)是一个容器对象，其中的元素（称为图块）可以以网格形式排列。通过滑动，用户可以在图块之间导航。可以单独在图块上禁用任何方向的滑动，以不允许从一个图块移动到另一个图块。

如果Tileview是屏幕尺寸的，它将提供可能已经在智能手表上看到的用户界面。

Parts and Styles（零件和样式）

显示原文

The Tile view is built from an lv_obj.h container and lv_obj.h tiles.

The parts and styles work the same as for lv_obj.h.


平铺视图是由 lv_obj.h 容器和 lv_obj.h 平铺构建的。

部件和样式的工作方式与 lv_obj.h 相同。

Usage（用法）

Add a tile（添加平铺显示）

显示原文

lv_tileview_add_tile(tileview, row_id, col_id, dir) creates a new tile on the row_idth row and col_idth column. dir can be LV_DIR_LEFT/RIGHT/TOP/BOTTOM/HOR/VER/ALL or OR-ed values to enable moving to the adjacent tiles into the given direction by swiping.

The returned value is an lv_obj_t * on which the content of the tab can be created.


lv_tileview_add_tile(tileview, row_id, col_id, dir) 创建一个新的第 row_idth 行和 col_idth 列上的瓦片 目录 可以是 LV_DIR_LEFT/RIGHT/TOP/BOTTOM/HOR/VER/ALL 或 OR-ed 值以启用通过滑动向给定方向移动到相邻的图块。

返回的值是可以在其 lv_obj_t * 上创建选项卡内容的值。

Change tile（更改平铺显示）

显示原文

The Tile view can scroll to a tile with lv_tileview_set_tile(tileview, tile_obj, LV_ANIM_ON / OFF) or lv_tileview_set_tile_by_index(tileview, col_id, row_id, LV_ANIM_ON / OFF)


Tile 视图可以使用 lv_tileview_set_tile(tileview, tile_obj, LV_ANIM_ON / OFF) 或 lv_tileview_set_tile_by_index(tileview, col_id, row_id, LV_ANIM_ON / OFF) 滚动到图块

Events（事件）

显示原文

Keys（按键）

显示原文

Keys are not handled by the Tile view.

Learn more about Keys（按键）.


平铺视图不处理任何 按键。

了解有关 Keys（按键） 的更多信息。

Example

[English]

Tileview with content

C code  

 View on GitHub
#include "../../lv_examples.h"
#if LV_USE_TILEVIEW && LV_BUILD_EXAMPLES

/**
 * Create a 2x2 tile view and allow scrolling only in an "L" shape.
 * Demonstrate scroll chaining with a long list that
 * scrolls the tile view when it can't be scrolled further.
 */
void lv_example_tileview_1(void)
{
    lv_obj_t * tv = lv_tileview_create(lv_screen_active());

    /*Tile1: just a label*/
    lv_obj_t * tile1 = lv_tileview_add_tile(tv, 0, 0, LV_DIR_BOTTOM);
    lv_obj_t * label = lv_label_create(tile1);
    lv_label_set_text(label, "Scroll down");
    lv_obj_center(label);

    /*Tile2: a button*/
    lv_obj_t * tile2 = lv_tileview_add_tile(tv, 0, 1, LV_DIR_TOP | LV_DIR_RIGHT);

    lv_obj_t * btn = lv_button_create(tile2);

    label = lv_label_create(btn);
    lv_label_set_text(label, "Scroll up or right");

    lv_obj_set_size(btn, LV_SIZE_CONTENT, LV_SIZE_CONTENT);
    lv_obj_center(btn);

    /*Tile3: a list*/
    lv_obj_t * tile3 = lv_tileview_add_tile(tv, 1, 1, LV_DIR_LEFT);
    lv_obj_t * list = lv_list_create(tile3);
    lv_obj_set_size(list, LV_PCT(100), LV_PCT(100));

    lv_list_add_button(list, NULL, "One");
    lv_list_add_button(list, NULL, "Two");
    lv_list_add_button(list, NULL, "Three");
    lv_list_add_button(list, NULL, "Four");
    lv_list_add_button(list, NULL, "Five");
    lv_list_add_button(list, NULL, "Six");
    lv_list_add_button(list, NULL, "Seven");
    lv_list_add_button(list, NULL, "Eight");
    lv_list_add_button(list, NULL, "Nine");
    lv_list_add_button(list, NULL, "Ten");

}

#endif

API

lv_api_map_v8.h

lv_tileview.h