LVGL 表格|极客笔记

表格(lv_table)像往常一样，表格是从包含文本的行，列和单元格构建的。

表格对象的权重非常轻，因为仅存储了文本。没有为单元创建任何实际对象，但它们是动态绘制的。

零件和样式

表格的主要部分称为 LV_TABLE_PART_BG 。它是一个类似于背景的矩形，并使用所有典型的背景样式属性。

对于单元，有4个虚拟部分。每个单元格都有类型(1, 2, … 16)，该类型指示要在其上应用哪个部分的样式。单元格部分可以由 LV_TABLE_PART_CELL1 + x 引用，其中 x 在 0..15 之间。

可以在lv_conf.h中通过 LV_TABLE_CELL_STYLE_CNT 调整单元格类型的数量。默认情况下为4。默认的4种单元格类型部分也使用专用名称进行引用：

LV_TABLE_PART_CELL1
LV_TABLE_PART_CELL2
LV_TABLE_PART_CELL3
LV_TABLE_PART_CELL4

单元格还使用所有典型的背景样式属性。如果单元格内容中有换行符( \n )，则在换行符后将使用线条样式属性绘制水平分隔线。

单元格中的文本样式是从单元格部分或背景部分继承的。

用法

行(row)和列(column)

要设置行数和列数，请使用 lv_table_set_row_cnt(table, row_cnt) 和 lv_table_set_col_cnt(table, col_cnt)

宽度(width)和高度(height)

列的宽度可以使用 lv_table_set_col_width(table, col_id, width) 设置。 Table对象的总宽度将设置为列宽的总和。

高度是根据单元格样式（字体，填充等）和行数自动计算的。

设定单元格数值类型

单元格只能存储文本，因此在将数字显示在表格中之前，需要将数字转换为文本。

lv_table_set_cell_value(table, row, col, "Content") 。文本由表保存，因此它甚至可以是局部变量。

可以在 "Value\n60.3" 之类的文本中使用换行符。

对齐

可以使用 lv_table_set_cell_align(table, row, col, LV_LABEL_ALIGN_LEFT/CENTER/RIGHT) 调整单元格中的文本对齐方式。

单元格类型(cell_type)

可以使用4种不同的单元格类型。每个都有自己的风格。

单元格类型可用于添加不同的样式，例如：

表头
第一栏
突出显示一个单元格
等等

可以使用 lv_table_set_cell_type(table, row, col, type) 选择类型， 类型(type) 可以为1、2、3或4，对应上面的四种类型。

合并单元格

单元格可以与 lv_table_set_cell_merge_right(table, col, row, true) 水平合并。要合并更多相邻的单元格，请对每个单元格应用此功能。

裁剪文字

默认情况下，文字会自动换行以适合单元格的宽度，并且单元格的高度会自动设置。要禁用此功能并保持文本原样，请启用 lv_table_set_cell_crop(table, row, col, true) 。

滚动

使表格可滚动放置在页面(lv_page) 上

事件

仅支持通用事件

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

按键处理

对象类型不处理任何键。

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

范例

简单的表格

LVGL简单的表格

上述效果的示例代码：

#include "../../../lv_examples.h"
#if LV_USE_TABLE

void lv_ex_table_1(void)
{
    lv_obj_t * table = lv_table_create(lv_scr_act(), NULL);
    lv_table_set_col_cnt(table, 2);
    lv_table_set_row_cnt(table, 4);
    lv_obj_align(table, NULL, LV_ALIGN_CENTER, 0, 0);

    /*Make the cells of the first row center aligned */
    lv_table_set_cell_align(table, 0, 0, LV_LABEL_ALIGN_CENTER);
    lv_table_set_cell_align(table, 0, 1, LV_LABEL_ALIGN_CENTER);

    /*Align the price values to the right in the 2nd column*/
    lv_table_set_cell_align(table, 1, 1, LV_LABEL_ALIGN_RIGHT);
    lv_table_set_cell_align(table, 2, 1, LV_LABEL_ALIGN_RIGHT);
    lv_table_set_cell_align(table, 3, 1, LV_LABEL_ALIGN_RIGHT);

    lv_table_set_cell_type(table, 0, 0, 2);
    lv_table_set_cell_type(table, 0, 1, 2);

    /*Fill the first column*/
    lv_table_set_cell_value(table, 0, 0, "Name");
    lv_table_set_cell_value(table, 1, 0, "Apple");
    lv_table_set_cell_value(table, 2, 0, "Banana");
    lv_table_set_cell_value(table, 3, 0, "Citron");

    /*Fill the second column*/
    lv_table_set_cell_value(table, 0, 1, "Price");
    lv_table_set_cell_value(table, 1, 1, " $7"); lv_table_set_cell_value(table, 2, 1, "$ 4");
    lv_table_set_cell_value(table, 3, 1, "$6");

    lv_table_ext_t * ext = lv_obj_get_ext_attr(table);
    ext->row_h[0] = 20;
}

#endif