多选下拉菜单

可以使用数组填充“下拉多选”控件的选项。

常规

• “列表来源”- 要在多选下拉列表中显示的项目来源。有效的数据类型包括字符串数组、整数、日期时间、数据表或对象数组。
• “列”- 当列表来源的类型为“数据表”或“对象”数组时，选择特定列（适用于数据表数据类型）或特定属性（适用于对象数组）。
• “提示文本”- 要在 Runtime 显示的帮助文本。
• “默认选定值”- 要在 Runtime 显示的默认值。
• “工具提示”- 当应用程序用户将鼠标悬停在控件上时要显示的文本。使用此选项可提供有关控件的其他信息。
• “标签”- 控件的显示文本。
• “必需”- 如果为 True，则应用程序用户必须在控件中提供数据。要在 Runtime 将控件标记为必需，请在标签文本后添加星号 *。

• “自定义错误消息”- 当“必需”属性设置为 True 且控件留空时要显示的文本。

• 隐藏 - 如果为 true，则在 Runtime 隐藏该控件。

• “已禁用”- 如果为 True，则在 Runtime 禁用该控件。

Events

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

样式

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

  注意：对齐方式取决于为父元素选择的布局（垂直与水平）。
• “标签放置”- 默认情况下，标签设置为显示在控件顶部的左侧。您可以将其放置在控件的左侧同一行。“标签宽度”属性配置标签的宽度，“间距”属性设置标签和控件之间的距离。
• “背景颜色”- 控件的背景颜色。

• “字体”- 标签和输入文本的字体属性，例如字体系列、大小、颜色或样式（粗体、斜体和下划线）。默认情况下，控件会继承直属父容器的字体系列，这由关键字“已继承”指示。

• “边距”- 控件的边距。默认情况下，边距设置为 4 像素。“上/下”和“左/右”边距属性结合使用。可以使用“边距”部分右侧的“链接”按钮分离这些属性。
• “大小”- 控件的宽度和高度。默认情况下，大小设置为 auto。要设置最小值或最大值，请单击三点图标 (...)。

VB 属性

VB 属性	数据类型	描述
Tooltip	字符串	当用户将鼠标悬停在 多选下拉列表上时，显示的信息文本。
Label	字符串	多选下拉列表的标签，通常是在控件之前显示的文本。
HintText	字符串	多选下拉列表中显示的占位符文本。
SelectedItems	System.Collections.Generic.List(Of Apps.Controls.TabularInitClass)	当前在多选下拉列表中选择的项目。
DataSource	Apps.Controls.ListSource(Of Apps.Controls.TabularInitClass)	“多选下拉列表”中值的数据源。
Value	System.Collections.Generic.List(Of Apps.Controls.TabularInitClass)	当前在多选下拉列表中选择的项目。
Required	布尔值	指定是否必须选择“多选下拉列表”值。
RequiredErrorMessage	字符串	多选下拉列表值是必需的但未提供时显示的消息。
Hidden	布尔值	确定多选下拉列表的可见性。 如果设置为 True，则在 Runtime 隐藏该控件。
Disabled	布尔值	确定“多选下拉列表”是否可交互。 如果设置为 True，则在运行时禁用“下拉多选”。
IsValid	布尔值	检查“多选下拉列表”值的有效性。 如果为 true，则表示它有效。
示例表达式	AppsDataSource.from(New List(Of String) From {"Value 1", "Value 2", "Value 3"})	在运行时向“多选下拉列表” 添加一组值。