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 . Если свойству Interval присваивается значение -1, будет нарисована одна полосовая линия. Если свойству 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)