StripLine 类

参考

定义

命名空间:: System.Web.UI.DataVisualization.Charting

程序集:: System.Web.DataVisualization.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

表示图表上的带状线。

public ref class StripLine : System::Web::UI::DataVisualization::Charting::ChartElement, System::Web::UI::DataVisualization::Charting::IChartMapArea

public class StripLine : System.Web.UI.DataVisualization.Charting.ChartElement, System.Web.UI.DataVisualization.Charting.IChartMapArea

type StripLine = class
    inherit ChartElement
    interface IChartMapArea

Public Class StripLine
Inherits ChartElement
Implements IChartMapArea

继承: Object

ChartElement
StripLine

实现: IChartMapArea

示例

下面的代码示例演示条带线的三个应用。首先，定期添加水平带线。其次，添加垂直带状线以突出显示周末数据点。最后，添加一条非重复带状线来表示图表第一个系列中的数据点的平均值。

Imports System.Web.UI.DataVisualization.Charting  

Public Partial Class StripLines   
    Inherits System.Web.UI.Page   
    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)  

        ' Add chart data before adding strip lines.   
        AddChartData()   

        ' Adds repeating horizontal strip lines.   
        AddHorizRepeatingStripLines()   

        ' Highlights weekend points using strip lines.   
        HighlightWeekendsWithStripLines()   

        ' Adds a threshold line using strip lines.   
        AddThresholdStripLine()   
    End Sub   

    ' Adds a week of data with values between 20 and 35.   
    Private Sub AddChartData()   
        ' Declare new random variable   
        Dim rand As New Random()   
        For i As Integer = 0 To 6   

            ' Add a week of data   
            chart1.Series(0).Points.AddXY(DateTime.Now.AddDays(i), rand.[Next](20, 35))   
        Next   
    End Sub   

    ' Adds repeating horizontal strip lines at intervals of 5.   
    Private Sub AddHorizRepeatingStripLines()   
        ' Instantiate new strip line   
        Dim stripLine1 As New StripLine()  
        stripLine1.StripWidth = 2.5   
        stripLine1.Interval = 5   

        ' Consider adding transparency so that the strip lines are lighter   
        stripLine1.BackColor = Color.FromArgb(120, Color.Red)   

        ' Add the strip line to the chart   
        chart1.ChartAreas(0).AxisY.StripLines.Add(stripLine1)   
    End Sub   

    ' Adds strip lines to highlight weekend values.   
    Private Sub HighlightWeekendsWithStripLines()   
        ' Set strip line to highlight weekends   
        Dim stripLine2 As New StripLine()   
        stripLine2.BackColor = Color.FromArgb(120, Color.Gold)   
        stripLine2.IntervalOffset = -1.5   
        stripLine2.IntervalOffsetType = DateTimeIntervalType.Days   
        stripLine2.Interval = 1   
        stripLine2.IntervalType = DateTimeIntervalType.Weeks   
        stripLine2.StripWidth = 2   
        stripLine2.StripWidthType = DateTimeIntervalType.Days   

        ' Add strip line to the chart   
        chart1.ChartAreas(0).AxisX.StripLines.Add(stripLine2)   

        ' Set the axis label to show the name of the day   
        ' This is done in order to demonstrate that weekends are highlighted   
        chart1.ChartAreas(0).AxisX.LabelStyle.Format = "ddd"   
    End Sub   

    ' Adds a horizontal threshold strip line at the mean value of the first series.  
    Private Sub AddThresholdStripLine()   
        Dim stripLine3 As New StripLine()   

        ' Set threshold line so that it is only shown once   
        stripLine3.Interval = 0   

        ' Set the threshold line to be drawn at the calculated mean of the first series   
        stripLine3.IntervalOffset = chart1.DataManipulator.Statistics.Mean(chart1.Series(0).Name)   

        stripLine3.BackColor = Color.DarkGreen   
        stripLine3.StripWidth = 0.25   

        ' Set text properties for the threshold line   
        stripLine3.Text = "Mean"   
        stripLine3.ForeColor = Color.Black   

        ' Add strip line to the chart   
        chart1.ChartAreas(0).AxisY.StripLines.Add(stripLine3)   
    End Sub   
