Roller （滚轮）(lv_roller)

Overview（概述）

显示原文

Roller allows you to simply select one option from a list by scrolling.

滚轮类似下拉列表，和下拉列表不同的是，滚轮有直接可见的几个选项，我们可以通过滚动滚轮中的列表来浏览并选择选项。

Parts and Styles（部分和样式）

显示原文

LV_PART_MAIN The background of the Roller uses the background- and text-style properties.
- Style text_line_space adjusts the space between list items. Use lv_obj_set_style_text_line_space() to set this value.
- When the Roller is scrolled and doesn't stop exactly on an item, it will automatically scroll to the nearest valid item in anim_time milliseconds as specified in the anim_duration style. Use lv_obj_set_style_anim_duration() to set this value.
LV_PART_SELECTED The selected item (displayed in the middle of the Roller). Besides the typical background properties, it uses text style properties to change the appearance of the text of the selected item.

LV_PART_MAIN：滚轮的背景使用背景样式和文本样式属性。

样式 text_line_space 用于调整列表项之间的间距。使用 lv_obj_set_style_text_line_space() 来设置该值。

当滚轮滚动且未恰好停在某个项目上时，它将按照 anim_time 样式中指定的 ``anim_duration``（以毫秒为单位）自动滚动到最近的有效项目。使用 lv_obj_set_style_anim_duration() 来设置该值。

LV_PART_SELECTED：被选中的项目（显示在滚轮的中间位置）。除了典型的背景属性外，它还使用文本样式属性来改变所选项目文本的外观。

Usage（用法）

Set options（设置选项）

显示原文

List items are passed to the Roller as a string with lv_roller_set_options(roller, string_list, LV_ROLLER_MODE_NORMAL). The items should be separated by \n. For example: "First\nSecond\nThird".

LV_ROLLER_MODE_INFINITE makes the Roller circular.

You can select an option programmatically with lv_roller_set_selected(roller, id, LV_ANIM_ON), where id is the zero-based index of the list item to be selected.

If you don't know the index of an option can also select an item with lv_roller_set_selected_str(roller, str, LV_ANIM_ON), where str is the string equal to one of the list items.

列表项作为一个字符串传递给滚轮，通过 lv_roller_set_options(roller, string_list, LV_ROLLER_MODE_NORMAL)`来实现。这些列表项应当用 `n`` 进行分隔。例如： "First\nSecond\nThird"。

:cpp:enumerator:`LV_ROLLER_MODE_INFINITE`可使滚轮变为循环模式。

你可以通过编程的方式使用 :cpp:expr:`lv_roller_set_selected(roller, id, LV_ANIM_ON)`来选择一个选项，其中 id 是要选择的列表项基于零开始的索引。

如果你不知道某个选项的索引，也可以使用 :cpp:expr:`lv_roller_set_selected_str(roller, str, LV_ANIM_ON)`来选择一个项目，其中 str 是与列表项之一相等的字符串。

Get selected option（获取选中的选项）

显示原文

To get the index of the currently selected option use lv_roller_get_selected(roller).

lv_roller_get_selected_str(roller, buf, buf_size) will copy the name of the selected option to buf.

要获取所选中的选项的索引(index) ，可以使用函数 lv_roller_get_selected(roller)。

函数 lv_roller_get_selected_str(roller, buf, buf_size) 会将所选选项的内容复制到 buf

Visible rows（可见行）

显示原文

The number of visible rows can be adjusted with lv_roller_set_visible_row_count(roller, num).

This function calculates the height with the current style. If the font, line space, border width, etc. of the roller changes this function needs to be called again.

可见行数可以通过 lv_roller_set_visible_row_count(roller, num) 进行调整。

此函数会根据滚轮当前样式的高度（字体、行距、边框宽度等）进行调整。如果滚轮的字体、行距、边框宽度等发生变化，则需要再次调用此函数对齐重新进行调整。