[English]

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 (背景)

显示原文

Buttons and Texts


按钮和文本 请参阅 ButtonLabel 的文档。

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.

Further Reading

Learn more about Base-Widget Events emitted by all Widgets.

Learn more about Events(事件).


列表部件不会发送特殊事件,但按钮通常可以发送事件。

进一步了解所有部件发出的 Base-Widget Events

进一步了解 Events(事件)

Keys(按键)

显示原文

No Keys are processed by List Widgets.

Learn more about Keys(按键).


列表部件不处理任何 按键

了解有关 Keys(按键) 的更多信息。

Example

API

lv_api_map_v8.h

lv_list.h