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]]]])
傳回的資料類型: 字串
引數:
- record_sep:置於欄位記錄之間的分隔符號。預設為 <CR><LF>,表示新行。
- tag_sep:置於欄位名稱標記和欄位值之間的分隔符號。預設為「: 」。
- value_sep: 要置於欄位值之間的分隔符號。預設為 ', '。
- max_values: 要個別列出的欄位值上限。若選取大量的值,則會改用 'x of y values' (第 x 個值,共 y 個值) 的格式。預設為 6。
範例
以下範例使用載入至不同列表框的兩個欄位,一個用於 First name 名字,另一個用於 Initials。
範例 1: 已在 First name 中選取 John
GetCurrentSelections ()
傳回 'First name: John'。
範例 2: 假定已在 First name 中選取 John 和 Peter。
GetCurrentSelections ()
傳回 'First name: John, Peter'。
範例 3: 已在 First name 中選取 John 並且已在 Initials 中選取 JA。
GetCurrentSelections ()
傳回 'First name: John; Peter 和 Initials: JA'。
範例 4: 已在 First name 中選取 John 並且已在 Initials 中選取 JA。
GetCurrentSelections ( chr(13)&chr(10) , ' = ' )
傳回 'First name = John 和 Initials = JA'。
範例 5: 已在 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 '|');