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 all the typical background properties and text style properties. style_text_line_space adjusts the space between the options. When the Roller is scrolled and doesn't stop exactly on an option it will scroll to the nearest valid option automatically in anim_time milliseconds as specified in the style.
LV_PART_SELECTED The selected option in the middle. Besides the typical background properties it uses the text style properties to change the appearance of the text in the selected area.

LV_PART_MAIN 滚轮的背景使用了所有典型的背景属性和文本样式属性。可以通过 style_text_line_space 调整选项之间的间隔。当滚轮滚动并且没有完全停在一个选项上时，它将按照样式中指定的 anim_time 值(毫秒)自动滚动到前进方向最近的有效选项。
LV_PART_SELECTED 中间选中的选项。除了典型的背景属性之外，它还使用文本样式属性来更改所选区域中文本的外观。

Usage（用法）

Set options（设置选项）

显示原文

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

LV_ROLLER_MODE_INFINITE makes the roller circular.

You can select an option manually with lv_roller_set_selected(roller, id, LV_ANIM_ON), where id is the index of an option.

可以通过这个函数 lv_roller_set_options(roller, options, LV_ROLLER_MODE_NORMAL) 设置 Roller 中的选项。选项之间要用 \n 分隔。例如： "First\nSecond\nThird"。

参数 LV_ROLLER_MODE_NORMAL 是设置为正常模式（滚轮在选项结束时结束）参数 LV_ROLLER_MODE_INFINITE 是设置为无限模式（滚轮可以一直滚动）

可以使用 lv_roller_set_selected(roller, id, LV_ANIM_ON) 手动选中一个选项，其中 id 是选项的索引，选项从 0 开始索引。

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) 进行调整。

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