# ValueList - 圖表函數

ValueList() 傳回一組列出的值，當用於計算維度時，可形成合成維度。

資訊備註圖表中若有以 ValueList 函數建立的合成維度，可使用圖表運算式中相同的參數來重新指明 ValueList 函數，即可參考對應特定運算式儲存格的維度值。 此函數當然可以用於版面配置中的任何地方，但除了可用於合成維度之外，只有在彙總函數內才有意義。

資訊備註合成維度不受選項影響。

語法：

ValueList(v1 {,...})

傳回的資料類型： 雙值

引數：

引數

| 引數 | 描述 |
| --- | --- |
| v1 | 靜態值 (通常為字串，也可以是數字)。 |
| {,...} | 靜態值的選用清單。 |

範例與結果：

函數範例

| 範例 | 結果 |
| --- | --- |
| `ValueList('Number of Orders', 'Average Order Size', 'Total Amount')` | 用來在表格中建立維度時，舉例來說，此函數會產生三個字串值作為表格中的列標籤。這些值可提供運算式參考。 |
| `=IF( ValueList('Number of Orders', 'Average Order Size', 'Total Amount') = 'Number of Orders',<br>							count(SaleID), IF( ValueList('Number of Orders', 'Average Order Size', 'Total Amount') = 'Average Order Size',<br>avg(Amount),<br>sum(Amount)<br><br>))<br>` | 此運算式使用來自所建立維度的值，並在巢狀 IF 陳述式中將這些值參考為三個彙總函數的輸入：<br><br><br>![](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ex_gen_ChartSynthDim.png) |

範例中使用的資料：

`SalesPeople:
` `LOAD * INLINE  [
` `SaleID|SalesPerson|Amount|Year
` `1|1|12|2013` `
2|1|23|2013
` `3|1|17|2013
` `4|2|9|2013
` `5|2|14|2013
` `6|2|29|2013
` `7|2|4|2013` `
8|1|15|2012` `
9|1|16|2012
` `10|2|11|2012
` `11|2|17|2012
` `12|2|7|2012` `
] (delimiter is '|');`