# 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-CN/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 '|');`