Table（表格） (lv_table)

Overview（概述）

显示原文

Tables are built from rows, columns, and cells containing text.

The Table Widget is very lightweight because only the text strings are stored. No real Widgets are created for cells --- they are just drawn on the fly.

The Table is added to the default group (if one is set). Table is an editable Widget, allow selecting a cell with encoder and keyboard navigation as well.

表格是由包含文本的行、列以及单元格构建而成的。

表格部件（Table Widget）非常轻巧，因为它只存储文本字符串。并不会为单元格创建真正的部件，它们只是即时绘制出来的。

表格会被添加到默认组（如果设置了默认组的话）。表格是一个可编辑的部件，允许使用编码器以及键盘导航来选择单元格。

Parts and Styles（部分和样式）

显示原文

LV_PART_MAIN The background of the Table; uses the typical background style properties.
LV_PART_ITEMS The cells of the Table also use the typical background style properties as well as text style properties.

LV_PART_MAIN：表格的背景部分；使用:ref:`typical background style properties <typical bg props>`（典型的背景样式属性，可参考对应引用内容）。
LV_PART_ITEMS：表格的单元格部分，同样使用 :ref:`typical background style properties <typical bg props>`（典型的背景样式属性）以及文本样式属性。

Usage（用法）

Set cell value（设置单元格的值）

显示原文

The cells can store only text so numbers need to be converted to text before displaying them in a table.

lv_table_set_cell_value(table, row, col, "Content"). The text is saved by the Table so the buffer containing the string can be a local variable.

Line breaks can be used in the text like "Value\n60.3".

New rows and columns are automatically added is required

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

lv_table_set_cell_value(table, row, col, "Content")。文本会由表格进行保存，所以包含该字符串的缓冲区可以是一个局部变量。

可以在文本中使用换行符，例如 "Value\n60.3"。

Rows and Columns（行和列）

显示原文

To explicitly set number of rows and columns use lv_table_set_row_count(table, row_cnt) and lv_table_set_column_count(table, col_cnt)

要明确设置行数和列数，请使用 lv_table_set_row_count(table, row_cnt) 和 lv_table_set_column_count(table, col_cnt)

Width and Height（宽度和高度）

显示原文

The width of the columns can be set with lv_table_set_column_width(table, col_id, width). The overall width of the Table Widget will be set to the sum of columns widths.

Height is calculated automatically from the cell styles (font, padding etc) and the number of rows.

列的宽度可以通过 lv_table_set_column_width(table, col_id, width) 设置。 Table 部件的总宽度将设置为列宽的总和。

高度会根据单元格样式（字体、内边距等）以及行数自动进行计算。

Merge cells（合并单元格）

显示原文

Cells can be merged horizontally with lv_table_add_cell_ctrl(table, row, col, LV_TABLE_CELL_CTRL_MERGE_RIGHT). To merge more adjacent cells call this function for each cell.

单元格可以使用 lv_table_add_cell_ctrl(table, row, col, LV_TABLE_CELL_CTRL_MERGE_RIGHT) 进行水平合并。要合并更多相邻单元格，请为每个单元格调用此函数。

Scrolling（滚动）

显示原文

If the label's width or height is set to LV_SIZE_CONTENT that size will be used to show the whole table in the respective direction. E.g. lv_obj_set_size(table, LV_SIZE_CONTENT, LV_SIZE_CONTENT) automatically sets the table size to show all the columns and rows.

If the width or height is set to a smaller number than the "intrinsic" size then the table becomes scrollable.

如果标签的宽度或高度设置为 LV_SIZE_CONTENT 则该尺寸将用于在相应方向上显示整个表格。例如。lv_obj_set_size(table, LV_SIZE_CONTENT, LV_SIZE_CONTENT) 自动设置表格大小以显示所有列和行。

如果宽度或高度设置为小于“固有”大小的数字，则表格变为可滚动的。

Events（事件）

显示原文

LV_EVENT_VALUE_CHANGED Sent when a new cell is selected with keys.

Keys（按键）

显示原文

The following Keys are processed by Table Widgets:

LV_KEY_RIGHT/LEFT/UP/DOWN/ Select a cell.

Note that, as usual, the state of LV_KEY_ENTER is translated to LV_EVENT_PRESSED/PRESSING/RELEASED etc.

lv_table_get_selected_cell(table, &row, &col) can be used to get the currently selected cell. Row and column will be set to LV_TABLE_CELL_NONE no cell is selected.

Learn more about Keys（按键）.

以下按键可由表格部件进行处理：