AxisScaleBreakStyle 类

定义

命名空间:

System.Web.UI.DataVisualization.Charting

程序集:

System.Web.DataVisualization.dll

表示图表 Y 轴上的刻度分隔线。

public ref class AxisScaleBreakStyle

public class AxisScaleBreakStyle

type AxisScaleBreakStyle = class

Public Class AxisScaleBreakStyle

继承

Object

AxisScaleBreakStyle

示例

下面的代码示例演示如何在控件添加到设计图面后启用和 Chart 自定义刻度中断。

Imports System.Web.UI.DataVisualization.Charting  

Private Function AddChartData()   

    chart1.Series("Default").Points.Add(New DataPoint(1, 2))   
    chart1.Series("Default").Points.Add(New DataPoint(2, 4))   
    chart1.Series("Default").Points.Add(New DataPoint(3, 400000))   
    chart1.Series("Default").Points.Add(New DataPoint(4, 3))   

End Sub  

Private Function AddScaleBreaks()  

   ' Enable scale breaks.  
   chart1.ChartAreas("Default").AxisY.ScaleBreakStyle.Enabled = True   

   ' Show scale break if more than 25% of the chart is empty space.       
   chart1.ChartAreas("Default").AxisY.ScaleBreakStyle.CollapsibleSpaceThreshold = 25   

   ' Set the line width of the scale break.      
   chart1.ChartAreas("Default").AxisY.ScaleBreakStyle.LineWidth = 2   

   ' Set the color of the scale break.   
   chart1.ChartAreas("Default").AxisY.ScaleBreakStyle.LineColor = Color.Red   

   ' If all data points are significantly far from zero, the chart will calculate the scale minimum value.   
   chart1.ChartAreas("Default").AxisY.ScaleBreakStyle.StartFromZero = StartFromZero.Auto  

   ' Set the spacing gap between the lines of the scale break (as a percentage of the Y-axis).  
   chart1.ChartAreas["Default"].AxisY.ScaleBreakStyle.Spacing = 2;  

End Function  

using System.Web.UI.DataVisualization.Charting  

private void AddChartData()  
{  
   chart1.Series["Series1"].Points.Add(new DataPoint(1, 2));  
   chart1.Series["Series1"].Points.Add(new DataPoint(2, 4));  
   chart1.Series["Series1"].Points.Add(new DataPoint(3, 400000));  
   chart1.Series["Series1"].Points.Add(new DataPoint(4, 3));  
}  

private void AddScaleBreaks()  
{  
   // Enable scale breaks.  
   chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.Enabled = true;  

   // Show scale break if more than 25% of the chart is empty space.  
   chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.CollapsibleSpaceThreshold = 25;  

   // Set the line width of the scale break.  
   chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.LineWidth = 2;  

   // Set the color of the scale break.  
   chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.LineColor = Color.Red;  

   // If all data points are significantly far from zero, the chart will calculate the scale minimum value.  
   chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.StartFromZero = StartFromZero.Auto;  

   // Set the spacing gap between the lines of the scale break (as a percentage of the Y-axis).  
    chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.Spacing = 2;  
}  

注解

刻度中断是 Y 轴上的有意中断，通常用于在图表上重新分发序列中的数据点。 当所绘制的一个序列中数据的高值和低值之间存在较大差异时，此功能可提高可读性。 对于多个序列中数据之间的差异，不会绘制刻度中断。

默认情况下，刻度中断处于禁用状态。 可以通过将 属性设置为 ，在 Y 轴上 Enabled 启用刻度中断 true 。 若要更改刻度中断的垂直空间量，可以指定 Spacing 一个值。 这以 Y 轴刻度的百分比计算。

在单个序列中数据点的范围之间必须有足够的分隔符，以绘制刻度分隔线。 默认情况下，数据区域之间的分隔空间至少占图表总空间的 25% 时，才能添加刻度分隔线。 如果启用刻度中断但不显示，即使数据范围之间有足够的距离，也可以将 属性设置为小于 CollapsibleSpaceThreshold 25 的值。

图表支持每个图表最多五个刻度中断;但是，如果显示多个刻度中断，则图表可能变为不可读。 如果有两个以上数据区域，可以考虑使用不同方法显示此数据。 使用 MaxNumberOfBreaks 属性可以减少可在图表上显示的刻度中断数。

使用刻度中断时，Y 轴标签可能会成为偏移量。 若要禁用标签偏移量，将 IsStaggered 属性设置为 false 。

以下任一情况下都不支持刻度中断：

• 使用饼图、圆环图、漏斗图、棱锥图、径向图或任何堆积图类型。

• 启用标签、刻度线或网格线的自定义间隔。

• 设置轴的最小值或最大值。

• 使用自定义标签。

• 指定了对数 Y 轴。

• 使用 Y 轴上的轴视图（包括滚动和缩放）。

• 使用三维图表。

构造函数

AxisScaleBreakStyle()

初始化 AxisScaleBreakStyle 类的新实例。

属性

BreakLineStyle	获取或设置将用于绘制刻度分隔线的分隔线的样式。
CollapsibleSpaceThreshold	获取或设置图表上将绘制刻度分隔线处的空间的阈值。
Enabled	获取或设置一个标志，该标志指示是否启用刻度分隔线。
LineColor	获取或设置刻度分隔线的颜色。
LineDashStyle	获取或设置刻度分隔线的样式。
LineWidth	获取或设置刻度分隔线的宽度。
MaxNumberOfBreaks	获取或设置要在图表上显示的最多刻度分隔线数。
Spacing	获取或设置刻度分隔线之间的间距。 该间距以 Y 轴的百分比表示。
StartFromZero	获取或设置一个 StartFromZero 枚举值，该值指示是否从零开始刻度分隔。

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)