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 引數，則只有與指定狀態名稱關聯的選項才會納入考量。 如需詳細資訊，請參閱將替代狀態用於比較分析。 |
| 範例 | 結果 |
|---|---|
GetCurrentSelections () | 如果在任何欄位中未進行選取，則傳回 (-)。如果已經進行選取，則傳回的值是欄位名稱和值，例如 First Name : John。 |
範例 - GetCurrentSelections 基礎事項
概述
此範例向您顯示 GetCurrentSelections 函數傳回的值如何根據您所進行的選取而變更。
開啟資料載入編輯器並將下面的載入指令碼新增至新的區段。
載入指令碼包含：
載入到稱為 Example 之資料表格的資料集。
資料表格中的欄位如下：
FirstName
LastName
Initials
HasCellphone
載入指令碼
Example:
LOAD * inline [
FirstName|LastName|Initials|HasCellphone
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 '|');結果
載入資料並開啟工作表。建立新的篩選窗格並將這些欄位新增為維度：
FirstName
Initials
新增 KPI 物件，然後建立以下量值：
=GetCurrentSelections ()，用來尋找目前選項。
由於未選取任何值，KPI 傳回 (-)。
按一下編輯工作表以切換至分析模式，然後在 FirstName 欄位中，選取 John。KPI 傳回下列：FirstName: John。
現在選取 Peter，亦即選取了 John 和 Peter 兩者。KPI 傳回下列：FirstName: John, Peter。
從 Initials 欄位中選取 JA，以新增到選項。KPI 傳回下列：First name: John, Peter Initials: JA。
清除選項並執行以下動作：
從 FirstName 欄位中選取 John，並從 Initials 欄位中選取 JA。
將 KPI 運算式編輯為下列內容：=GetCurrentSelections ( chr(13)&chr(10) , ' = ' )，以將標記分隔符號變更為等號 (=)。
資訊備註KPI 不支援換行和新增空格作為記錄分隔符號。
清除選項並執行以下動作：
選取 FirstName 欄位中除 Sue 之外的所有名稱。
將 KPI 運算式編輯為以下內容：=GetCurrentSelections (chr(13)&chr(10), '=', ',' ,3)，以新增標記分隔符號 (=)、值分隔符號 (,) 以及要列出的值數量上限 (3)。
KPI 傳回值：FirstName=NOT Sue，因為選取了四個名稱，但是 max_values 引數只會列出三個。如果將 max_values 引數變更為 4，則所有四個值將以相同的選項分別列出。
範例 - 自訂圖表標題以顯示選項
概述
此範例向您顯示如何使用 GetCurrentSelections 函數根據使用者選項製作動態圖表標題。
開啟資料載入編輯器並將下面的載入指令碼新增至新的區段。
載入指令碼包含：
載入到稱為 Example 之資料表格的資料集。
資料表格中的欄位如下：
SalesID
Product
Year
Region
SalesAmount
載入指令碼
Example:
LOAD * INLINE [
SalesID, Product, Year, Region, SalesAmount
1, WidgetA, 2021, North, 500
2, WidgetB, 2021, South, 600
3, WidgetC, 2021, East, 450
4, WidgetA, 2021, West, 700
5, WidgetB, 2022, North, 550
6, WidgetC, 2022, South, 425
7, WidgetB, 2022, East, 650
8, WidgetC, 2022, West, 250
9, WidgetB, 2023, North, 650
10, WidgetC, 2023, South, 325
11, WidgetB, 2023, East, 550
12, WidgetC, 2023, West, 450
13, WidgetB, 2024, North, 550
14, WidgetC, 2024, South, 525
15, WidgetB, 2024, East, 350
16, WidgetC, 2024, West, 650
];結果
載入資料並開啟工作表。建立新的篩選窗格並將這些欄位新增為維度：
Region
Year
建立折線圖並新增以下維度：
Year
Region
建立下列量值：
=Sum(SalesAmount)，用來顯示總銷售額。
在量值屬性面板中，於外觀 > 一般 > 標題之下，輸入以下運算式：='Sales Analysis for: ' & GetCurrentSelections()。
結果顯示所有區域和年份的銷售總和。圖表標題顯示為 Sales Analysis for:。
按一下編輯工作表以切換至分析模式，然後進行下列選取：
在區域欄位中選取 East 和 North。
在年份欄位中選取 2022 和 2023。
圖表標題會變更，以顯示 Region 和 Year 的篩選選項。