列表显示框布局：使用布局和元素字串

列表显示框 组件支持两种定义元素的方法：元素字串 和 布局。

元素字串 是旧版本的兼容方法，它支持由单个字符串组成的元素。

布局 与 列表数据 相结合，允许更复杂的元素布局，可以包含多个字符串和可选图像。

`元素字串`

这是使用（英文）逗号分隔字符串描述 列表显示框 中元素的传统方法。此方法仅支持由单个字符串组成的元素。

例如：Main Text 1, Main Text 2, Main Text 3

将在设备中显示为：

ListView elements for layout MainText

列表显示框 支持高级布局选项。

布局是从 布局 属性中的选项列表中选择的，然后可以使用 列表数据 属性在“界面设计”视图中定义元素。

列表数据 属性编辑器是一个弹出窗口，允许用户根据选择的布局定义主要文本、详细文本和图像（该图像是从上传到媒体的图像列表中选择的）。

ListData editor displaying all field options

当前布局选项及示例：

ListView elements for layout MainText

ListView elements for layout MainText,DetailText(vertical)

ListView elements for layout MainText,DetailText(horizontal)

ListView elements for layout Image,MainText

ListView elements for layout Image,MainText,DetailText

Android 版本的 列表显示框 使用 RecyclerView 渲染行项目。列表数据由统一的数据模型管理，界面刷新、搜索过滤和选中状态不会再各自维护一份副本，因此在增删项目或快速输入搜索关键字时，行数和选中项能够保持一致。

启用 显示搜索框 后，搜索会同时匹配主文本和详细文本，且不区分大小写。搜索结果只是原列表的视图，不会修改 元素 本身；清空搜索框即可恢复完整列表。

选中项索引 始终对应原列表的 1-based 索引。过滤时，如果已选项目仍在结果中会保留选中状态；项目被过滤掉时，界面会清除不可见的选中状态。使用 多选 时，多个选中项同样按原列表索引维护。

优先使用 元素、添加项目、添加项目到索引、删除索引处项目 等组件属性和方法更新数据，不要在外部长期持有并直接修改返回的列表。批量更新完成后调用 刷新，可以避免重复刷新造成不必要的布局开销。

方向设置为“水平”时，项目按横向 RecyclerView 布局显示；图片布局中的图片文件名必须是已经上传到项目媒体资源的文件名。列表很大时建议使用分页或分批添加，并避免在计时器事件中频繁重建整个 元素 列表。