List（列表） (lv_list)

Overview

显示原文

The List Widget is basically a rectangle with vertical layout to which Buttons and Text can be added.

列表部件基本上是一个采用垂直布局的矩形，可向其中添加按钮和文本。

Parts and Styles（部分和样式）

Background （背景）

显示原文

LV_PART_MAIN The main part of the List that uses all the typical background properties
LV_PART_SCROLLBAR The scrollbar. See Base Widget documentation for details.

Buttons and Texts

See the Button's and Label's documentation.

LV_PART_MAIN 列表的主体部分，会用到所有常见的背景属性。
LV_PART_SCROLLBAR 滚动条。详情请参阅 Base Widget 文档。

按钮和文本 请参阅 Button 和 Label 的文档。

Usage（用法）

Buttons（按钮）

显示原文

lv_list_add_button(list, icon, text) adds a full-width button with an icon (that can be an image or symbol) and text. This function returns a pointer to the button created, which you can use to, for example, add an event call-back.

The text is scrolled horizontally if it is longer than the button.

:cpp:expr:`lv_list_add_button(list, icon, text)`会添加一个带有图标（图标可以是图像或符号）和文本的全宽按钮。该函数会返回一个指向所创建按钮的指针，你可以利用这个指针（例如）添加一个事件回调函数。

如果文本长度超过按钮宽度，文本将会水平滚动。

Texts（文本）

显示原文

lv_list_add_text(list, text) adds a text string. This function returns a pointer to the label created, which you can use to, for example, change its text with one of the lv_label_set_text...() functions.

:cpp:expr:`lv_list_add_text(list, text)`用于添加一个文本字符串。该函数会返回一个指向所创建标签的指针，你可以利用这个指针（例如）通过某个 ``lv_label_set_text...()``函数来更改其文本内容。

Events（事件）

显示原文

No special events are sent by List Widgets, but events can be sent by Buttons as usual.

Keys（按键）

显示原文

No Keys are processed by List Widgets.

Learn more about Keys（按键）.

列表部件不处理任何按键。

了解有关 Keys（按键）的更多信息。

Example

API

lv_api_map_v8.h

lv_list.h