表格(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) 上

事件

仅支持 通用事件

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

按键处理

对象类型不处理任何键。

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

范例

简单的表格

http://photos.100ask.net/lvgl/04_widgets/30_table/01_lv_ex_table_1.png

简单的表格

上述效果的示例代码：

 1    #include "../../../lv_examples.h"
 2    #if LV_USE_TABLE
 3
 4    void lv_ex_table_1(void)
 5    {
 6            lv_obj_t * table = lv_table_create(lv_scr_act(), NULL);
 7            lv_table_set_col_cnt(table, 2);
 8            lv_table_set_row_cnt(table, 4);
 9            lv_obj_align(table, NULL, LV_ALIGN_CENTER, 0, 0);
10
11            /*Make the cells of the first row center aligned */
12            lv_table_set_cell_align(table, 0, 0, LV_LABEL_ALIGN_CENTER);
13            lv_table_set_cell_align(table, 0, 1, LV_LABEL_ALIGN_CENTER);
14
15            /*Align the price values to the right in the 2nd column*/
16            lv_table_set_cell_align(table, 1, 1, LV_LABEL_ALIGN_RIGHT);
17            lv_table_set_cell_align(table, 2, 1, LV_LABEL_ALIGN_RIGHT);
18            lv_table_set_cell_align(table, 3, 1, LV_LABEL_ALIGN_RIGHT);
19
20            lv_table_set_cell_type(table, 0, 0, 2);
21            lv_table_set_cell_type(table, 0, 1, 2);
22
23
24            /*Fill the first column*/
25            lv_table_set_cell_value(table, 0, 0, "Name");
26            lv_table_set_cell_value(table, 1, 0, "Apple");
27            lv_table_set_cell_value(table, 2, 0, "Banana");
28            lv_table_set_cell_value(table, 3, 0, "Citron");
29
30            /*Fill the second column*/
31            lv_table_set_cell_value(table, 0, 1, "Price");
32            lv_table_set_cell_value(table, 1, 1, "$7");
33            lv_table_set_cell_value(table, 2, 1, "$4");
34            lv_table_set_cell_value(table, 3, 1, "$6");
35
36            lv_table_ext_t * ext = lv_obj_get_ext_attr(table);
37            ext->row_h[0] = 20;
38    }
39
40    #endif

相关API

TODO