End Class

public partial class StripLines : System.Web.UI.Page   
    {  
        protected void Page_Load(object sender, EventArgs e)  
        {              
            // Add chart data  
            AddChartData();  

            // Adds repeating horizontal strip lines.  
            AddHorizRepeatingStripLines();  

            // Highlights weekend points using strip lines.  
            HighlightWeekendsWithStripLines();  

            // Adds a threshold line using strip lines.  
            AddThresholdStripLine();  
        }  

        /// <summary>  
        /// Adds a week of data with values between 20 and 35.  
        /// </summary>  
        private void AddChartData()  
        {  
            // Declare new random variable  
            Random rand = new Random();  

            // Add a week of data  
            for (int i = 0; i < 7; i++)   
            {  
                chart1.Series[0].Points.AddXY(DateTime.Now.AddDays(i), rand.Next(20,35));  
            }  
        }  

        /// <summary>  
        /// Adds repeating horizontal strip lines at intervals of 5.  
        /// </summary>  
        private void AddHorizRepeatingStripLines()  
        {  
            // Instantiate new strip line  
            StripLine stripLine1 = new StripLine();  
            stripLine1.StripWidth = 0;  
            stripLine1.BorderColor = Color.Black;  
            stripLine1.BorderWidth = 3;  
            stripLine1.Interval = 5;  

            // Consider adding transparency so that the strip lines are lighter  
            stripLine1.BackColor = Color.FromArgb(120, Color.Red);  

            stripLine1.BackSecondaryColor = Color.Black;  
            stripLine1.BackGradientStyle = GradientStyle.LeftRight;  

            // Add the strip line to the chart  
            chart1.ChartAreas[0].AxisY.StripLines.Add(stripLine1);  
        }  

        /// <summary>  
        /// Adds strip lines to highlight weekend values.  
        /// </summary>  
        private void HighlightWeekendsWithStripLines()  
        {  
            // Set strip line to highlight weekends  
            StripLine stripLine2 = new StripLine();  
            stripLine2.BackColor = Color.FromArgb(120, Color.Gold);              
            stripLine2.IntervalOffset = -1.5;  
            stripLine2.IntervalOffsetType = DateTimeIntervalType.Days;  
            stripLine2.Interval = 1;  
            stripLine2.IntervalType = DateTimeIntervalType.Weeks;  
            stripLine2.StripWidth = 2;  
            stripLine2.StripWidthType = DateTimeIntervalType.Days;  

            // Add strip line to the chart  
            chart1.ChartAreas[0].AxisX.StripLines.Add(stripLine2);  

            // Set the axis label to show the name of the day  
            // This is done in order to demonstrate that weekends are highlighted  
            chart1.ChartAreas[0].AxisX.LabelStyle.Format = "ddd";  
        }  

        /// <summary>  
        /// Adds a horizontal threshold strip line at the calculated mean   
        /// value of all data points in the first series of the chart.  
        /// </summary>  
        private void AddThresholdStripLine()  
        {  
            StripLine stripLine3 = new StripLine();  

            // Set threshold line so that it is only shown once  
            stripLine3.Interval = 0;  

            // Set the threshold line to be drawn at the calculated mean of the first series  
            stripLine3.IntervalOffset = chart1.DataManipulator.Statistics.Mean(chart1.Series[0].Name);  

            stripLine3.BackColor = Color.DarkGreen;  
            stripLine3.StripWidth = 0.25;  

            // Set text properties for the threshold line  
            stripLine3.Text = "Mean";  
            stripLine3.ForeColor = Color.Black;  

            // Add strip line to the chart  
            chart1.ChartAreas[0].AxisY.StripLines.Add(stripLine3);  
        }  
    }

注解

带状线（或带）是水平或垂直范围，以常规或自定义间隔为图表背景着色。可以使用条带线执行以下操作：

