Skip to content

Latest commit

 

History

History
executable file
·
207 lines (121 loc) · 5.62 KB

roller.rst

File metadata and controls

executable file
·
207 lines (121 loc) · 5.62 KB
Raw

Roller （滚轮）(lv_roller)

Overview（概述）

显示原文

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


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

Parts and Styles

显示原文
  • :cppLV_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.
  • :cppLV_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.

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

Usage（用法）

Set options（设置选项）

显示原文

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

:cppLV_ROLLER_MODE_INFINITE makes the roller circular.

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


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

参数 :cppLV_ROLLER_MODE_NORMAL 是设置为正常模式（滚轮在选项结束时结束） 参数 :cppLV_ROLLER_MODE_INFINITE 是设置为无限模式（滚轮可以永远滚动）

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

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

显示原文

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

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


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

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

Visible rows（可见行）

显示原文

The number of visible rows can be adjusted with :cpplv_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.


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

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

Events（事件） ******

显示原文
  • :cppLV_EVENT_VALUE_CHANGED Sent when a new option is selected.

See the events of the Base object <lv_obj> too.

Learn more about events.


  • 在选中选项是会触发 :cppLV_EVENT_VALUE_CHANGED （按照逻辑来说只要你滚动了滚轮中的选项都会触发此事件类型）。

可以参考 基本对象 <lv_obj> 的事件。

详细了解更多 events。

Keys（按键）

显示原文
  • LV_KEY_RIGHT/DOWN Select the next option
  • LV_KEY_LEFT/UP Select the previous option
  • :cppLY_KEY_ENTER Apply the selected option (Send :cppLV_EVENT_VALUE_CHANGED event)

  • LV_KEY_RIGHT/DOWN 选择下一个选项
  • LV_KEY_LEFT/UP 选择上一个选项
  • :cppLY_KEY_ENTER 应用选择的选项（发送 :cppLV_EVENT_VALUE_CHANGED 事件）

使用编码器控制时要注意有两种模式：导航模式和编辑模式

Example

API