向图表添加参考线
参考线是用来将图表上的数据与参考值进行比较的竖直或水平标记。参考线是相对于轴上的特定值设置的虚线。这些线通过相对于以下一个或多个常量值来直观显示图表数据，从而可增加其他上下文：
• 性能指标或阈值
• 最小值或最大值
• 平均值
 |
不能在具有次要 Y 轴的图表上显示参考线。
|
可使用 ReferenceLineNValue 属性设置参考线的值。要根据图表中的动态值显示参考线，请将数据服务中的参数绑定到该属性。下图显示了 Y 轴上有两条参考线的条形图小组件。
您可以根据图表类型和轴数据类型在 X 或 Y 轴上显示参考线。只能针对连续类型数据显示参考线，如数值或日期值。您可以在以下图表小组件上显示参考线：
• 条形图
• 折线图
• 瀑布图
• 日程安排图
| | 帕累托图仅支持对阈值显示参考线。 |
要向图表中添加参考线：
1. 在工作区中选择标准图表小组件或使用“资源管理器”面板。小组件属性将在“属性”面板上列出。
2. 在“属性”面板上，使用 NumberofReferenceLines 属性指定要在图表中显示的参考线的数量。最多可以添加 24 条线。将显示每条参考线的附加配置属性。
3. 使用以下属性配置图表上的每条参考线：
◦ ReferecneLineNLabel - 输入标签以在图表上的参考线旁显示标签。
◦ ReferecneLineNValue - 设置参考线的数据值。
◦ ReferenceLineNAxis - 指定要显示参考线的图表轴。仅当图表有两个具有连续数据的轴时，才会显示此属性。
4. 单击“保存”以保存对混搭上的小组件所做的更改。
下表列出了用于在支持的图表上配置参考线的属性：
属性名称 | 说明 | 基本类型 | 默认值 | 可绑定 | 可本地化 |
|---|---|---|---|---|---|
NumberOfReferenceLines | 指定要在图表上显示的参考线的数量。最多可以添加 24 条参考线。将添加每条参考线的附加属性。 | NUMBER | 0 | Y | N |
ReferecneLineNLabel | 设置参考线的文本。 | STRING | 不适用 | Y | Y |
ReferecneLineNValue | 设置参考线的值。您可以根据轴类型指定数值或日期值。如果指定的值超出图表的数据范围，则不会显示参考线。 | 数字或日期时间 | 0 | Y | N |
ReferenceLineNAxis | 指定要用于参考线的轴。仅当图表包含两个具有连续数据 (如数值或日期) 的轴时，此属性才可用。指定用于显示参考线 N 的轴。 | STRING | X 轴 | N | N |
| | 对于显示时非常靠近的一些参考线，若其标签在运行时相互重叠，则会自动隐藏这些参考线。当放大图表或更改数据范围后有足够间距显示两个标签时，会显示隐藏的线。 |
当两个参考线非常靠近且线标签相互重叠时，将隐藏其中一个阈值标签。只有缩放图表或更改数据范围之后有足够间距来呈现两个标签时，才会显示该标签。
向图表中添加竖直参考线
使用小组件“属性”面板上的 ReferenceLineNAxis 属性可水平或竖直显示参考线。下图显示了设置为散点图类型的折线图小组件。
在本示例中，散点图中有两个包含数值的轴，您可以将每个参考线显示在 X 轴或 Y 轴上。