盟威 Access 快速开发平台 \ 在线帮助中心 \ 函数目录 \ MultiSelectFor 函数

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 引入。