LVGL-日历

lv_calendar_create

用于创建日历控件

lv_obj_t * lv_calendar_create(lv_obj_t * parent);
//parent：指向父对象的指针

lv_calendar_set_today_date

用于设置日历控件（lv_calendar）中“今天”日期的函数

void lv_calendar_set_today_date(lv_obj_t * obj, uint32_t year, uint32_t month, uint32_t day);
//obj：指向日历控件的指针
//year：年份（例如 2025）
//month：月份（1 到 12，其中 1 表示一月，12 表示十二月）
//day：日期（1 到 31）

lv_calendar_set_showed_date

用于设置日历控件（lv_calendar）当前显示的年份和月份的函数。通过这个函数，可以指定日历显示的特定日期范围

void lv_calendar_set_showed_date(lv_obj_t * obj, uint32_t year, uint32_t month);
//obj：指向日历控件的指针
//year：要显示的年份（例如 2025）
//month：要显示的月份（1 到 12，其中 1 表示一月，12 表示十二月）。

lv_calendar_set_highlighted_dates

用于设置日历控件（lv_calendar）中高亮显示的日期的函数。通过这个函数，可以指定某些日期以特殊样式（如高亮、不同颜色等）显示

void lv_calendar_set_highlighted_dates(lv_obj_t * obj, const lv_calendar_date_t * dates, uint32_t date_num);
//obj：指向日历控件的指针
//dates：一个指向 lv_calendar_date_t 结构数组的指针，每个结构表示一个要高亮显示的日期。
//date_num：要高亮显示的日期数量

lv_calendar_set_day_names

用于设置日历控件（lv_calendar）中星期名称的函数

void lv_calendar_set_day_names(lv_obj_t * obj, const char * day_names[]);
//obj：指向日历控件的指针
//day_names：一个包含星期名称的字符串数组。数组的长度必须为 7，分别对应星期天到星期六。

lv_calendar_get_btnmatrix

用于获取日历控件（lv_calendar）内部使用的按钮矩阵（lv_btnmatrix）对象。日历控件通过按钮矩阵来组织和显示日期及星期名称

lv_obj_t * lv_calendar_get_btnmatrix(const lv_obj_t * obj);
//obj：指向日历控件的指针
//ret:返回一个指向按钮矩阵对象的指针。这个按钮矩阵对象可以用于进一步自定义日历的显示和行为

lv_calendar_get_today_date

用于获取日历控件（lv_calendar）中设置的“今天”日期的函数

void lv_calendar_get_today_date(const lv_obj_t * obj, uint32_t * year, uint32_t * month, uint32_t * day);
//obj：指向日历控件的指针
//year：指向存储年份的变量的指针
//month：指向存储月份的变量的指针
//day：指向存储日期的变量的指针

lv_calendar_get_showed_date

用于获取日历控件（lv_calendar）当前显示的年份和月份的函数

const lv_calendar_date_t * lv_calendar_get_showed_date(const lv_obj_t * calendar);
//calendar：指向日历控件的指针
//ret:返回一个指向 lv_calendar_date_t 结构的指针，该结构包含当前显示的年份、月份和日期

lv_calendar_get_highlighted_dates

用于获取日历控件（lv_calendar）中高亮显示的日期的函数

lv_calendar_date_t * lv_calendar_get_highlighted_dates(const lv_obj_t * calendar);
//calendar：指向日历控件的指针
//ret:返回一个指向 lv_calendar_date_t 数组的指针，该数组包含所有高亮显示的日期。每个lv_calendar_date_t 结构体包含以下字段：year：年份。month：月份（1 到 12）。day：日期（1 到 31）

lv_calendar_get_highlighted_dates_num

得到高亮日期的数量

uint16_t lv_calendar_get_highlighted_dates_num(const lv_obj_t * calendar);
//calendar：指向日历控件的指针
//ret:返回高亮的日期数

lv_calendar_get_pressed_date

用于获取用户最近点击/按压的日期

bool lv_calendar_get_pressed_date(const lv_obj_t * calendar, lv_calendar_date_t * date);
//calendar: 指向日历对象的指针
//date: 指向 lv_calendar_date_t 结构体的指针，用于存储获取到的被按压日期
//ret:返回 true: 表示成功获取到被按压的日期,返回 false: 表示当前没有日期被按压或参数无效