MultiSelectFor 函数
简介
在指定控件(一般为文本框)下方显示多值选择列表,将选中的值以指定字符分隔合并为一个字符串,返回给指定的控件。“通用多值选择器”组件的接口函数。
语法
MultiSelectFor(InputCtl, ValueSource[, Delimiter])
输入参数
参数名称 | 必需/可选 | 数据类型 | 说明 |
---|---|---|---|
InputCtl | 必需 | Control | 用于接收输入的控件,一般是文本框(TextBox)。 |
ValueSource | 必需 | String | 值来源,可以是一个值列表,也可以是一个以 SELECT 开头的 SQL 语句。 |
Delimiter | 可选 | String | 指定返回的多值字符串用什么字符进行分隔。缺省时默认使用逗号+空格(, )。 |
返回值
无
说明
选择一个或多个值选择后会自动将选中的值合并为一个字符串,以 Delimiter 参数指定的分隔符进行分隔,向 InputCtl 指定的控件的 Text 属性赋值。因此这里不影响该属性的更新后事件。
一般 InputCtl 参数最好是一个文本框,用来接收输入。可以在文本框左侧添加一个按钮,在按钮的单击调用;也可以直接在文本框的单击或双击事件调用。
相关
示例
'在事件过程中用代码调用: Private Sub btnSelectUser_Click() MultiSelectFor Me.txtUserName, "SELECT Username FROM Sys_Users" End Sub '直接在事件属性中设置表达式调用: 属性表 -> 事件 -> 单击,设为: =MultiSelectFor([txtUserName], "SELECT Username FROM Sys_Users")
修订记录
2019-07-08 v2.5.0 引入。