summaryrefslogtreecommitdiff
path: root/lib/lvgl/src/widgets/table
diff options
context:
space:
mode:
authorjacqueline <me@jacqueline.id.au>2024-06-12 17:54:40 +1000
committerjacqueline <me@jacqueline.id.au>2024-06-12 17:54:40 +1000
commit64bd9053a25297f7a442ca831c7da5b44bd33f84 (patch)
treea90c6cad25a12028302ab1a5334510fba0229bae /lib/lvgl/src/widgets/table
parent611176ed667c4ed7ee9f609e958f9404f4aee91d (diff)
downloadtangara-fw-64bd9053a25297f7a442ca831c7da5b44bd33f84.tar.gz
Update LVGL to v9.1.0
Diffstat (limited to 'lib/lvgl/src/widgets/table')
-rw-r--r--lib/lvgl/src/widgets/table/lv_table.c1094
-rw-r--r--lib/lvgl/src/widgets/table/lv_table.h231
2 files changed, 1325 insertions, 0 deletions
diff --git a/lib/lvgl/src/widgets/table/lv_table.c b/lib/lvgl/src/widgets/table/lv_table.c
new file mode 100644
index 00000000..c69494c3
--- /dev/null
+++ b/lib/lvgl/src/widgets/table/lv_table.c
@@ -0,0 +1,1094 @@
+/**
+ * @file lv_table.c
+ *
+ */
+
+/*********************
+ * INCLUDES
+ *********************/
+#include "lv_table.h"
+#if LV_USE_TABLE != 0
+
+#include "../../indev/lv_indev.h"
+#include "../../misc/lv_assert.h"
+#include "../../misc/lv_text.h"
+#include "../../misc/lv_text_ap.h"
+#include "../../misc/lv_math.h"
+#include "../../stdlib/lv_sprintf.h"
+#include "../../draw/lv_draw.h"
+#include "../../stdlib/lv_string.h"
+
+/*********************
+ * DEFINES
+ *********************/
+#define MY_CLASS (&lv_table_class)
+
+/**********************
+ * TYPEDEFS
+ **********************/
+
+/**********************
+ * STATIC PROTOTYPES
+ **********************/
+static void lv_table_constructor(const lv_obj_class_t * class_p, lv_obj_t * obj);
+static void lv_table_destructor(const lv_obj_class_t * class_p, lv_obj_t * obj);
+static void lv_table_event(const lv_obj_class_t * class_p, lv_event_t * e);
+static void draw_main(lv_event_t * e);
+static int32_t get_row_height(lv_obj_t * obj, uint32_t row_id, const lv_font_t * font,
+ int32_t letter_space, int32_t line_space,
+ int32_t cell_left, int32_t cell_right, int32_t cell_top, int32_t cell_bottom);
+static void refr_size_form_row(lv_obj_t * obj, uint32_t start_row);
+static void refr_cell_size(lv_obj_t * obj, uint32_t row, uint32_t col);
+static lv_result_t get_pressed_cell(lv_obj_t * obj, uint32_t * row, uint32_t * col);
+static size_t get_cell_txt_len(const char * txt);
+static void copy_cell_txt(lv_table_cell_t * dst, const char * txt);
+static void get_cell_area(lv_obj_t * obj, uint32_t row, uint32_t col, lv_area_t * area);
+static void scroll_to_selected_cell(lv_obj_t * obj);
+
+static inline bool is_cell_empty(void * cell)
+{
+ return cell == NULL;
+}
+
+/**********************
+ * STATIC VARIABLES
+ **********************/
+const lv_obj_class_t lv_table_class = {
+ .constructor_cb = lv_table_constructor,
+ .destructor_cb = lv_table_destructor,
+ .event_cb = lv_table_event,
+ .width_def = LV_SIZE_CONTENT,
+ .height_def = LV_SIZE_CONTENT,
+ .base_class = &lv_obj_class,
+ .editable = LV_OBJ_CLASS_EDITABLE_TRUE,
+ .group_def = LV_OBJ_CLASS_GROUP_DEF_TRUE,
+ .instance_size = sizeof(lv_table_t),
+ .name = "table",
+};
+/**********************
+ * MACROS
+ **********************/
+
+/**********************
+ * GLOBAL FUNCTIONS
+ **********************/
+
+lv_obj_t * lv_table_create(lv_obj_t * parent)
+{
+ LV_LOG_INFO("begin");
+ lv_obj_t * obj = lv_obj_class_create_obj(MY_CLASS, parent);
+ lv_obj_class_init_obj(obj);
+ return obj;
+}
+
+/*=====================
+ * Setter functions
+ *====================*/
+
+void lv_table_set_cell_value(lv_obj_t * obj, uint32_t row, uint32_t col, const char * txt)
+{
+ LV_ASSERT_OBJ(obj, MY_CLASS);
+ LV_ASSERT_NULL(txt);
+
+ lv_table_t * table = (lv_table_t *)obj;
+
+ /*Auto expand*/
+ if(col >= table->col_cnt) lv_table_set_column_count(obj, col + 1);
+ if(row >= table->row_cnt) lv_table_set_row_count(obj, row + 1);
+
+ uint32_t cell = row * table->col_cnt + col;
+ lv_table_cell_ctrl_t ctrl = 0;
+
+ /*Save the control byte*/
+ if(table->cell_data[cell]) ctrl = table->cell_data[cell]->ctrl;
+
+ void * user_data = NULL;
+
+ /*Save the user data*/
+ if(table->cell_data[cell]) user_data = table->cell_data[cell]->user_data;
+
+ size_t to_allocate = get_cell_txt_len(txt);
+
+ table->cell_data[cell] = lv_realloc(table->cell_data[cell], to_allocate);
+ LV_ASSERT_MALLOC(table->cell_data[cell]);
+ if(table->cell_data[cell] == NULL) return;
+
+ copy_cell_txt(table->cell_data[cell], txt);
+
+ table->cell_data[cell]->ctrl = ctrl;
+ table->cell_data[cell]->user_data = user_data;
+ refr_cell_size(obj, row, col);
+}
+
+void lv_table_set_cell_value_fmt(lv_obj_t * obj, uint32_t row, uint32_t col, const char * fmt, ...)
+{
+ LV_ASSERT_OBJ(obj, MY_CLASS);
+ LV_ASSERT_NULL(fmt);
+
+ lv_table_t * table = (lv_table_t *)obj;
+ if(col >= table->col_cnt) {
+ lv_table_set_column_count(obj, col + 1);
+ }
+
+ /*Auto expand*/
+ if(row >= table->row_cnt) {
+ lv_table_set_row_count(obj, row + 1);
+ }
+
+ uint32_t cell = row * table->col_cnt + col;
+ lv_table_cell_ctrl_t ctrl = 0;
+
+ /*Save the control byte*/
+ if(table->cell_data[cell]) ctrl = table->cell_data[cell]->ctrl;
+
+ void * user_data = NULL;
+
+ /*Save the user_data*/
+ if(table->cell_data[cell]) user_data = table->cell_data[cell]->user_data;
+
+ va_list ap, ap2;
+ va_start(ap, fmt);
+ va_copy(ap2, ap);
+
+ /*Allocate space for the new text by using trick from C99 standard section 7.19.6.12*/
+ uint32_t len = lv_vsnprintf(NULL, 0, fmt, ap);
+ va_end(ap);
+
+#if LV_USE_ARABIC_PERSIAN_CHARS
+ /*Put together the text according to the format string*/
+ char * raw_txt = lv_malloc(len + 1);
+ LV_ASSERT_MALLOC(raw_txt);
+ if(raw_txt == NULL) {
+ va_end(ap2);
+ return;
+ }
+
+ lv_vsnprintf(raw_txt, len + 1, fmt, ap2);
+
+ /*Get the size of the Arabic text and process it*/
+ size_t len_ap = _lv_text_ap_calc_bytes_count(raw_txt);
+ table->cell_data[cell] = lv_realloc(table->cell_data[cell], sizeof(lv_table_cell_t) + len_ap + 1);
+ LV_ASSERT_MALLOC(table->cell_data[cell]);
+ if(table->cell_data[cell] == NULL) {
+ va_end(ap2);
+ return;
+ }
+ _lv_text_ap_proc(raw_txt, table->cell_data[cell]->txt);
+
+ lv_free(raw_txt);
+#else
+ table->cell_data[cell] = lv_realloc(table->cell_data[cell],
+ sizeof(lv_table_cell_t) + len + 1); /*+1: trailing '\0; */
+ LV_ASSERT_MALLOC(table->cell_data[cell]);
+ if(table->cell_data[cell] == NULL) {
+ va_end(ap2);
+ return;
+ }
+
+ table->cell_data[cell]->txt[len] = 0; /*Ensure NULL termination*/
+
+ lv_vsnprintf(table->cell_data[cell]->txt, len + 1, fmt, ap2);
+#endif
+
+ va_end(ap2);
+
+ table->cell_data[cell]->ctrl = ctrl;
+ table->cell_data[cell]->user_data = user_data;
+ refr_cell_size(obj, row, col);
+}
+
+void lv_table_set_row_count(lv_obj_t * obj, uint32_t row_cnt)
+{
+ LV_ASSERT_OBJ(obj, MY_CLASS);
+
+ lv_table_t * table = (lv_table_t *)obj;
+
+ if(table->row_cnt == row_cnt) return;
+
+ uint32_t old_row_cnt = table->row_cnt;
+ table->row_cnt = row_cnt;
+
+ table->row_h = lv_realloc(table->row_h, table->row_cnt * sizeof(table->row_h[0]));
+ LV_ASSERT_MALLOC(table->row_h);
+ if(table->row_h == NULL) return;
+
+ /*Free the unused cells*/
+ if(old_row_cnt > row_cnt) {
+ uint32_t old_cell_cnt = old_row_cnt * table->col_cnt;
+ uint32_t new_cell_cnt = table->col_cnt * table->row_cnt;
+ uint32_t i;
+ for(i = new_cell_cnt; i < old_cell_cnt; i++) {
+ if(table->cell_data[i] && table->cell_data[i]->user_data) {
+ lv_free(table->cell_data[i]->user_data);
+ table->cell_data[i]->user_data = NULL;
+ }
+ lv_free(table->cell_data[i]);
+ }
+ }
+
+ table->cell_data = lv_realloc(table->cell_data, table->row_cnt * table->col_cnt * sizeof(lv_table_cell_t *));
+ LV_ASSERT_MALLOC(table->cell_data);
+ if(table->cell_data == NULL) return;
+
+ /*Initialize the new fields*/
+ if(old_row_cnt < row_cnt) {
+ uint32_t old_cell_cnt = old_row_cnt * table->col_cnt;
+ uint32_t new_cell_cnt = table->col_cnt * table->row_cnt;
+ lv_memzero(&table->cell_data[old_cell_cnt], (new_cell_cnt - old_cell_cnt) * sizeof(table->cell_data[0]));
+ }
+
+ refr_size_form_row(obj, 0);
+}
+
+void lv_table_set_column_count(lv_obj_t * obj, uint32_t col_cnt)
+{
+ LV_ASSERT_OBJ(obj, MY_CLASS);
+
+ lv_table_t * table = (lv_table_t *)obj;
+
+ if(table->col_cnt == col_cnt) return;
+
+ uint32_t old_col_cnt = table->col_cnt;
+ table->col_cnt = col_cnt;
+
+ lv_table_cell_t ** new_cell_data = lv_malloc(table->row_cnt * table->col_cnt * sizeof(lv_table_cell_t *));
+ LV_ASSERT_MALLOC(new_cell_data);
+ if(new_cell_data == NULL) return;
+ uint32_t new_cell_cnt = table->col_cnt * table->row_cnt;
+
+ lv_memzero(new_cell_data, new_cell_cnt * sizeof(table->cell_data[0]));
+
+ /*The new column(s) messes up the mapping of `cell_data`*/
+ uint32_t old_col_start;
+ uint32_t new_col_start;
+ uint32_t min_col_cnt = LV_MIN(old_col_cnt, col_cnt);
+ uint32_t row;
+ for(row = 0; row < table->row_cnt; row++) {
+ old_col_start = row * old_col_cnt;
+ new_col_start = row * col_cnt;
+
+ lv_memcpy(&new_cell_data[new_col_start], &table->cell_data[old_col_start],
+ sizeof(new_cell_data[0]) * min_col_cnt);
+
+ /*Free the old cells (only if the table becomes smaller)*/
+ int32_t i;
+ for(i = 0; i < (int32_t)old_col_cnt - (int32_t)col_cnt; i++) {
+ uint32_t idx = old_col_start + min_col_cnt + i;
+ if(table->cell_data[idx]->user_data) {
+ lv_free(table->cell_data[idx]->user_data);
+ table->cell_data[idx]->user_data = NULL;
+ }
+ lv_free(table->cell_data[idx]);
+ table->cell_data[idx] = NULL;
+ }
+ }
+
+ lv_free(table->cell_data);
+ table->cell_data = new_cell_data;
+
+ /*Initialize the new column widths if any*/
+ table->col_w = lv_realloc(table->col_w, col_cnt * sizeof(table->col_w[0]));
+ LV_ASSERT_MALLOC(table->col_w);
+ if(table->col_w == NULL) return;
+
+ uint32_t col;
+ for(col = old_col_cnt; col < col_cnt; col++) {
+ table->col_w[col] = LV_DPI_DEF;
+ }
+
+ refr_size_form_row(obj, 0) ;
+}
+
+void lv_table_set_column_width(lv_obj_t * obj, uint32_t col_id, int32_t w)
+{
+ LV_ASSERT_OBJ(obj, MY_CLASS);
+
+ lv_table_t * table = (lv_table_t *)obj;
+
+ /*Auto expand*/
+ if(col_id >= table->col_cnt) lv_table_set_column_count(obj, col_id + 1);
+
+ table->col_w[col_id] = w;
+ refr_size_form_row(obj, 0);
+}
+
+void lv_table_add_cell_ctrl(lv_obj_t * obj, uint32_t row, uint32_t col, lv_table_cell_ctrl_t ctrl)
+{
+ LV_ASSERT_OBJ(obj, MY_CLASS);
+
+ lv_table_t * table = (lv_table_t *)obj;
+
+ /*Auto expand*/
+ if(col >= table->col_cnt) lv_table_set_column_count(obj, col + 1);
+ if(row >= table->row_cnt) lv_table_set_row_count(obj, row + 1);
+
+ uint32_t cell = row * table->col_cnt + col;
+
+ if(is_cell_empty(table->cell_data[cell])) {
+ table->cell_data[cell] = lv_malloc(sizeof(lv_table_cell_t) + 1); /*+1: trailing '\0 */
+ LV_ASSERT_MALLOC(table->cell_data[cell]);
+ if(table->cell_data[cell] == NULL) return;
+
+ table->cell_data[cell]->ctrl = 0;
+ table->cell_data[cell]->user_data = NULL;
+ table->cell_data[cell]->txt[0] = '\0';
+ }
+
+ table->cell_data[cell]->ctrl |= ctrl;
+}
+
+void lv_table_clear_cell_ctrl(lv_obj_t * obj, uint32_t row, uint32_t col, lv_table_cell_ctrl_t ctrl)
+{
+ LV_ASSERT_OBJ(obj, MY_CLASS);
+
+ lv_table_t * table = (lv_table_t *)obj;
+
+ /*Auto expand*/
+ if(col >= table->col_cnt) lv_table_set_column_count(obj, col + 1);
+ if(row >= table->row_cnt) lv_table_set_row_count(obj, row + 1);
+
+ uint32_t cell = row * table->col_cnt + col;
+
+ if(is_cell_empty(table->cell_data[cell])) {
+ table->cell_data[cell] = lv_malloc(sizeof(lv_table_cell_t) + 1); /*+1: trailing '\0 */
+ LV_ASSERT_MALLOC(table->cell_data[cell]);
+ if(table->cell_data[cell] == NULL) return;
+
+ table->cell_data[cell]->ctrl = 0;
+ table->cell_data[cell]->user_data = NULL;
+ table->cell_data[cell]->txt[0] = '\0';
+ }
+
+ table->cell_data[cell]->ctrl &= (~ctrl);
+}
+
+void lv_table_set_cell_user_data(lv_obj_t * obj, uint16_t row, uint16_t col, void * user_data)
+{
+ LV_ASSERT_OBJ(obj, MY_CLASS);
+
+ lv_table_t * table = (lv_table_t *)obj;
+
+ /*Auto expand*/
+ if(col >= table->col_cnt) lv_table_set_column_count(obj, col + 1);
+ if(row >= table->row_cnt) lv_table_set_row_count(obj, row + 1);
+
+ uint32_t cell = row * table->col_cnt + col;
+
+ if(is_cell_empty(table->cell_data[cell])) {
+ table->cell_data[cell] = lv_malloc(sizeof(lv_table_cell_t) + 1); /*+1: trailing '\0 */
+ LV_ASSERT_MALLOC(table->cell_data[cell]);
+ if(table->cell_data[cell] == NULL) return;
+
+ table->cell_data[cell]->ctrl = 0;
+ table->cell_data[cell]->user_data = NULL;
+ table->cell_data[cell]->txt[0] = '\0';
+ }
+
+ if(table->cell_data[cell]->user_data) {
+ lv_free(table->cell_data[cell]->user_data);
+ }
+
+ table->cell_data[cell]->user_data = user_data;
+}
+
+/*=====================
+ * Getter functions
+ *====================*/
+
+const char * lv_table_get_cell_value(lv_obj_t * obj, uint32_t row, uint32_t col)
+{
+ LV_ASSERT_OBJ(obj, MY_CLASS);
+
+ lv_table_t * table = (lv_table_t *)obj;
+ if(row >= table->row_cnt || col >= table->col_cnt) {
+ LV_LOG_WARN("invalid row or column");
+ return "";
+ }
+ uint32_t cell = row * table->col_cnt + col;
+
+ if(is_cell_empty(table->cell_data[cell])) return "";
+
+ return table->cell_data[cell]->txt;
+}
+
+uint32_t lv_table_get_row_count(lv_obj_t * obj)
+{
+ LV_ASSERT_OBJ(obj, MY_CLASS);
+
+ lv_table_t * table = (lv_table_t *)obj;
+ return table->row_cnt;
+}
+
+uint32_t lv_table_get_column_count(lv_obj_t * obj)
+{
+ LV_ASSERT_OBJ(obj, MY_CLASS);
+
+ lv_table_t * table = (lv_table_t *)obj;
+ return table->col_cnt;
+}
+
+int32_t lv_table_get_column_width(lv_obj_t * obj, uint32_t col)
+{
+ LV_ASSERT_OBJ(obj, MY_CLASS);
+
+ lv_table_t * table = (lv_table_t *)obj;
+
+ if(col >= table->col_cnt) {
+ LV_LOG_WARN("too big 'col_id'. Must be < LV_TABLE_COL_MAX.");
+ return 0;
+ }
+
+ return table->col_w[col];
+}
+
+bool lv_table_has_cell_ctrl(lv_obj_t * obj, uint32_t row, uint32_t col, lv_table_cell_ctrl_t ctrl)
+{
+ LV_ASSERT_OBJ(obj, MY_CLASS);
+
+ lv_table_t * table = (lv_table_t *)obj;
+ if(row >= table->row_cnt || col >= table->col_cnt) {
+ LV_LOG_WARN("invalid row or column");
+ return false;
+ }
+ uint32_t cell = row * table->col_cnt + col;
+
+ if(is_cell_empty(table->cell_data[cell])) return false;
+ else return (table->cell_data[cell]->ctrl & ctrl) == ctrl;
+}
+
+void lv_table_get_selected_cell(lv_obj_t * obj, uint32_t * row, uint32_t * col)
+{
+ lv_table_t * table = (lv_table_t *)obj;
+ *row = table->row_act;
+ *col = table->col_act;
+}
+
+void * lv_table_get_cell_user_data(lv_obj_t * obj, uint16_t row, uint16_t col)
+{
+ LV_ASSERT_OBJ(obj, MY_CLASS);
+
+ lv_table_t * table = (lv_table_t *)obj;
+ if(row >= table->row_cnt || col >= table->col_cnt) {
+ LV_LOG_WARN("invalid row or column");
+ return NULL;
+ }
+ uint32_t cell = row * table->col_cnt + col;
+
+ if(is_cell_empty(table->cell_data[cell])) return NULL;
+
+ return table->cell_data[cell]->user_data;
+}
+
+/**********************
+ * STATIC FUNCTIONS
+ **********************/
+
+static void lv_table_constructor(const lv_obj_class_t * class_p, lv_obj_t * obj)
+{
+ LV_UNUSED(class_p);
+ LV_TRACE_OBJ_CREATE("begin");
+
+ lv_table_t * table = (lv_table_t *)obj;
+
+ table->col_cnt = 1;
+ table->row_cnt = 1;
+ table->col_w = lv_malloc(table->col_cnt * sizeof(table->col_w[0]));
+ table->row_h = lv_malloc(table->row_cnt * sizeof(table->row_h[0]));
+ table->col_w[0] = LV_DPI_DEF;
+ table->row_h[0] = LV_DPI_DEF;
+ table->cell_data = lv_realloc(table->cell_data, table->row_cnt * table->col_cnt * sizeof(lv_table_cell_t *));
+ table->cell_data[0] = NULL;
+
+ LV_TRACE_OBJ_CREATE("finished");
+}
+
+static void lv_table_destructor(const lv_obj_class_t * class_p, lv_obj_t * obj)
+{
+ LV_UNUSED(class_p);
+ lv_table_t * table = (lv_table_t *)obj;
+ /*Free the cell texts*/
+ uint32_t i;
+ for(i = 0; i < table->col_cnt * table->row_cnt; i++) {
+ if(table->cell_data[i]) {
+ if(table->cell_data[i]->user_data) {
+ lv_free(table->cell_data[i]->user_data);
+ table->cell_data[i]->user_data = NULL;
+ }
+ lv_free(table->cell_data[i]);
+ table->cell_data[i] = NULL;
+ }
+ }
+
+ if(table->cell_data) lv_free(table->cell_data);
+ if(table->row_h) lv_free(table->row_h);
+ if(table->col_w) lv_free(table->col_w);
+}
+
+static void lv_table_event(const lv_obj_class_t * class_p, lv_event_t * e)
+{
+ LV_UNUSED(class_p);
+
+ lv_result_t res;
+
+ /*Call the ancestor's event handler*/
+ res = lv_obj_event_base(MY_CLASS, e);
+ if(res != LV_RESULT_OK) return;
+
+ lv_event_code_t code = lv_event_get_code(e);
+ lv_obj_t * obj = lv_event_get_current_target(e);
+ lv_table_t * table = (lv_table_t *)obj;
+
+ if(code == LV_EVENT_STYLE_CHANGED) {
+ refr_size_form_row(obj, 0);
+ }
+ else if(code == LV_EVENT_GET_SELF_SIZE) {
+ lv_point_t * p = lv_event_get_param(e);
+ uint32_t i;
+ int32_t w = 0;
+ for(i = 0; i < table->col_cnt; i++) w += table->col_w[i];
+
+ int32_t h = 0;
+ for(i = 0; i < table->row_cnt; i++) h += table->row_h[i];
+
+ p->x = w - 1;
+ p->y = h - 1;
+ }
+ else if(code == LV_EVENT_PRESSED || code == LV_EVENT_PRESSING) {
+ uint32_t col;
+ uint32_t row;
+ lv_result_t pr_res = get_pressed_cell(obj, &row, &col);
+
+ if(pr_res == LV_RESULT_OK && (table->col_act != col || table->row_act != row)) {
+ table->col_act = col;
+ table->row_act = row;
+ lv_obj_invalidate(obj);
+ }
+ }
+ else if(code == LV_EVENT_RELEASED) {
+ lv_obj_invalidate(obj);
+ lv_indev_t * indev = lv_indev_active();
+ lv_obj_t * scroll_obj = lv_indev_get_scroll_obj(indev);
+ if(table->col_act != LV_TABLE_CELL_NONE && table->row_act != LV_TABLE_CELL_NONE && scroll_obj == NULL) {
+ res = lv_obj_send_event(obj, LV_EVENT_VALUE_CHANGED, NULL);
+ if(res != LV_RESULT_OK) return;
+ }
+
+ lv_indev_type_t indev_type = lv_indev_get_type(lv_indev_active());
+ if(indev_type == LV_INDEV_TYPE_POINTER || indev_type == LV_INDEV_TYPE_BUTTON) {
+ table->col_act = LV_TABLE_CELL_NONE;
+ table->row_act = LV_TABLE_CELL_NONE;
+ }
+ }
+ else if(code == LV_EVENT_FOCUSED) {
+ lv_obj_invalidate(obj);
+ }
+ else if(code == LV_EVENT_KEY) {
+ int32_t c = *((int32_t *)lv_event_get_param(e));
+ int32_t col = table->col_act;
+ int32_t row = table->row_act;
+ if(col == LV_TABLE_CELL_NONE || row == LV_TABLE_CELL_NONE) {
+ table->col_act = 0;
+ table->row_act = 0;
+ scroll_to_selected_cell(obj);
+ lv_obj_invalidate(obj);
+ return;
+ }
+
+ if(col >= (int32_t)table->col_cnt) col = 0;
+ if(row >= (int32_t)table->row_cnt) row = 0;
+
+ if(c == LV_KEY_LEFT) col--;
+ else if(c == LV_KEY_RIGHT) col++;
+ else if(c == LV_KEY_UP) row--;
+ else if(c == LV_KEY_DOWN) row++;
+ else return;
+
+ if(col >= (int32_t)table->col_cnt) {
+ if(row < (int32_t)table->row_cnt - 1) {
+ col = 0;
+ row++;
+ }
+ else {
+ col = table->col_cnt - 1;
+ }
+ }
+ else if(col < 0) {
+ if(row != 0) {
+ col = table->col_cnt - 1;
+ row--;
+ }
+ else {
+ col = 0;
+ }
+ }
+
+ if(row >= (int32_t)table->row_cnt) {
+ row = table->row_cnt - 1;
+ }
+ else if(row < 0) {
+ row = 0;
+ }
+
+ if((int32_t)table->col_act != col || (int32_t)table->row_act != row) {
+ table->col_act = col;
+ table->row_act = row;
+ lv_obj_invalidate(obj);
+
+ scroll_to_selected_cell(obj);
+ res = lv_obj_send_event(obj, LV_EVENT_VALUE_CHANGED, NULL);
+
+ if(res != LV_RESULT_OK) return;
+ }
+ }
+ else if(code == LV_EVENT_DRAW_MAIN) {
+ draw_main(e);
+ }
+}
+
+static void draw_main(lv_event_t * e)
+{
+ lv_obj_t * obj = lv_event_get_current_target(e);
+ lv_table_t * table = (lv_table_t *)obj;
+ lv_layer_t * layer = lv_event_get_layer(e);
+ lv_area_t clip_area;
+ if(!_lv_area_intersect(&clip_area, &obj->coords, &layer->_clip_area)) return;
+
+ const lv_area_t clip_area_ori = layer->_clip_area;
+ layer->_clip_area = clip_area;
+
+ lv_point_t txt_size;
+ lv_area_t cell_area;
+
+ int32_t border_width = lv_obj_get_style_border_width(obj, LV_PART_MAIN);
+ int32_t bg_top = lv_obj_get_style_pad_top(obj, LV_PART_MAIN);
+ int32_t bg_bottom = lv_obj_get_style_pad_bottom(obj, LV_PART_MAIN);
+ int32_t bg_left = lv_obj_get_style_pad_left(obj, LV_PART_MAIN);
+ int32_t bg_right = lv_obj_get_style_pad_right(obj, LV_PART_MAIN);
+
+ lv_state_t state_ori = obj->state;
+ obj->state = LV_STATE_DEFAULT;
+ obj->skip_trans = 1;
+ lv_draw_rect_dsc_t rect_dsc_def;
+ lv_draw_rect_dsc_t rect_dsc_act; /*Passed to the event to modify it*/
+ lv_draw_rect_dsc_init(&rect_dsc_def);
+ lv_obj_init_draw_rect_dsc(obj, LV_PART_ITEMS, &rect_dsc_def);
+
+ lv_draw_label_dsc_t label_dsc_def;
+ lv_draw_label_dsc_t label_dsc_act; /*Passed to the event to modify it*/
+ lv_draw_label_dsc_init(&label_dsc_def);
+ lv_obj_init_draw_label_dsc(obj, LV_PART_ITEMS, &label_dsc_def);
+ obj->state = state_ori;
+ obj->skip_trans = 0;
+
+ uint32_t col;
+ uint32_t row;
+ uint32_t cell = 0;
+
+ cell_area.y2 = obj->coords.y1 + bg_top - 1 - lv_obj_get_scroll_y(obj) + border_width;
+ cell_area.x1 = 0;
+ cell_area.x2 = 0;
+ int32_t scroll_x = lv_obj_get_scroll_x(obj) ;
+ bool rtl = lv_obj_get_style_base_dir(obj, LV_PART_MAIN) == LV_BASE_DIR_RTL;
+
+ /*Handle custom drawer*/
+ for(row = 0; row < table->row_cnt; row++) {
+ int32_t h_row = table->row_h[row];
+
+ cell_area.y1 = cell_area.y2 + 1;
+ cell_area.y2 = cell_area.y1 + h_row - 1;
+
+ if(cell_area.y1 > clip_area.y2) break;
+
+ if(rtl) cell_area.x1 = obj->coords.x2 - bg_right - 1 - scroll_x - border_width;
+ else cell_area.x2 = obj->coords.x1 + bg_left - 1 - scroll_x + border_width;
+
+ for(col = 0; col < table->col_cnt; col++) {
+ lv_table_cell_ctrl_t ctrl = 0;
+ if(table->cell_data[cell]) ctrl = table->cell_data[cell]->ctrl;
+
+ if(rtl) {
+ cell_area.x2 = cell_area.x1 - 1;
+ cell_area.x1 = cell_area.x2 - table->col_w[col] + 1;
+ }
+ else {
+ cell_area.x1 = cell_area.x2 + 1;
+ cell_area.x2 = cell_area.x1 + table->col_w[col] - 1;
+ }
+
+ uint32_t col_merge = 0;
+ for(col_merge = 0; col_merge + col < table->col_cnt - 1; col_merge++) {
+ lv_table_cell_t * next_cell_data = table->cell_data[cell + col_merge];
+
+ if(is_cell_empty(next_cell_data)) break;
+
+ lv_table_cell_ctrl_t merge_ctrl = (lv_table_cell_ctrl_t) next_cell_data->ctrl;
+ if(merge_ctrl & LV_TABLE_CELL_CTRL_MERGE_RIGHT) {
+ int32_t offset = table->col_w[col + col_merge + 1];
+
+ if(rtl) cell_area.x1 -= offset;
+ else cell_area.x2 += offset;
+ }
+ else {
+ break;
+ }
+ }
+
+ if(cell_area.y2 < clip_area.y1) {
+ cell += col_merge + 1;
+ col += col_merge;
+ continue;
+ }
+
+ /*Expand the cell area with a half border to avoid drawing 2 borders next to each other*/
+ lv_area_t cell_area_border;
+ lv_area_copy(&cell_area_border, &cell_area);
+ if((rect_dsc_def.border_side & LV_BORDER_SIDE_LEFT) && cell_area_border.x1 > obj->coords.x1 + bg_left) {
+ cell_area_border.x1 -= rect_dsc_def.border_width / 2;
+ }
+ if((rect_dsc_def.border_side & LV_BORDER_SIDE_TOP) && cell_area_border.y1 > obj->coords.y1 + bg_top) {
+ cell_area_border.y1 -= rect_dsc_def.border_width / 2;
+ }
+ if((rect_dsc_def.border_side & LV_BORDER_SIDE_RIGHT) && cell_area_border.x2 < obj->coords.x2 - bg_right - 1) {
+ cell_area_border.x2 += rect_dsc_def.border_width / 2 + (rect_dsc_def.border_width & 0x1);
+ }
+ if((rect_dsc_def.border_side & LV_BORDER_SIDE_BOTTOM) &&
+ cell_area_border.y2 < obj->coords.y2 - bg_bottom - 1) {
+ cell_area_border.y2 += rect_dsc_def.border_width / 2 + (rect_dsc_def.border_width & 0x1);
+ }
+
+ lv_state_t cell_state = LV_STATE_DEFAULT;
+ if(row == table->row_act && col == table->col_act) {
+ if(!(obj->state & LV_STATE_SCROLLED) && (obj->state & LV_STATE_PRESSED)) cell_state |= LV_STATE_PRESSED;
+ if(obj->state & LV_STATE_FOCUSED) cell_state |= LV_STATE_FOCUSED;
+ if(obj->state & LV_STATE_FOCUS_KEY) cell_state |= LV_STATE_FOCUS_KEY;
+ if(obj->state & LV_STATE_EDITED) cell_state |= LV_STATE_EDITED;
+ }
+
+ /*Set up the draw descriptors*/
+ if(cell_state == LV_STATE_DEFAULT) {
+ lv_memcpy(&rect_dsc_act, &rect_dsc_def, sizeof(lv_draw_rect_dsc_t));
+ lv_memcpy(&label_dsc_act, &label_dsc_def, sizeof(lv_draw_label_dsc_t));
+ }
+ /*In other cases get the styles directly without caching them*/
+ else {
+ obj->state = cell_state;
+ obj->skip_trans = 1;
+ lv_draw_rect_dsc_init(&rect_dsc_act);
+ lv_draw_label_dsc_init(&label_dsc_act);
+ lv_obj_init_draw_rect_dsc(obj, LV_PART_ITEMS, &rect_dsc_act);
+ lv_obj_init_draw_label_dsc(obj, LV_PART_ITEMS, &label_dsc_act);
+ obj->state = state_ori;
+ obj->skip_trans = 0;
+ }
+
+ rect_dsc_act.base.id1 = row;
+ rect_dsc_act.base.id2 = col;
+ label_dsc_act.base.id1 = row;
+ label_dsc_act.base.id2 = col;
+
+ lv_draw_rect(layer, &rect_dsc_act, &cell_area_border);
+
+ if(table->cell_data[cell]) {
+ const int32_t cell_left = lv_obj_get_style_pad_left(obj, LV_PART_ITEMS);
+ const int32_t cell_right = lv_obj_get_style_pad_right(obj, LV_PART_ITEMS);
+ const int32_t cell_top = lv_obj_get_style_pad_top(obj, LV_PART_ITEMS);
+ const int32_t cell_bottom = lv_obj_get_style_pad_bottom(obj, LV_PART_ITEMS);
+ lv_text_flag_t txt_flags = LV_TEXT_FLAG_NONE;
+ lv_area_t txt_area;
+
+ txt_area.x1 = cell_area.x1 + cell_left;
+ txt_area.x2 = cell_area.x2 - cell_right;
+ txt_area.y1 = cell_area.y1 + cell_top;
+ txt_area.y2 = cell_area.y2 - cell_bottom;
+
+ /*Align the content to the middle if not cropped*/
+ bool crop = ctrl & LV_TABLE_CELL_CTRL_TEXT_CROP;
+ if(crop) txt_flags = LV_TEXT_FLAG_EXPAND;
+
+ lv_text_get_size(&txt_size, table->cell_data[cell]->txt, label_dsc_def.font,
+ label_dsc_act.letter_space, label_dsc_act.line_space,
+ lv_area_get_width(&txt_area), txt_flags);
+
+ /*Align the content to the middle if not cropped*/
+ if(!crop) {
+ txt_area.y1 = cell_area.y1 + h_row / 2 - txt_size.y / 2;
+ txt_area.y2 = cell_area.y1 + h_row / 2 + txt_size.y / 2;
+ }
+
+ lv_area_t label_clip_area;
+ bool label_mask_ok;
+ label_mask_ok = _lv_area_intersect(&label_clip_area, &clip_area, &cell_area);
+ if(label_mask_ok) {
+ layer->_clip_area = label_clip_area;
+ label_dsc_act.text = table->cell_data[cell]->txt;
+ lv_draw_label(layer, &label_dsc_act, &txt_area);
+ layer->_clip_area = clip_area;
+ }
+ }
+
+ cell += col_merge + 1;
+ col += col_merge;
+ }
+ }
+
+ layer->_clip_area = clip_area_ori;
+}
+
+/* Refreshes size of the table starting from @start_row row */
+static void refr_size_form_row(lv_obj_t * obj, uint32_t start_row)
+{
+ const int32_t cell_pad_left = lv_obj_get_style_pad_left(obj, LV_PART_ITEMS);
+ const int32_t cell_pad_right = lv_obj_get_style_pad_right(obj, LV_PART_ITEMS);
+ const int32_t cell_pad_top = lv_obj_get_style_pad_top(obj, LV_PART_ITEMS);
+ const int32_t cell_pad_bottom = lv_obj_get_style_pad_bottom(obj, LV_PART_ITEMS);
+
+ int32_t letter_space = lv_obj_get_style_text_letter_space(obj, LV_PART_ITEMS);
+ int32_t line_space = lv_obj_get_style_text_line_space(obj, LV_PART_ITEMS);
+ const lv_font_t * font = lv_obj_get_style_text_font(obj, LV_PART_ITEMS);
+
+ const int32_t minh = lv_obj_get_style_min_height(obj, LV_PART_ITEMS);
+ const int32_t maxh = lv_obj_get_style_max_height(obj, LV_PART_ITEMS);
+
+ lv_table_t * table = (lv_table_t *)obj;
+ uint32_t i;
+ for(i = start_row; i < table->row_cnt; i++) {
+ int32_t calculated_height = get_row_height(obj, i, font, letter_space, line_space,
+ cell_pad_left, cell_pad_right, cell_pad_top, cell_pad_bottom);
+ table->row_h[i] = LV_CLAMP(minh, calculated_height, maxh);
+ }
+
+ lv_obj_refresh_self_size(obj);
+ lv_obj_invalidate(obj);
+}
+
+static void refr_cell_size(lv_obj_t * obj, uint32_t row, uint32_t col)
+{
+ const int32_t cell_pad_left = lv_obj_get_style_pad_left(obj, LV_PART_ITEMS);
+ const int32_t cell_pad_right = lv_obj_get_style_pad_right(obj, LV_PART_ITEMS);
+ const int32_t cell_pad_top = lv_obj_get_style_pad_top(obj, LV_PART_ITEMS);
+ const int32_t cell_pad_bottom = lv_obj_get_style_pad_bottom(obj, LV_PART_ITEMS);
+
+ int32_t letter_space = lv_obj_get_style_text_letter_space(obj, LV_PART_ITEMS);
+ int32_t line_space = lv_obj_get_style_text_line_space(obj, LV_PART_ITEMS);
+ const lv_font_t * font = lv_obj_get_style_text_font(obj, LV_PART_ITEMS);
+
+ const int32_t minh = lv_obj_get_style_min_height(obj, LV_PART_ITEMS);
+ const int32_t maxh = lv_obj_get_style_max_height(obj, LV_PART_ITEMS);
+
+ lv_table_t * table = (lv_table_t *)obj;
+ int32_t calculated_height = get_row_height(obj, row, font, letter_space, line_space,
+ cell_pad_left, cell_pad_right, cell_pad_top, cell_pad_bottom);
+
+ int32_t prev_row_size = table->row_h[row];
+ table->row_h[row] = LV_CLAMP(minh, calculated_height, maxh);
+
+ /*If the row height haven't changed invalidate only this cell*/
+ if(prev_row_size == table->row_h[row]) {
+ lv_area_t cell_area;
+ get_cell_area(obj, row, col, &cell_area);
+ lv_area_move(&cell_area, obj->coords.x1, obj->coords.y1);
+ lv_obj_invalidate_area(obj, &cell_area);
+ }
+ else {
+ lv_obj_refresh_self_size(obj);
+ lv_obj_invalidate(obj);
+ }
+}
+
+static int32_t get_row_height(lv_obj_t * obj, uint32_t row_id, const lv_font_t * font,
+ int32_t letter_space, int32_t line_space,
+ int32_t cell_left, int32_t cell_right, int32_t cell_top, int32_t cell_bottom)
+{
+ lv_table_t * table = (lv_table_t *)obj;
+
+ int32_t h_max = lv_font_get_line_height(font) + cell_top + cell_bottom;
+ /* Calculate the cell_data index where to start */
+ uint32_t row_start = row_id * table->col_cnt;
+
+ /* Traverse the cells in the row_id row */
+ uint32_t cell;
+ uint32_t col;
+ for(cell = row_start, col = 0; cell < row_start + table->col_cnt; cell++, col++) {
+ lv_table_cell_t * cell_data = table->cell_data[cell];
+
+ if(is_cell_empty(cell_data)) {
+ continue;
+ }
+
+ int32_t txt_w = table->col_w[col];
+
+ /* Traverse the current row from the first until the penultimate column.
+ * Increment the text width if the cell has the LV_TABLE_CELL_CTRL_MERGE_RIGHT control,
+ * exit the traversal when the current cell control is not LV_TABLE_CELL_CTRL_MERGE_RIGHT */
+ uint32_t col_merge = 0;
+ for(col_merge = 0; col_merge + col < table->col_cnt - 1; col_merge++) {
+ lv_table_cell_t * next_cell_data = table->cell_data[cell + col_merge];
+
+ if(is_cell_empty(next_cell_data)) break;
+
+ lv_table_cell_ctrl_t ctrl = (lv_table_cell_ctrl_t) next_cell_data->ctrl;
+ if(ctrl & LV_TABLE_CELL_CTRL_MERGE_RIGHT) {
+ txt_w += table->col_w[col + col_merge + 1];
+ }
+ else {
+ break;
+ }
+ }
+
+ lv_table_cell_ctrl_t ctrl = (lv_table_cell_ctrl_t) cell_data->ctrl;
+
+ /*When cropping the text we can assume the row height is equal to the line height*/
+ if(ctrl & LV_TABLE_CELL_CTRL_TEXT_CROP) {
+ h_max = LV_MAX(lv_font_get_line_height(font) + cell_top + cell_bottom,
+ h_max);
+ }
+ /*Else we have to calculate the height of the cell text*/
+ else {
+ lv_point_t txt_size;
+ txt_w -= cell_left + cell_right;
+
+ lv_text_get_size(&txt_size, table->cell_data[cell]->txt, font,
+ letter_space, line_space, txt_w, LV_TEXT_FLAG_NONE);
+
+ h_max = LV_MAX(txt_size.y + cell_top + cell_bottom, h_max);
+ /*Skip until one element after the last merged column*/
+ cell += col_merge;
+ col += col_merge;
+ }
+ }
+
+ return h_max;
+}
+
+static lv_result_t get_pressed_cell(lv_obj_t * obj, uint32_t * row, uint32_t * col)
+{
+ lv_table_t * table = (lv_table_t *)obj;
+
+ lv_indev_type_t type = lv_indev_get_type(lv_indev_active());
+ if(type != LV_INDEV_TYPE_POINTER && type != LV_INDEV_TYPE_BUTTON) {
+ if(col) *col = LV_TABLE_CELL_NONE;
+ if(row) *row = LV_TABLE_CELL_NONE;
+ return LV_RESULT_INVALID;
+ }
+
+ lv_point_t p;
+ lv_indev_get_point(lv_indev_active(), &p);
+
+ int32_t tmp;
+ if(col) {
+ int32_t x = p.x + lv_obj_get_scroll_x(obj);
+
+ if(lv_obj_get_style_base_dir(obj, LV_PART_MAIN) == LV_BASE_DIR_RTL) {
+ x = obj->coords.x2 - lv_obj_get_style_pad_right(obj, LV_PART_MAIN) - x;
+ }
+ else {
+ x -= obj->coords.x1;
+ x -= lv_obj_get_style_pad_left(obj, LV_PART_MAIN);
+ }
+
+ *col = 0;
+ tmp = 0;
+ for(*col = 0; *col < table->col_cnt; (*col)++) {
+ tmp += table->col_w[*col];
+ if(x < tmp) break;
+ }
+ }
+
+ if(row) {
+ int32_t y = p.y + lv_obj_get_scroll_y(obj);;
+ y -= obj->coords.y1;
+ y -= lv_obj_get_style_pad_top(obj, LV_PART_MAIN);
+
+ *row = 0;
+ tmp = 0;
+
+ for(*row = 0; *row < table->row_cnt; (*row)++) {
+ tmp += table->row_h[*row];
+ if(y < tmp) break;
+ }
+ }
+
+ return LV_RESULT_OK;
+}
+
+/* Returns number of bytes to allocate based on chars configuration */
+static size_t get_cell_txt_len(const char * txt)
+{
+ size_t retval = 0;
+
+#if LV_USE_ARABIC_PERSIAN_CHARS
+ retval = sizeof(lv_table_cell_t) + _lv_text_ap_calc_bytes_count(txt) + 1;
+#else
+ retval = sizeof(lv_table_cell_t) + strlen(txt) + 1;
+#endif
+
+ return retval;
+}
+
+/* Copy txt into dst skipping the format byte */
+static void copy_cell_txt(lv_table_cell_t * dst, const char * txt)
+{
+#if LV_USE_ARABIC_PERSIAN_CHARS
+ _lv_text_ap_proc(txt, dst->txt);
+#else
+ strcpy(dst->txt, txt);
+#endif
+}
+
+static void get_cell_area(lv_obj_t * obj, uint32_t row, uint32_t col, lv_area_t * area)
+{
+ lv_table_t * table = (lv_table_t *)obj;
+
+ uint32_t c;
+ area->x1 = 0;
+ for(c = 0; c < col; c++) {
+ area->x1 += table->col_w[c];
+ }
+
+ bool rtl = lv_obj_get_style_base_dir(obj, LV_PART_MAIN) == LV_BASE_DIR_RTL;
+ if(rtl) {
+ area->x1 += lv_obj_get_scroll_x(obj);
+ int32_t w = lv_obj_get_width(obj);
+ area->x2 = w - area->x1 - lv_obj_get_style_pad_right(obj, 0);
+ area->x1 = area->x2 - table->col_w[col];
+ }
+ else {
+ area->x1 -= lv_obj_get_scroll_x(obj);
+ area->x1 += lv_obj_get_style_pad_left(obj, 0);
+ area->x2 = area->x1 + table->col_w[col] - 1;
+ }
+
+ uint32_t r;
+ area->y1 = 0;
+ for(r = 0; r < row; r++) {
+ area->y1 += table->row_h[r];
+ }
+
+ area->y1 += lv_obj_get_style_pad_top(obj, 0);
+ area->y1 -= lv_obj_get_scroll_y(obj);
+ area->y2 = area->y1 + table->row_h[row] - 1;
+
+}
+
+static void scroll_to_selected_cell(lv_obj_t * obj)
+{
+ lv_table_t * table = (lv_table_t *)obj;
+
+ lv_area_t a;
+ get_cell_area(obj, table->row_act, table->col_act, &a);
+ if(a.x1 < 0) {
+ lv_obj_scroll_by_bounded(obj, -a.x1, 0, LV_ANIM_ON);
+ }
+ else if(a.x2 > lv_obj_get_width(obj)) {
+ lv_obj_scroll_by_bounded(obj, lv_obj_get_width(obj) - a.x2, 0, LV_ANIM_ON);
+ }
+
+ if(a.y1 < 0) {
+ lv_obj_scroll_by_bounded(obj, 0, -a.y1, LV_ANIM_ON);
+ }
+ else if(a.y2 > lv_obj_get_height(obj)) {
+ lv_obj_scroll_by_bounded(obj, 0, lv_obj_get_height(obj) - a.y2, LV_ANIM_ON);
+ }
+
+}
+#endif
diff --git a/lib/lvgl/src/widgets/table/lv_table.h b/lib/lvgl/src/widgets/table/lv_table.h
new file mode 100644
index 00000000..456d794f
--- /dev/null
+++ b/lib/lvgl/src/widgets/table/lv_table.h
@@ -0,0 +1,231 @@
+/**
+ * @file lv_table.h
+ *
+ */
+
+#ifndef LV_TABLE_H
+#define LV_TABLE_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*********************
+ * INCLUDES
+ *********************/
+
+#include "../label/lv_label.h"
+
+#if LV_USE_TABLE != 0
+
+/*Testing of dependencies*/
+#if LV_USE_LABEL == 0
+#error "lv_table: lv_label is required. Enable it in lv_conf.h (LV_USE_LABEL 1)"
+#endif
+
+/*********************
+ * DEFINES
+ *********************/
+#define LV_TABLE_CELL_NONE 0XFFFF
+LV_EXPORT_CONST_INT(LV_TABLE_CELL_NONE);
+
+/**********************
+ * TYPEDEFS
+ **********************/
+
+enum _lv_table_cell_ctrl_t {
+ LV_TABLE_CELL_CTRL_MERGE_RIGHT = 1 << 0,
+ LV_TABLE_CELL_CTRL_TEXT_CROP = 1 << 1,
+ LV_TABLE_CELL_CTRL_CUSTOM_1 = 1 << 4,
+ LV_TABLE_CELL_CTRL_CUSTOM_2 = 1 << 5,
+ LV_TABLE_CELL_CTRL_CUSTOM_3 = 1 << 6,
+ LV_TABLE_CELL_CTRL_CUSTOM_4 = 1 << 7,
+};
+
+#ifdef DOXYGEN
+typedef _lv_table_cell_ctrl_t lv_table_cell_ctrl_t;
+#else
+typedef uint32_t lv_table_cell_ctrl_t;
+#endif /*DOXYGEN*/
+
+/*Data of cell*/
+typedef struct {
+ lv_table_cell_ctrl_t ctrl;
+ void * user_data; /**< Custom user data*/
+ char txt[1]; /**< Variable length array*/
+} lv_table_cell_t;
+
+/*Data of table*/
+typedef struct {
+ lv_obj_t obj;
+ uint32_t col_cnt;
+ uint32_t row_cnt;
+ lv_table_cell_t ** cell_data;
+ int32_t * row_h;
+ int32_t * col_w;
+ uint32_t col_act;
+ uint32_t row_act;
+} lv_table_t;
+
+LV_ATTRIBUTE_EXTERN_DATA extern const lv_obj_class_t lv_table_class;
+
+/**********************
+ * GLOBAL PROTOTYPES
+ **********************/
+
+/**
+ * Create a table object
+ * @param parent pointer to an object, it will be the parent of the new table
+ * @return pointer to the created table
+ */
+lv_obj_t * lv_table_create(lv_obj_t * parent);
+
+/*=====================
+ * Setter functions
+ *====================*/
+
+/**
+ * Set the value of a cell.
+ * @param obj pointer to a Table object
+ * @param row id of the row [0 .. row_cnt -1]
+ * @param col id of the column [0 .. col_cnt -1]
+ * @param txt text to display in the cell. It will be copied and saved so this variable is not required after this function call.
+ * @note New roes/columns are added automatically if required
+ */
+void lv_table_set_cell_value(lv_obj_t * obj, uint32_t row, uint32_t col, const char * txt);
+
+/**
+ * Set the value of a cell. Memory will be allocated to store the text by the table.
+ * @param obj pointer to a Table object
+ * @param row id of the row [0 .. row_cnt -1]
+ * @param col id of the column [0 .. col_cnt -1]
+ * @param fmt `printf`-like format
+ * @note New roes/columns are added automatically if required
+ */
+void lv_table_set_cell_value_fmt(lv_obj_t * obj, uint32_t row, uint32_t col, const char * fmt,
+ ...) LV_FORMAT_ATTRIBUTE(4, 5);
+
+/**
+ * Set the number of rows
+ * @param obj table pointer to a Table object
+ * @param row_cnt number of rows
+ */
+void lv_table_set_row_count(lv_obj_t * obj, uint32_t row_cnt);
+
+/**
+ * Set the number of columns
+ * @param obj table pointer to a Table object
+ * @param col_cnt number of columns.
+ */
+void lv_table_set_column_count(lv_obj_t * obj, uint32_t col_cnt);
+
+/**
+ * Set the width of a column
+ * @param obj table pointer to a Table object
+ * @param col_id id of the column [0 .. LV_TABLE_COL_MAX -1]
+ * @param w width of the column
+ */
+void lv_table_set_column_width(lv_obj_t * obj, uint32_t col_id, int32_t w);
+
+/**
+ * Add control bits to the cell.
+ * @param obj pointer to a Table object
+ * @param row id of the row [0 .. row_cnt -1]
+ * @param col id of the column [0 .. col_cnt -1]
+ * @param ctrl OR-ed values from ::lv_table_cell_ctrl_t
+ */
+void lv_table_add_cell_ctrl(lv_obj_t * obj, uint32_t row, uint32_t col, lv_table_cell_ctrl_t ctrl);
+
+/**
+ * Clear control bits of the cell.
+ * @param obj pointer to a Table object
+ * @param row id of the row [0 .. row_cnt -1]
+ * @param col id of the column [0 .. col_cnt -1]
+ * @param ctrl OR-ed values from ::lv_table_cell_ctrl_t
+ */
+void lv_table_clear_cell_ctrl(lv_obj_t * obj, uint32_t row, uint32_t col, lv_table_cell_ctrl_t ctrl);
+
+/**
+ * Add custom user data to the cell.
+ * @param obj pointer to a Table object
+ * @param row id of the row [0 .. row_cnt -1]
+ * @param col id of the column [0 .. col_cnt -1]
+ * @param user_data pointer to the new user_data.
+ * Should be allocated by `lv_malloc`,
+ * and it will be freed automatically when the table is deleted or
+ * when the cell is dropped due to lower row or column count.
+ */
+void lv_table_set_cell_user_data(lv_obj_t * obj, uint16_t row, uint16_t col, void * user_data);
+
+/*=====================
+ * Getter functions
+ *====================*/
+
+/**
+ * Get the value of a cell.
+ * @param obj pointer to a Table object
+ * @param row id of the row [0 .. row_cnt -1]
+ * @param col id of the column [0 .. col_cnt -1]
+ * @return text in the cell
+ */
+const char * lv_table_get_cell_value(lv_obj_t * obj, uint32_t row, uint32_t col);
+
+/**
+ * Get the number of rows.
+ * @param obj table pointer to a Table object
+ * @return number of rows.
+ */
+uint32_t lv_table_get_row_count(lv_obj_t * obj);
+
+/**
+ * Get the number of columns.
+ * @param obj table pointer to a Table object
+ * @return number of columns.
+ */
+uint32_t lv_table_get_column_count(lv_obj_t * obj);
+
+/**
+ * Get the width of a column
+ * @param obj table pointer to a Table object
+ * @param col id of the column [0 .. LV_TABLE_COL_MAX -1]
+ * @return width of the column
+ */
+int32_t lv_table_get_column_width(lv_obj_t * obj, uint32_t col);
+
+/**
+ * Get whether a cell has the control bits
+ * @param obj pointer to a Table object
+ * @param row id of the row [0 .. row_cnt -1]
+ * @param col id of the column [0 .. col_cnt -1]
+ * @param ctrl OR-ed values from ::lv_table_cell_ctrl_t
+ * @return true: all control bits are set; false: not all control bits are set
+ */
+bool lv_table_has_cell_ctrl(lv_obj_t * obj, uint32_t row, uint32_t col, lv_table_cell_ctrl_t ctrl);
+
+/**
+ * Get the selected cell (pressed and or focused)
+ * @param obj pointer to a table object
+ * @param row pointer to variable to store the selected row (LV_TABLE_CELL_NONE: if no cell selected)
+ * @param col pointer to variable to store the selected column (LV_TABLE_CELL_NONE: if no cell selected)
+ */
+void lv_table_get_selected_cell(lv_obj_t * obj, uint32_t * row, uint32_t * col);
+
+/**
+ * Get custom user data to the cell.
+ * @param obj pointer to a Table object
+ * @param row id of the row [0 .. row_cnt -1]
+ * @param col id of the column [0 .. col_cnt -1]
+ */
+void * lv_table_get_cell_user_data(lv_obj_t * obj, uint16_t row, uint16_t col);
+
+/**********************
+ * MACROS
+ **********************/
+
+#endif /*LV_USE_TABLE*/
+
+#ifdef __cplusplus
+} /*extern "C"*/
+#endif
+
+#endif /*LV_TABLE_H*/