GetCurrentSelections - 圖表函數
GetCurrentSelections() 傳回應用程式中的目前選項清單。若改為在搜尋方塊中使用搜尋字串進行選取,則 GetCurrentSelections() 會傳回搜尋字串。
若選項已使用,您必須指定 record_sep。若要指定新的行,請將 record_sep 設為 chr(13)&chr(10)。
若只有兩個或一個值未選取,會分別使用格式「NOT x,y」或「NOT y」。若選取所有值,且所有值的計數大於 max_values,則會傳回文字 ALL。
語法:
GetCurrentSelections ([record_sep [, tag_sep [, value_sep [, max_values [, state_name]]]]])
傳回的資料類型: 字串
引數:
引數 | 描述 |
---|---|
record_sep | 置於欄位記錄之間的分隔符號。預設為 <CR><LF>,表示新行。 |
tag_sep | 置於欄位名稱標記和欄位值之間的分隔符號。預設為「: 」。 |
value_sep | 要置於欄位值之間的分隔符號。預設為 ', '。 |
max_values | 要個別列出的欄位值上限。要個別列出的欄位值上限。 若選取大量的值,則會改用 'x of y values' (第 x 個值,共 y 個值) 的格式。預設為 6。 |
state_name |
為特定視覺化選擇的替代狀態名稱。如果使用 state_name 引數,則只有與指定狀態名稱關聯的選項才會納入考量。 如需詳細資訊,請參閱將替代狀態用於比較分析。 |
範例與結果:
以下範例使用載入至不同篩選窗格的兩個欄位,一個用於 First name 名字,另一個用於 Initials。
範例 | 結果 |
---|---|
假定已在 First name 中選取 John。 GetCurrentSelections () |
'First name: John' |
假定已在 First name 中選取 John 和 Peter。 GetCurrentSelections () |
'First name: John, Peter' |
假定已在 First name 中選取 John 和 Peter、且在 Initials 中選取 JA。 GetCurrentSelections () |
'First name: John, Peter Initials: JA' |
假定已在 First name 中選取 John、且在 Initials 中選取 JA。 GetCurrentSelections ( chr(13)&chr(10) , ' = ' ) |
'First name = John Initials = JA' |
假定您已在 First name 中選取了 Sue 以外的所有名字,且未選取 Initials 中的任何選項。 GetCurrentSelections (chr(13)&chr(10), '=', ',' ,3) |
'First name=NOT Sue' |
範例中使用的資料:
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 '|');