Help > 页面报表/RDL报表相关 > 数据可视化工具 >

Data Bar

数据条形图数据可视化显示 96 x 96 dpi 条形图。彩色条从上到下填充图像，而 Value 参数确定要在 Zero 参数右侧（如果是负值则向左）呈现的彩色条的数量。

最小值和最大值参数确定数据范围。Value 参数和最大值参数之间的区域是透明的（如果是负值，则介于值和最小值之间）。

数据栏数据可视化工具在“图像报表控件值”属性以及“文本框”、“复选框”、“形状”和“容器”报表控件的“背景图像 - 值”属性中受支持。

语法

=DataBar(Value, Minimum, Maximum, Zero, Color)
=DataBar(Value, Minimum, Maximum, Zero, Color, Alternate Color)

参数

Value：值。这是要评估的报表中的字段值。数据类型为“单一”。
Minimum：最小值。与 Value 参数进行比较的数据区域中的最小值。此值对应于图像的最左边缘。如果此参数大于 Zero 参数，则 Zero 将等于最小值。数据类型为“单一”。
Maximum：最大值。与 Value 参数进行比较的数据范围内的最大值。此值对应于图像的最右边缘。如果此参数小于 Zero 参数，则 Zero 将等于最大值。数据类型为“单一”。
Zero：零值。此值确定呈现负数据的左侧零点和呈现正数据的右侧零点。数据类型为“单一”。
Color：颜色。用于呈现条形图像中的值的 HTML 颜色字符串。
Alternate Color：备用颜色。当值小于零值（可选）时要使用的 HTML 颜色字符串。
选中“当值小于零值时使用备用颜色”复选框以启用“替代颜色”参数。您可以使用静态值或聚合函数（例如最小值或最大值）来设置参数。有关这些函数和其他聚合函数的详细信息，请参阅通用函数主题。

用法

使用此数据可视化工具以指定颜色呈现条形，条形的长度根据 Value 参数返回的数字而变化，在简单示例 InStock 中。如果数据仅包含正值，则“零值”对应于数据栏左边缘的“最小值”。值和最大值之间的区域是透明的。

简单示例

将 Value 参数设置为数据集中字段的值，以直观地显示字段值。

将下面的值粘贴到文本框的“BackgroundImage”属性下的Value属性中。
=DataBar(Fields!InStock.Value,0,20,0,"BlueViolet")

使用负值的示例

当数据包含负值和正值时，可以选中“当值小于零值时使用备用颜色”复选框，然后选择“替代颜色”。在此示例中，如果“差值”为负值，则以“深红色”呈现，而正值以蓝紫色呈现。您还可以看到负值呈现在零的左侧，正值呈现在右侧。

将下面的值粘贴到文本框的“BackgroundImage”属性下的Value属性中。
=DataBar(Fields!Difference.Value,-10,20,0,"BlueViolet","Crimson")

默认行为

在以下任何情况下，该函数返回 null（即不呈现任何图像）：

1. Maximum小于或等于 Minimum。
2. 表达式放置在不获取图像的属性中。
3. 图像的“Source”属性未设置为“Database”。

如果任何参数的参数无法转换为所需的数据类型，则改用默认值。

参数	默认值
Value	0
Minimum	0
Maximum	0
Zero	0
Color	Green
Alternate Color	null

对话

若要打开对话框，请下拉“文本框”、“复选框”、“形状”和“容器”报表控件的“BackgroundImage”属性，然后点击下面的“Value”属性，然后选择“<数据可视器...>。如果选择 Image 控件并下拉 Value 属性，情况也是如此。若要生成数据可视化工具表达式，请为对话框中的每个选项选择适当的值。