StripLine Classe

Definição

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

Herança

Object

ChartElement

StripLine

Implementações

IChartMapArea

Exemplos

O seguinte exemplo de código demonstra três aplicações das linhas de tira. Primeiro, as linhas horizontais são adicionadas em intervalos recorrentes. Em segundo lugar, são adicionadas linhas verticais para destacar pontos de dados do fim de semana. Por fim, é adicionada uma linha de tira não recorrente para indicar a média dos pontos de dados na primeira série do gráfico.

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);
        }
    }

Observações

As linhas de tira, ou faixas, são intervalos horizontais ou verticais que sombreiam o fundo de um gráfico em intervalos regulares ou personalizados. Você pode usar linhas de tira para:

• Melhore a legibilidade para procurar valores individuais no gráfico.

• Separe os pontos de dados ao ler o gráfico.

• Destaque datas que ocorrem a intervalos regulares, por exemplo, para identificar pontos de dados ao fim de semana.

• Destaca um intervalo específico de dados-chave.

• Adicione uma linha de limiar num valor constante específico.

Um único StripLine objeto pode ser desenhado uma vez, ou repetidamente, durante um dado intervalo. Esta ação é controlada pela Interval propriedade. Quando um valor de -1 é atribuído à Interval propriedade, uma linha de faixa será traçada. Quando um valor diferente de zero é atribuído à Interval propriedade, uma linha de faixa será desenhada repetidamente a cada intervalo dado. O local onde uma linha de tira é desenhada também é afetado pelas IntervalOffset propriedades e IntervalOffsetType da linha de tira.

As linhas de tira estão sempre associadas a um Axis objeto. Podem ser adicionadas tanto em tempo de design como em tempo de execução.

Para adicionar uma linha horizontal ou vertical para mostrar um limiar, defina a StripWidth propriedade para um valor de 0,0. Isto resultará numa linha traçada. Pode usar as BorderColorpropriedades , BorderDashStyle e BorderWidth para a cor, largura e estilo da linha. Não são usadas propriedades de fundo no mapa (Back*) quando a StripWidth propriedade está definida para 0.0.

Use a Text propriedade da linha de faixa para associar texto a uma linha de tira. A colocação e orientação deste texto podem ser controladas pela TextAlignment propriedade.

Quando múltiplas linhas de faixa são definidas para o mesmo eixo, é possível que as linhas de tira se sobreponham. A ordem Z dos StripLine objetos é determinada pela sua ordem de ocorrência no StripLinesCollection objeto. Isto significa que a primeira ocorrência é desenhada primeiro; a segunda ocorrência é desenhada em segundo lugar, e assim sucessivamente.

As linhas de tira não são suportadas para os seguintes tipos de gráficos: Pie, Doughnut, Funnel, Pyramid, Kagi, ThreeLineBreak, PointAndFigure, Polar e Radar.