StripLine Класс

Определение

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 ненулевое значение, линия полосы будет нарисована многократно по каждому заданному интервалу. Расположение, в котором рисуется линия полосы, также влияет на IntervalOffsetIntervalOffsetType свойства линии полосы.

Линии полосы всегда связаны с Axis объектом. Их можно добавить как во время разработки, так и во время выполнения.

Чтобы добавить горизонтальную или вертикальную линию для отображения порогового значения, задайте StripWidth для свойства значение 0,0. Это приведет к рисованию линии. Вы можете использовать BorderColorBorderDashStyle свойства для BorderWidth цвета, ширины и стиля линии. Свойства фона диаграммы (Back*) не используются, если StripWidth для свойства задано значение 0.0.

Text Используйте свойство линии полосы для связывания текста с строкой полосы. Размещение и ориентация этого текста можно контролировать свойством TextAlignment .

При определении нескольких линий полосы для одной оси возможно, что линии полосы будут перекрываться. Порядок объектов Z StripLine определяется их порядком вхождения в StripLinesCollection объекте. Это означает, что первое вхождение нарисовано первым; второе вхождение рисуется второе и т. д.

Линии полосы не поддерживаются для следующих типов диаграмм: Круговая, кольцевая, Воронка, Пирамида, Kagi, ThreeLineBreak, PointAndFigure, Polar и Radar.