StripLine Klas

Definitie

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

Overname

Object

ChartElement

StripLine

Implementeringen

IChartMapArea

Voorbeelden

In het volgende codevoorbeeld ziet u drie toepassingen van stripregels. Eerst worden horizontale striplijnen toegevoegd met terugkerende intervallen. Ten tweede worden verticale striplijnen toegevoegd om gegevenspunten in het weekend te markeren. Ten slotte wordt een niet-terugkerende striplijn toegevoegd om het gemiddelde van de gegevenspunten in de eerste reeks van de grafiek aan te geven.

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

Opmerkingen

Striplijnen of stroken zijn horizontale of verticale bereiken die de achtergrond van een grafiek in normale of aangepaste intervallen arcering. U kunt striplijnen gebruiken om het volgende te doen:

• Verbeter de leesbaarheid voor het opzoeken van afzonderlijke waarden in de grafiek.

• Scheid gegevenspunten bij het lezen van de grafiek.

• Markeer datums die regelmatig plaatsvinden, bijvoorbeeld om weekendgegevenspunten te identificeren.

• Markeer een specifiek sleutelbereik met gegevens.

• Voeg een drempelwaardelijn toe aan een specifieke constante waarde.

StripLine Eén object kan één keer of herhaaldelijk worden getekend voor een bepaald interval. Deze actie wordt bepaald door de Interval eigenschap. Wanneer een waarde van -1 wordt toegewezen aan de Interval eigenschap, wordt één striplijn getekend. Wanneer een niet-nulwaarde wordt toegewezen aan de Interval eigenschap, wordt er herhaaldelijk een striplijn getekend bij elk bepaald interval. De locatie waar een striplijn wordt getekend, wordt ook beïnvloed door de IntervalOffset en IntervalOffsetType eigenschappen van de striplijn.

Striplijnen zijn altijd gekoppeld aan een Axis object. Ze kunnen zowel tijdens de ontwerptijd als de uitvoeringstijd worden toegevoegd.

Als u een horizontale of verticale lijn wilt toevoegen om een drempelwaarde weer te geven, stelt u de StripWidth eigenschap in op een waarde van 0,0. Dit resulteert in een lijn die wordt getekend. U kunt de BorderColoren BorderDashStyleBorderWidth eigenschappen voor de kleur, breedte en stijl van de lijn gebruiken. Er worden geen grafiekachtergrondeigenschappen (Back*) gebruikt wanneer de StripWidth eigenschap is ingesteld op 0.0.

Gebruik de Text eigenschap van de stripregel om tekst te koppelen aan een striplijn. De plaatsing en afdrukstand van deze tekst kunnen worden bepaald door de TextAlignment eigenschap.

Wanneer er meerdere striplijnen zijn gedefinieerd voor dezelfde as, is het mogelijk dat de striplijnen elkaar overlappen. De Z-volgorde van StripLine objecten wordt bepaald door de volgorde van de gebeurtenis in het StripLinesCollection object. Dit betekent dat de eerste instantie eerst wordt getekend; de tweede instantie wordt getekend op de tweede plaats, enzovoort.

Striplijnen worden niet ondersteund voor de volgende grafiektypen: Cirkel, Ring, Trechter, Piramide, Kagi, ThreeLineBreak, PointAndFigure, Polar en Radar.