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 of y 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 '|');
