自定义列表

自定义列表是一个基于模板的动态控件，它以出色的灵活性合并了各种控件。 自定义列表与标准列表控件不同，它允许在布局中使用更多控件，非常适合创建有效的电子邮件列表网格等任务。

属性

自定义列表具有两组属性：一组用于主控件，一组用于其中的模板。

要在自定义列表及其模板的属性之间切换，只需单击画布中的控件或从左侧的树视图中选择该控件。

此行

用于表示自定义列表数据每一行的ThisRow关键字

要将数据源中的值绑定到自定义列表中的各个控件，请使用ThisRow关键字。 有关详细信息，请参阅示例。

限制

• 出于性能方面的考虑，自定义列表中无法包含多个控件：

  • 编辑网格

  • 表格

  • 自定义列表

  • 自定义 HTML

  • 选项卡

  备注：

  对于超过四个项目的基于列表的控件，我们建议使用下拉控件。

• 尽管 IntelliSense 可以找到控件名称，但还是不允许直接引用自定义列表控件，例如MainPage.Header 。
• 在自定义列表的上下文和其他容器控件之间拖动控件可能会导致表达式无效，有些控件仅在预览应用程序时可见。 这是因为自定义列表上下文（使用ThisRow关键字）内的绑定在自定义列表外部无效。

优化自定义列表创建

使用自定义列表的最佳方法如下：

1. 使用设计工具（如 图玛）设计自定义列表。

2. 在 App Studio 中，添加“自定义列表”控件后，请为每个列表元素使用容器和控件创建一个布局。

3. 创建一个包含文本说明的示例行。

4. 将文本说明替换为表达式。

5. 向事件添加规则。

6. 根据设计文件调整控件样式。

7. 预览应用程序。

常规

自定义列表

• “数据源” - 用于列表显示的数据源。 有效的数据类型为数据表和对象数组。
• “隐藏” - 如果设置为“True”，则在运行时隐藏该控件。
• 已禁用- 如果设置为 False，则应用程序用户可以与列表交互。 如果设置为 True，则列表处于只读状态。

模板

• “工具提示” - 要在模板上显示的工具提示。 使用此选项可提供有关模板的其他信息。

• “隐藏” - 如果设置为“True”，则在运行时隐藏该控件。

• 已禁用- 如果设置为 False，则应用程序用户可以与模板交互。 如果设置为 True，则模板处于只读状态。

Events

自定义列表

• 已选择的行- 配置当应用程序用户在自定义列表中选择行（即模板中的控件）时会发生的情况。 配置值更改时会发生的情况。

模板

• “已单击”- 配置单击模板时会发生的情况。

样式

自定义列表

• “控件对齐”- 默认情况下，继承父级对齐方式。可以设置与父级对齐方式不同的对齐方式。要默认返回到父级对齐方式，请取消选择覆盖的选项。

  注意：对齐方式取决于为父元素选择的布局（垂直与水平）。
• “布局” - 自定义模板在自定义列表中的位置：
  • 垂直- 模板垂直排列

  • 水平- 模板水平排列

  • 网格- 模板以网格格式排列

  • 间距（仅限像素）- 当模板以垂直或水平布局排列时，模板之间的间距。

  • 水平/垂直间距- 在网格布局中排列时，模板之间的水平和垂直间距。

  • 模板宽度- 模板的宽度。

  • 模板高度- 模板的高度。

  备注：

  • 在水平布局中，您可以设置宽度（以像素为单位），高度（以像素为单位）： % 、 em或auto 。
  • 在垂直布局中，高度以像素为单位，宽度可以是像素、 % 、 em或auto 。

  • 在“网格”布局中，“高度”和“宽度”都以像素为单位。

• “边距”- 设置布局的边距。默认情况下，边距设置为 4 像素。“上/下”和“左/右”边距属性结合使用。可以使用“边距”部分右侧的“链接”按钮分离这些属性。

