多选下拉菜单

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

常规

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

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

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

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

Events

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

样式

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

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

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

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

VB 属性

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