GetFieldSelections
GetFieldSelections() 用于返回包含字段内当前选择项的 string。
如果选择除两个值以外的所有值,或除一个值以外的所有值,则分别使用格式“NOT x,y”或“NOT y”。如果选择全部值,并且全部值的计数大于 max_values,将返回文本 ALL。
语法:
GetFieldSelections ( field_name [, value_sep [, max_values [, state_name]]])
返回数据类型: 字符串
格式 | 说明 |
---|---|
'a, b, c' |
如果选定值的数目为 max_values 或更少,则返回的字符串是选定值的列表。 这些值以 value_sep 分隔符分隔。 |
'NOT a, b, c' |
如果未选定值的数目为 max_values 或更少,则返回的字符串是前缀为 NOT 的未选定值的列表。 这些值以 value_sep 分隔符分隔。 |
'x of y' |
x = 选定值的数目 y = 值的总数 这在 max_values < x < ( y - max_values) 时返回。 |
'ALL' | 选择了所有值时返回。 |
'-' | 未选择值时返回。 |
<search string> | 如果选择了使用搜索,则返回搜索字符串。 |
参数:
- field_name: 包含要度量的数据范围的字段。
- value_sep: 置于字段值之间的分隔符。默认分隔符为“,”。
- max_values: 将会单独列出字段值的最大数字。当选择更大的字段值数量时,会改用“x 个值,共 y 个”格式。默认值为 6。
- state_name: 为特定可视化选择的备用状态的名称。如果使用 state_name 参数,则只考虑与指定状态名关联的选择。更多信息,请参阅替代状态。
示例
下面的示例使用加载到列表框中的 First name 字段。
示例 1: 在 First name 中选择了 John
GetFieldSelections ([First name])
返回“John”
示例 2: 已在 First name 中选择了 John 和 Peter
GetFieldSelections ([First name])
返回“John,Peter”
示例 3: 已在 First name 中选择了 John 和 Peter
GetFieldSelections ([First name],'; ')
返回“John; Peter”
示例 4: 在 First name 中选择了 John、Sue、Mark
GetFieldSelections ([First name],';',2)
返回 “NOT Jane;Peter”,因为值 2 被表述为 max_values 参数的值。否则,结果将为 John; Sue; Mark.
示例中所使用的数据:
Names:
LOAD * inline [
"First name"|"Last name"|Initials|"Has cellphone"
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC |No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');