# 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，则返回的字符串是选定值的列表。<br><br>这些值用 value\_sep 作为分隔符分隔。 |
| 'NOT a, b, c' | 如果未选定值的数量等于或小于 max\_values，则返回的字符串是未选定值的列表，以 NOT 作为前缀。<br><br>这些值用 value\_sep 作为分隔符分隔。 |
| 'x of y' | x = 选定值的数目<br><br>y = 值的总数<br><br>这将在 max\_values &lt; x &lt; ( y - max\_values) 返回。 |
| 'ALL' | 在选定了所有值时返回。 |
| '-' | 在未选定值时返回。 |
| &lt;search string&gt; | 如果选择了使用搜索，则返回搜索字符串。 |

参数：

* field\_name： 包含要度量的数据范围的字段。
* value\_sep： 置于字段值之间的分隔符。默认分隔符为“,”。
* max\_values： 将会单独列出字段值的最大数字。当选择更大的字段值数量时，会改用“x 个值，共 y 个”格式。默认值为 6。
* state\_name：已为特定可视化选择的替代状态的名称。如果使用 state\_name 参数，则只考虑与指定状态名称相关的选择项状态。有关更多信息，请参阅[替代状态](https://help.qlik.com/zh-CN/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/Alternate%20States.htm)。

## 示例

以下示例使用加载到列表框中的 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 '|');`