提高在图表上查找各个值时的可读性。
读取图表时分隔数据点。
突出显示定期发生的日期，例如，标识周末数据点。
突出显示特定的关键数据范围。
在特定的常量值处添加阈值线。

StripLine单个对象可以绘制一次，也可以重复绘制给定间隔。此操作由 Interval 属性控制。将值 -1 分配给 Interval 属性时，将绘制一条带状线。将非零值赋给 Interval 属性时，将在每个给定间隔重复绘制带状线。条带线的绘制位置也受 IntervalOffset 条带线的和 IntervalOffsetType 属性的影响。

条带线始终与对象 Axis 关联。可以在设计时和运行时添加它们。

若要添加水平线或垂直线以显示阈值，请将 StripWidth 属性设置为值 0.0。这将导致绘制一条线。可以将 BorderColor、 BorderDashStyle 和 BorderWidth 属性用于线条的颜色、宽度和样式。当属性设置为 0.0 时StripWidth，不使用图表背景属性 (Back*) 。

Text使用带状线的属性将文本与带状线相关联。此文本的位置和方向可由属性控制 TextAlignment 。

为同一轴定义多个带状线时，条带线可能会重叠。对象的 Z 顺序 StripLine 由它们在对象中的 StripLinesCollection 出现顺序决定。这意味着首先绘制第一个匹配项;第二个匹配项绘制为第二个匹配项，依此以类比。

以下图表类型不支持带状线：饼图、圆环图、漏斗图、棱锥图、Kagi、ThreeLineBreak、PointAndFigure、Polar 和 Radar。

构造函数

StripLine()

初始化 StripLine 类的新实例。

属性

BackColor	获取或设置带状线的背景色。
BackGradientStyle	获取或设置带状线的渐变样式。
BackHatchStyle	获取或设置带状线的阴影样式。
BackImage	获取或设置带状线的背景图像。
BackImageAlignment	获取或设置背景图像对齐方式。
BackImageTransparentColor	获取或设置带状线背景图像的颜色，该颜色将实现为透明效果。
BackImageWrapMode	获取或设置带状线的背景图像的绘制模式。
BackSecondaryColor	获取或设置带状线背景的辅助颜色。
BorderColor	获取或设置带状线的边框颜色。
BorderDashStyle	获取或设置带状线的边框样式。
BorderWidth	获取或设置带状线的边框宽度。
Font	获取或设置用于带状线文本的字体。
ForeColor	获取或设置带状线文本的颜色。
Interval	获取或设置带状线的间隔，并确定带状线是绘制一次还是重复绘制。
IntervalOffset	获取或设置网格线、刻度线、带状线和轴标签的偏移量。
IntervalOffsetType	获取或设置带状线的间隔偏移量类型。
IntervalType	获取或设置 StripLine 对象的间隔类型。
MapAreaAttributes	获取或设置带状线的映射区特性。
Name	获取带状线的名称。
PostBackValue	获取或设置在发生 Click 事件时，可以处理的回发值。
StripWidth	获取或设置带状线的宽度。
StripWidthType	获取或设置 StripWidth 属性的度量单位。
Tag	获取或设置与此图表元素关联的对象。 (继承自 ChartElement)
Text	获取或设置带状线的文本。
TextAlignment	获取或设置带状线的文本对齐方式。
TextLineAlignment	获取或设置带状线文本的文本行对齐方式。
TextOrientation	获取或设置文本方向。
ToolTip	获取或设置带状线的工具提示。
Url	获取或设置带状线的目标 URL 或定位点。

方法

Dispose()	释放由 ChartElement 占用的资源。 (继承自 ChartElement)
Dispose(Boolean)	释放由 StripLine 占用的非托管资源，还可以另外再释放托管资源。
Equals(Object)	确定指定的 Object 是否等同于当前的 ChartElement。 (继承自 ChartElement)
GetHashCode()	返回特定类型的哈希算法。 (继承自 ChartElement)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前 Object 的字符串。 (继承自 ChartElement)

适用于

StripLine 类

定义

示例

注解

构造函数

属性

方法

适用于

反馈

其他资源