StripLine Classe

Definição

Namespace:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Representa as faixas em um gráfico.

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 exemplo de código a seguir demonstra três aplicativos de linhas de faixa. Primeiro, as linhas de faixa horizontal são adicionadas em intervalos recorrentes. Em segundo lugar, as linhas de faixa vertical são adicionadas para realçar os pontos de dados do fim de semana. Por fim, uma faixa não recorrente é adicionada para denotar 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);  
        }  
    }  

Comentários

As faixas ou faixas são intervalos horizontais ou verticais que sombream a tela de fundo de um gráfico em intervalos regulares ou personalizados. É possível usar faixas para:

• Melhorar a legibilidade para pesquisar valores individuais no gráfico.

• Separar pontos de dados ao ler o gráfico.

• Realce as datas que ocorrem em intervalos regulares, por exemplo, para identificar pontos de dados de fim de semana.

• Realce um intervalo de chaves específico de dados.

• Adicione uma linha de limite a um valor constante específico.

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

As linhas de faixa sempre são associadas a um Axis objeto . Eles podem ser adicionados em tempo de design e tempo de execução.

Para adicionar uma linha horizontal ou vertical para exibir um limite, defina a StripWidth propriedade como um valor de 0,0. Isso resultará em uma linha sendo desenhada. Você pode usar as BorderColorpropriedades e BorderWidthBorderDashStyle para a cor, largura e estilo da linha. Nenhuma propriedade de plano de fundo do gráfico (Back*) é usada quando a StripWidth propriedade é definida como 0,0.

Use a Text propriedade da faixa de faixa para associar o texto a uma faixa de faixa. O posicionamento e a orientação desse texto podem ser controlados pela TextAlignment propriedade .

Quando várias linhas de faixa são definidas para o mesmo eixo, é possível que as linhas de faixa se sobreponham. A ordem Z dos StripLine objetos é determinada por sua ordem de ocorrência no StripLinesCollection objeto . Isso significa que a primeira ocorrência é desenhada primeiro; a segunda ocorrência é desenhada em segundo e assim por diante.

Não há suporte para linhas de faixa para os seguintes tipos de gráfico: Pizza, Rosca, Funil, Pirâmide, Kagi, ThreeLineBreak, PointAndFigure, Polar e Radar.

Construtores

StripLine()

Inicializa uma nova instância da classe StripLine.

Propriedades

BackColor	Obtém ou define a cor da tela de fundo da faixa.
BackGradientStyle	Obtém ou define o estilo de gradiente da faixa.
BackHatchStyle	Obtém ou define o estilo de hachura da faixa.
BackImage	Obtém ou define a imagem da tela de fundo da faixa.
BackImageAlignment	Obtém ou define o alinhamento da imagem da tela de fundo.
BackImageTransparentColor	Obtém ou define a cor de uma imagem de tela de fundo da faixa que será implementada como transparente.
BackImageWrapMode	Obtém ou define o modo de desenho da imagem da tela de fundo da faixa.
BackSecondaryColor	Obtém ou define a cor secundária da tela de fundo da faixa.
BorderColor	Obtém ou define a cor de borda de uma faixa.
BorderDashStyle	Obtém ou define o estilo de borda da faixa.
BorderWidth	Obtém ou define a largura de borda da faixa.
Font	Obtém ou define a fonte usada para o texto da faixa.
ForeColor	Obtém ou define a cor do texto da faixa.
Interval	Obtém ou define o intervalo para uma faixa e determina se ela é desenhada uma vez ou repetidamente.
IntervalOffset	Obtém ou define o deslocamento de linhas de grade, marcas de escala, faixas e rótulos de eixo.
IntervalOffsetType	Obtém ou define o tipo de deslocamento de intervalo da faixa.
IntervalType	Obtém ou define o tipo de intervalo de um objeto StripLine.
MapAreaAttributes	Obtém ou define os atributos da área de mapa da faixa.
Name	Obtém o nome da faixa.
PostBackValue	Obtém ou define o valor de postback que pode ser processado em um evento Click .
StripWidth	Obtém ou define a largura de uma faixa.
StripWidthType	Obtém ou define a unidade de medida para a propriedade StripWidth.
Tag	Obtém ou define um objeto associado a esse elemento do gráfico. (Herdado de ChartElement)
Text	Obtém ou define o texto da faixa.
TextAlignment	Obtém ou define o alinhamento de texto da faixa.
TextLineAlignment	Obtém ou define o alinhamento da linha de texto do texto da faixa.
TextOrientation	Obtém ou define a orientação do texto.
ToolTip	Obtém ou define a dica de ferramenta de uma faixa.
Url	Obtém ou define a URL de destino ou ponto de ancoragem da faixa.

Métodos

Dispose()	Libera os recursos usados pelo ChartElement. (Herdado de ChartElement)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo StripLine e opcionalmente libera os recursos gerenciados.
Equals(Object)	Determina se o Object especificado é igual ao ChartElement atual. (Herdado de ChartElement)
GetHashCode()	Retorna uma função de hash para um tipo específico. (Herdado de ChartElement)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o Object atual. (Herdado de ChartElement)