StripLine Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.DataVisualization.Charting

Zestaw:: System.Web.DataVisualization.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje linie paska na wykresie.

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

Dziedziczenie: Object

ChartElement
StripLine

Implementuje: IChartMapArea

Przykłady

W poniższym przykładzie kodu przedstawiono trzy aplikacje linii paskowych. Najpierw linie pasków poziomych są dodawane w cyklicznych odstępach czasu. Po drugie, linie paska pionowego są dodawane w celu wyróżnienia punktów danych weekendowych. Na koniec dodawana jest linia niecyklicznego paska, aby oznaczyć średnią punktów danych w pierwszej serii wykresu.

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

Uwagi

Linie paska lub paski są zakresami poziomymi lub pionowymi, które cieniują tło wykresu w regularnych lub niestandardowych interwałach. Możesz użyć linii paska do:

Zwiększ czytelność wyszukiwania poszczególnych wartości na wykresie.
Oddzielaj punkty danych podczas odczytywania wykresu.
Wyróżnij daty, które występują w regularnych odstępach czasu, na przykład w celu zidentyfikowania punktów danych weekendowych.
Wyróżnij określony zakres kluczowych danych.
Dodaj linię progową w określonej wartości stałej.

Pojedynczy StripLine obiekt można narysować raz lub wielokrotnie dla danego interwału. Ta akcja jest kontrolowana Interval przez właściwość . Gdy do właściwości zostanie przypisana Interval wartość -1, zostanie narysowana jedna linia paska. Po przypisaniu wartości innej niż zero do Interval właściwości linia paska będzie rysowana wielokrotnie w każdym danym interwale. Lokalizacja, w której rysowana jest linia pasowa, ma również wpływ na IntervalOffset właściwości i IntervalOffsetType linii paska.

Linie paska są zawsze skojarzone z obiektem Axis . Można je dodać zarówno w czasie projektowania, jak i w czasie wykonywania.

Aby dodać linię poziomą lub pionową w celu wyświetlenia progu, ustaw StripWidth właściwość na wartość 0,0. Spowoduje to narysowane wiersze. Możesz użyć BorderColor BorderDashStyle właściwości , i BorderWidth dla koloru, szerokości i stylu linii. Właściwości tła wykresu (Back*) nie są używane, gdy właściwość jest ustawiona StripWidth na 0,0.

Text Użyj właściwości linii paska, aby skojarzyć tekst z linią paska. Położenie i orientacja tego tekstu mogą być kontrolowane przez TextAlignment właściwość .

Jeśli dla tej samej osi zdefiniowano wiele linii pasków, linie paskowe nakładają się na siebie. Kolejność StripLine Z obiektów jest określana przez ich kolejność wystąpień w StripLinesCollection obiekcie. Oznacza to, że pierwsze wystąpienie jest rysowane jako pierwsze; drugie wystąpienie jest rysowane w sekundzie itd.

Linie paska nie są obsługiwane dla następujących typów wykresów: Koł, Pierścieniowy, Lejkowy, Piramida, Kagi, ThreeLineBreak, PointAndFigure, Polar i Radar.

Konstruktory

StripLine()

Inicjuje nowe wystąpienie klasy StripLine.

Właściwości

BackColor	Pobiera lub ustawia kolor tła linii paska.
BackGradientStyle	Pobiera lub ustawia styl gradientu linii paska.
BackHatchStyle	Pobiera lub ustawia styl kreskowania linii paska.
BackImage	Pobiera lub ustawia obraz tła linii paska.
BackImageAlignment	Pobiera lub ustawia wyrównanie obrazu tła.
BackImageTransparentColor	Pobiera lub ustawia kolor obrazu tła linii paska, który zostanie zaimplementowany jako przezroczysty.
BackImageWrapMode	Pobiera lub ustawia tryb rysunku obrazu tła linii paska.
BackSecondaryColor	Pobiera lub ustawia pomocniczy kolor tła linii paska.
BorderColor	Pobiera lub ustawia kolor obramowania linii paska.
BorderDashStyle	Pobiera lub ustawia styl obramowania linii paska.
BorderWidth	Pobiera lub ustawia szerokość obramowania linii paska.
Font	Pobiera lub ustawia czcionkę używaną do tekstu wiersza paska.
ForeColor	Pobiera lub ustawia kolor tekstu wiersza paska.
Interval	Pobiera lub ustawia interwał linii pasa i określa, czy linia paska jest rysowana raz lub wielokrotnie.
IntervalOffset	Pobiera lub ustawia przesunięcie linii siatki, znaczniki znaczników, linie paska i etykiety osi.
IntervalOffsetType	Pobiera lub ustawia typ przesunięcia interwału linii paska.
IntervalType	Pobiera lub ustawia typ interwału StripLine obiektu.
MapAreaAttributes	Pobiera lub ustawia atrybuty obszaru mapy linii paska.
Name	Pobiera nazwę linii paska.
PostBackValue	Pobiera lub ustawia wartość po powrocie zwrotną Click , którą można przetworzyć na zdarzeniu.
StripWidth	Pobiera lub ustawia szerokość linii paska.
StripWidthType	Pobiera lub ustawia jednostkę miary StripWidth dla właściwości.
Tag	Pobiera lub ustawia obiekt skojarzony z tym elementem wykresu. (Odziedziczone po ChartElement)
Text	Pobiera lub ustawia tekst dla wiersza paska.
TextAlignment	Pobiera lub ustawia wyrównanie tekstu linii paska.
TextLineAlignment	Pobiera lub ustawia wyrównanie wiersza tekstu w wierszu paska.
TextOrientation	Pobiera lub ustawia orientację tekstu.
ToolTip	Pobiera lub ustawia etykietkę narzędzia linii paska.
Url	Pobiera lub ustawia docelowy adres URL lub punkt kotwicy linii paska.

Metody

Dispose()	Zwalnia zasoby używane przez usługę ChartElement. (Odziedziczone po ChartElement)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element StripLine i opcjonalnie zwalnia zasoby zarządzane.
Equals(Object)	Określa, czy określona wartość Object jest równa bieżącemu ChartElement. (Odziedziczone po ChartElement)
GetHashCode()	Zwraca funkcję skrótu dla określonego typu. (Odziedziczone po ChartElement)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący Objectelement . (Odziedziczone po ChartElement)

Dotyczy

Udostępnij za pośrednictwem