apps
latest
false
重要 :
有关 Studio Web 中的应用程序项目文档,请参阅 Studio Web 文档中的“应用程序项目”一章:https://docs.uipath.com/zh-CN/studio-web/automation-cloud/latest/user-guide/apps-in-studio-web。 请注意,此内容已使用机器翻译进行了部分本地化。 新发布内容的本地化可能需要 1-2 周的时间才能完成。
UiPath logo, featuring letters U and I in white

Apps 用户指南

上次更新日期 2026年3月20日

自定义列表

自定义列表是一个基于模板的动态控件,其中以卓越的灵活性合并了各种控件。与标准列表控件不同, “自定义列表”允许在布局中添加更多控件,非常适合创建有效的电子邮件列表网格等任务。

属性

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

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

此行

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

要将数据源中的值绑定到自定义列表中的各个控件,请使用ThisRow关键字。

有关详细信息,请参阅示例

限制

  • 出于性能方面的考虑,自定义列表中无法包含以下几个控件:

    • 编辑网格
    • 表格
    • 自定义列表
    • 自定义 HTML
    • 选项卡
    备注:

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

  • 尽管 IntelliSense 发现了控件名称,但不允许直接引用自定义列表控件(例如MainPage.Header )。

  • 自定义列表的上下文和其他容器控件之间拖动控件可能会导致表达式无效,有些表达式仅在您预览应用程序时可见。这是因为“自定义列表”上下文(使用ThisRow关键字)内的绑定将在“自定义列表”之外无效。

优化自定义列表创建

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

  1. 使用设计工具(如 图玛)设计自定义列表。
  2. 将“自定义列表”控件添加到应用程序中。
  3. 使用容器和控件为每个列表元素创建布局。
  4. 创建一个包含文本说明的示例行。
  5. 将文本说明替换为表达式。
  6. 向事件添加规则。
  7. 根据设计文件调整控件样式。
  8. 预览应用程序。

演示

使用自定义列表

简介

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

演示应用程序 - 自行尝试

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

从 GitHub 下载演示应用程序
在 Cloud 中预览演示应用程序
演示应用程序 - 使用说明
  1. 在 UiPath Apps 中,创建一个新应用程序并导入下载的演示应用程序。
  2. 您可能会注意到一些错误。 要修复这些问题,请将引用的实体“Country”、“EmailInbox”、“Employees”、“Employees2”和“System Users”替换为租户中的实体。
  3. 要与“自定义列表”字段进行交互,请预览您的应用程序。

常规

自定义列表

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

模板

  • “工具提示” - 要在模板上显示的工具提示。使用此选项可提供有关模板的其他信息。
  • “隐藏” - 如果设置为“True”,则在运行时隐藏该控件。
  • 已禁用- 如果设置为 False,则应用程序用户可以与模板进行交互。如果设置为 “true”,则模板处于只读状态。

Events

自定义列表

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

模板

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

样式

自定义列表

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

    对齐方式取决于为父元素选择的布局(垂直水平)。

  • “布局” - 在自定义列表中自定义模板位置:
    • 垂直- 模板垂直排列
    • 水平- 模板水平排列(垂直或水平)
    • 网格- 模板以网格格式排列(垂直或水平)
    • 间距(仅像素)- 以垂直水平布局排列时,模板之间的间距。
    • 水平/垂直间距- 在网格布局中排列时,模板之间的水平和垂直间距。
    • “模板宽度” - 模板的宽度。
    • “模板高度” - 模板的高度。
    备注:
    • “水平”布局中, “宽度” 的设置单位为像素, “高度” 的单位为像素。 %emauto
    • “垂直”布局中, “高度”以像素为单位, “宽度”可以是像素、 %emauto
    • “网格”布局中, “高度”“宽度”的单位必须为像素。不能使用相对单位,例如%emauto
  • “边距”- 设置布局的边距。默认情况下,边距设置为 4 像素。“上/下”和“左/右”边距属性结合使用。可以使用“边距”部分右侧的“链接”按钮分离这些属性。
  • “大小” - 自定义列表的宽度高度,以像素为单位。默认值:
    • 水平布局中:宽度800 像素,高度自动
    • 垂直布局中:宽度为“自动”,高度为400 像素
    • 网格布局中:宽度800 像素,高度400 像素要设置最小值或最大值,请单击三点图标 (...)。

模板

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

    对齐方式取决于为父元素选择的布局(垂直水平)。

  • “布局” - 确定模板中控件的定位方式:
    • “水平/垂直”- 控件的方向。
    • “对齐” - 模板中控件的对齐方式。
    • “允许换行” - 如果选中,则将模板中的控件换行。
    • “允许滚动” - 如果选中,则允许在模板内滚动。要启用“允许滚动” ,模板必须具有固定高度(垂直布局)或固定宽度(水平布局)。
  • “背景颜色” - 模板的背景颜色。
  • “边框” - 控件的边框。可以配置边框粗细颜色半径
  • “字体” - 模板的字体系列。模板中的所有控件共享相同的字体系列。默认情况下,模板继承自定义列表的字体系列。
  • “边距”- 设置布局的边距。默认情况下,边距设置为 0 像素。“上/下”和“左/右”边距属性结合使用。可以使用“边距”部分右侧的“链接”按钮分离这些属性。
  • “填充” - 模板的填充。默认情况下,填充设置为 16 像素。“上/下”“左/右”边距属性结合使用。可以使用“填充”部分右侧的“链接”按钮分离这些属性。
  • 高级 -显示控件的Flex属性。
    • “Flex 基础” -在分配或撤消额外空间( px%emauto )之前,设置 Flex 项目的原始大小。
    • Flex grow - 当有额外空间可用时,这些值将决定 Flex 项目相对于其余项目应增长的程度。
    • Flex 收缩- 当空间不足时,此值决定弹性项目相对于其他项目应收缩的程度。有关详细信息,请参阅Mozilla 开发者网络文档

VB 属性

属性名称数据类型访问权限示例
Disabled布尔值读取/写入如果为 True,则在 Runtime 禁用该控件。
Hidden布尔值读取/写入如果为 True,则在 Runtime 隐藏该控件。
SelectedItem数据源类型和自定义列表中的控件列表的并集。读取/写入Assuming a scenario in which your Data Source is an entity, to access the entity row:
MainPage.CustomList.SelectedItem.data
Assuming a scenario in which a Date Picker is in your Custom List, to access the value of the Date Picker control:
MainPage.CustomList.SelectedItem.Datepicker.value
SelectedItemIndex整数只读返回当前选定行的索引: MainPage.CustomList.SelectedItemIndex
ThisRow“数据源”字段相同。只读引用数据源的当前记录。使用它来配置“自定义列表”中的字段。

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

数据源是实体

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

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

ThisRow.Firstname
ThisRow.Firstname

数据源为数据表

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

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

ThisRow("FieldName")
ThisRow("FieldName")

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

此页面有帮助吗?

连接

需要帮助? 支持

想要了解详细内容? UiPath Academy

有问题? UiPath 论坛

保持更新