LVGL 表格

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

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

零件和样式

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

对于单元,有4个虚拟部分。每个单元格都有类型(1, 2, … 16),该类型指示要在其上应用哪个部分的样式。单元格部分可以由 LV_TABLE_PART_CELL1 + x 引用,其中 x0..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
赞(0)
未经允许不得转载:极客笔记 » LVGL 表格
分享到: 更多 (0)

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址