# 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 of y values' (第 x 個值，共 y 個值) 的格式。預設為 6。
* state\_name：為特定視覺化選擇的替代狀態名稱。如果使用 state\_name 引數，則只會考慮與指定州名相關的選項。如需詳細資訊，請參閱[輪替狀態機](https://help.qlik.com/zh-TW/qlikview/September2026/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 '|');`