StripLine 클래스

정의

네임스페이스:

System.Web.UI.DataVisualization.Charting

어셈블리:

System.Web.DataVisualization.dll

차트의 줄무늬를 나타냅니다.

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 속성을 하나 제거 그려집니다. 0이 아닌 값에 할당 되 면는 Interval 속성인 줄무늬 선을 그릴 반복적으로 지정 된 간격 마다. 줄무늬 그려지는 위치에 따라서도 합니다 IntervalOffset 및 IntervalOffsetType 줄무늬의 속성입니다.

줄무늬 선은 항상 연관 된 Axis 개체입니다. 디자인 타임 및 런타임 모두에 추가할 수 있습니다.

임계값을 표시 하려면 가로 또는 세로 줄을 추가 하려면 설정의 StripWidth 속성 값이 0.0 합니다. 그러면 선이 그려집니다. 사용할 수는 BorderColor, BorderDashStyle 및 BorderWidth 색, 너비, 줄의 스타일 속성입니다. 차트 배경 속성이 없습니다 (Back*) 경우 사용 되는 StripWidth 0.0으로 설정 된 속성입니다.

사용 된 Text 줄무늬를 사용 하 여 텍스트를 연결 하는 줄무늬 선의 속성입니다. 이 텍스트의 방향을 확인 하 고 배치를 통해 제어할 수는 TextAlignment 속성입니다.

동일한 축에 대 한 여러 줄무늬 선을 정의 된 경우에 줄무늬 선을 겹쳐질 수 있습니다. Z 순서 StripLine 개체에는 발생 순서에 따라 결정 됩니다는 StripLinesCollection 개체입니다. 즉, 처음 먼저 그려지는 두 번째, 두 번째 발생이 그려집니다.

줄무늬 선을 차트 종류에 대 한 지원 되지 않습니다: 원형, 도넛형, 깔때기형, 피라미드형, 카 기, 삼 선 전환, 요소 및 그림, 극좌표 형 및 방사형 합니다.

생성자

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)