• “大小” - 自定义列表的宽度和高度（以像素为单位）。 默认值：
  • 在水平布局中:宽度800 像素，高度自动
  • 在垂直布局中：宽度为自动，高度为 400 像素
  • 在网格布局中：宽度800 像素，高度400 像素
  要设置最小值或最大值，请单击三点图标 (...)。

模板

• “控件对齐”- 默认情况下，继承父级对齐方式。可以设置与父级对齐方式不同的对齐方式。要默认返回到父级对齐方式，请取消选择覆盖的选项。

  注意：对齐方式取决于为父元素选择的布局（垂直与水平）。

• “布局” - 确定模板中控件的定位方式：

  • “水平/垂直”- 控件的方向。
  • “对齐” - 模板中控件的对齐方式。
  • “允许换行” - 如果选中，则换行模板中的控件。

  • “允许滚动” - 如果选中，则允许在模板内滚动。 要启用 “允许滚动”，模板必须具有固定高度（垂直布局）或固定宽度（水平布局）。

• “背景颜色” - 模板的背景颜色。

• “边框”- 控件的边框。可以配置边框粗细、颜色和半径。

• “字体” - 模板的字体系列。 模板中的所有控件共享相同的字体系列。 默认情况下，模板会继承自定义列表的字体系列。

• “边距”- 设置布局的边距。默认情况下，边距设置为 0 像素。“上/下”和“左/右”边距属性结合使用。可以使用“边距”部分右侧的“链接”按钮分离这些属性。

• “填充” - 模板的填充。 默认情况下，填充设置为 16 像素。 “上/下”和“左/右”边距属性结合使用。 可以使用“ 填充 ”部分右侧的“ 链接” 按钮分离这些属性。

• 高级 -显示控件的弹性属性。

  • “ Flex 基础” -设置在分配或拿走额外空间之前 Flex 项目的原始大小（ px 、 % 、 em和auto ）。

  • “弹性增长” - 当有额外空间可用时，此值将决定弹性项目相对于其余项目应增长的程度。

  • 弹性收缩- 当空间不足时，此值决定弹性项目相对于其他项目应收缩的程度。

    有关详细信息，请参阅Mozilla 开发者网络文档。

VB 属性

属性名称	数据类型	访问权限	示例
已禁用	布尔值	读取/写入	-
隐藏	布尔值	读取/写入	-
SelectedItem	数据源类型和自定义列表中的控件列表的并集	读取/写入	假设您的数据源是一个实体要访问实体行，请执行以下操作： MainPage.CustomList.SelectedItem.data 假设您的自定义列表中有一个日期选取器。 要访问日期选取器控件的值，请执行以下操作： MainPage.CustomList.SelectedItem.Datepicker.value
选定的项目索引	整数	只读	返回当前选定行的索引： MainPage.CustomList.SelectedItemIndex
此行	与“数据源”字段相同	只读	引用数据源的当前记录。 使用它来配置自定义列表中的字段。

自定义列表元素的数据绑定示例

数据源是实体

假设您在“数据源”字段中引用了一个实体。 此实体具有名为 cvxz"FirstName".vcc 的列

要将此列绑定到 自定义列表 中的 文本框 控件，可以使用以下表达式：

ThisRow.Firstname

数据源为数据表

假设您在“数据源”字段中引用了流程的“数据表”参数。

“ThisRow”的类型为“数据行”，可以按如下方式提取其值：

ThisRow("FieldName")

确保将其转换为适当的类型。

演示

使用自定义列表

简介

此应用程序演示了“自定义列表”功能。

演示应用程序 - 自行尝试

要自行试用自定义列表，请使用演示应用程序。

从 GitHub 下载演示应用程序

在 Cloud 中预览演示应用程序

演示应用程序 - 使用说明

1. 在 UiPath^TM Apps 中，创建一个新应用程序并导入已下载的演示应用程序。

2. 您可能会注意到一些错误。 要修复这些问题，请将引用的实体“Country”、“EmailInbox”、“Employees”、“Employees2”和“System Users”替换为租户中的实体。

3. 要与“自定义列表”字段交互，请预览您的应用程序。