自定义列表

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

属性

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

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

此行

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

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

限制

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

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

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

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

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

常规

自定义列表

• “隐藏” - 如果设置为“True”，则在运行时隐藏该控件。
• 已禁用- 如果设置为 False，则应用程序用户可以与列表交互。如果设置为“true”，则列表处于只读状态。

模板

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

Events

自定义列表

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

模板

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

样式

自定义列表

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

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

• “布局” - 在自定义列表中自定义模板位置：
  • 垂直- 模板垂直排列
  • 水平- 模板水平排列（垂直或水平）
  • 网格- 模板以网格格式排列（垂直或水平）
  • 间距（仅像素）- 以垂直或水平布局排列时，模板之间的间距。
  • 水平/垂直间距- 在网格布局中排列时，模板之间的水平和垂直间距。
  • “模板宽度” - 模板的宽度。
  • “模板高度” - 模板的高度。
  备注：

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

模板

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

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

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

VB 属性

展开表格

属性名称	数据类型	访问权限	示例
Disabled	布尔值	读取/写入	如果为 True，则在 Runtime 禁用该控件。
Hidden	布尔值	读取/写入	如果为 True，则在 Runtime 隐藏该控件。
SelectedItemIndex	整数	只读	返回当前选定行的索引： MainPage.CustomList.SelectedItemIndex
ThisRow	与“数据源”字段相同。	只读	引用数据源的当前记录。使用它来配置“自定义列表”中的字段。