列表

常规

• “列表来源”- 要在列表中显示的项目来源。有效的数据类型包括字符串数组、整数或日期时间、数据表和对象数组。
• “列”- 当列表来源的类型为“数据表”或“对象”数组时，选择特定列（适用于数据表数据类型）或特定属性（适用于对象数组）。
• “默认选定值”- 要在 Runtime 显示的默认值。
• “工具提示”- 当应用程序用户将鼠标悬停在控件上时要显示的文本。使用此选项可提供有关控件的其他信息。
• 隐藏 - 如果为 true，则在 Runtime 隐藏该控件。
• “已禁用”- 如果为 True，则在 Runtime 禁用该控件。

Events

• “值已更改”- 配置在值更改时会发生的情况。

样式

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

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

• “背景颜色”- 控件的背景颜色。

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

• “字体”- 控件的字体属性，例如字体系列、大小或颜色。默认情况下，控件会继承直属父容器的字体系列，这由关键字“已继承”指示。

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

• “大小”- 控件的宽度和高度。默认情况下，大小设置为 180x200px。要设置最小值或最大值，请单击三点图标 (...)。如果控件的大小小于选项的大小，则系统会显示滚动条。

备注：

虚拟滚动可在 Runtime 仅加载视口中的相关项目，从而提高性能。这仅在配置了高度但未设置为“自动”时有效。

如果将“高度”属性设置为“自动”，则控件在 Runtime 和设计时期间大小可能不匹配。发生这种情况是因为控件高度取决于运行时返回的行数，而在设计时，控件为空。

对于任何具有动态数据的控件（例如表格、下拉列表或列表），我们建议配置固定高度以提高性能。

VB 属性

VB 属性	数据类型	描述
Tooltip	字符串	用户将鼠标悬停在列表上时显示的信息文本 控件。
Value	Apps.Controls.TabularInitClass	列表中当前选定的值。
SelectedItem	Apps.Controls.TabularInitClass	“列表”控件中当前选定的项目。
DataSource	Apps.Controls.ListSource(Of Apps.Controls.TabularInitClass)	“列表” 中值的数据源。
Required	布尔值	指定是否必须选择列表。
RequiredErrorMessage	字符串	当需要列表选择但未提供时显示的消息。
Hidden	布尔值	如果为 True，则在 Runtime 隐藏该控件。
Disabled	布尔值	如果为 True，则在 Runtime 禁用该控件。