lv_roller.h

lv_roller_set_options

Set the options on a roller

void lv_roller_set_options(lv_obj_t *obj, const char *options, lv_roller_mode_t mode)

lv_roller_set_options_translation_tag

Assign a translation tag for the options of the roller. Memory will be allocated to store the tag. The options will automatically update when the language is changed via lv_translation_set_language. The translation should contain the options in a '<br/> ' separated list. E.g. "One\nTwo\nThree"

void lv_roller_set_options_translation_tag(lv_obj_t *obj, const char *tag, lv_roller_mode_t mode)

lv_roller_set_selected

Set the selected option

void lv_roller_set_selected(lv_obj_t *obj, uint32_t sel_opt, lv_anim_enable_t anim)

lv_roller_set_selected_str

Sets the given string as the selection on the roller. Does not alter the current selection on failure.

bool lv_roller_set_selected_str(lv_obj_t *obj, const char *sel_opt, lv_anim_enable_t anim)

Returns: bool — true if set successfully and false if the given string does not exist as an option in the roller

lv_roller_set_visible_row_count

Set the height to show the given number of rows (options)

void lv_roller_set_visible_row_count(lv_obj_t *obj, uint32_t row_cnt)

lv_roller_get_selected

Get the index of the selected option

uint32_t lv_roller_get_selected(const lv_obj_t *obj)

Returns: uint32_t — index of the selected option (0 ... number of option - 1);

lv_roller_get_selected_str

Get the current selected option as a string.

void lv_roller_get_selected_str(const lv_obj_t *obj, char *buf, uint32_t buf_size)

lv_roller_get_options

Get the options of a roller

const char * lv_roller_get_options(const lv_obj_t *obj)

Returns: const char * — the options separated by '<br/> '-s (E.g. "Option1\nOption2\nOption3")

lv_roller_get_option_count

Get the total number of options

uint32_t lv_roller_get_option_count(const lv_obj_t *obj)

Returns: uint32_t — the total number of options

lv_roller_get_option_str

Get an option as a string.

lv_result_t lv_roller_get_option_str(const lv_obj_t *obj, uint32_t option, char *buf, uint32_t buf_size)

Returns: lv_result_t — LV_RESULT_OK if option found

lv_roller_create

Create a roller object

lv_obj_t * lv_roller_create(lv_obj_t *parent)

Returns: lv_obj_t * — pointer to the created roller

lv_roller_bind_value

Bind an integer Subject to a Roller's value.

lv_observer_t * lv_roller_bind_value(lv_obj_t *obj, lv_subject_t *subject)

Returns: lv_observer_t * — pointer to newly-created Observer