LVGL-滚轮

lv_roller_create

用于创建一个滚轮

lv_obj_t *lv_roller_create（lv_obj_t *parent)
//parent:其父对象的指针
//ret：返回创建的滚轮的句柄

lv_roller_set_options

用于设置滚轮选项的函数。通过此函数，可以指定滚轮显示的选项列表，并设置滚轮的滚动模式

void lv_roller_set_options(lv_obj_t * roller, const char * options, lv_roller_mode_t mode);
//roller：指向滚轮对象的指针
//options：一个以 \0 结尾的字符串，包含所有选项，选项之间用 \n 分隔
//mode：滚轮的滚动模式
//LV_ROLLER_MODE_INFINITE：选项会循环滚动，即到达最后一个选项后会回到第一个选项。
//LV_ROLLER_MODE_FINITE：选项不会循环滚动，到达最后一个选项后会停止

lv_roller_set_selected

用于设置滚轮当前选中项的函数

void lv_roller_set_selected(lv_obj_t * roller, uint16_t sel_opt, bool anim);
//roller：指向滚轮对象的指针
//sel_opt：要设置为选中的选项索引（从 0 开始）
//anim：布尔值，用于控制是否使用动画来更新选中项,true：使用动画滚动到指定的选项,false：立即跳转到指定的选项，不使用动画

lv_roller_set_visible_row_count

用于设置滚轮可见行数的函数。通过此函数，可以控制滚轮在屏幕上显示的选项数量

void lv_roller_set_visible_row_count(lv_obj_t * roller, uint8_t row_count);
//roller：指向滚轮对象的指针
//row_count：要显示的行数。这个值决定了滚轮在屏幕上同时可见的选项数量

lv_roller_get_selected

用于获取滚轮当前选中项索引的函数。通过此函数，可以确定用户当前选择的选项在选项列表中的位置。

uint16_t lv_roller_get_selected(const lv_obj_t * roller);
//roller：指向滚轮对象的指针
//ret:返回当前选中项的索引（从 0 开始）

lv_roller_get_selected_str

用于获取滚轮当前选中项的字符串内容的函数

void lv_roller_get_selected_str(const lv_obj_t * roller, char * buf, uint32_t buf_size);
//roller：指向滚轮对象的指针
//buf：目标缓冲区，用于存储选中项的字符串内容
//buf_size：缓冲区的大小，确保足够存储选中项的字符串内容

lv_roller_get_options

获取滚轮所有选项字符串的函数。通过此函数，可以检索滚轮当前设置的所有选项内容。

const char * lv_roller_get_options(const lv_obj_t * roller);
//roller：指向滚轮对象的指针
//ret:返回一个指向滚轮选项字符串的指针。该字符串包含所有选项，选项之间用换行符 \n 分隔

lv_roller_get_option_cnt

用于获取滚轮选项总数

uint16_t lv_roller_get_option_cnt(const lv_obj_t * roller);
//roller：指向滚轮对象的指针
//ret:返回滚轮中选项的总数（uint16_t 类型）。如果滚轮中没有选项，返回值为 0