StripLine Klasse

Definition

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

Vererbung

Object

ChartElement

StripLine

Implementiert

IChartMapArea

Beispiele

Im folgenden Codebeispiel werden drei Anwendungen von Stripzeilen veranschaulicht. Zunächst werden horizontale Streifenlinien in wiederkehrenden Intervallen hinzugefügt. Zweitens werden vertikale Streifenlinien hinzugefügt, um Wochenenddatenpunkte hervorzuheben. Schließlich wird eine nicht wiederkehrende Striplinie hinzugefügt, um den Mittelwert der Datenpunkte in der ersten Reihe des Diagramms anzugeben.

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

Hinweise

Streifenlinien oder Streifen sind horizontale oder vertikale Bereiche, die den Hintergrund eines Diagramms in regelmäßigen oder benutzerdefinierten Intervallen schattieren. Mithilfe von Bereichsstreifen können Sie Folgendes tun:

• Die Lesbarkeit für das Suchen nach einzelnen Werten im Diagramm verbessern.

• Trennen Sie Datenpunkte beim Lesen des Diagramms.

• Markieren Sie Daten, die in regelmäßigen Abständen auftreten, z. B. zur Identifizierung von Wochenenddatenpunkten.

• Markieren Sie einen bestimmten Schlüsseldatenbereich.

• Fügen Sie eine Schwellenwertlinie an einem bestimmten konstanten Wert hinzu.

Ein einzelnes StripLine Objekt kann entweder einmal oder wiederholt für ein bestimmtes Intervall gezeichnet werden. Diese Aktion wird von der Interval -Eigenschaft gesteuert. Wenn der Interval Eigenschaft ein Wert von -1 zugewiesen wird, wird eine Striplinie gezeichnet. Wenn der Interval -Eigenschaft ein Wert ungleich 0 zugewiesen wird, wird in jedem angegebenen Intervall wiederholt eine Striplinie gezeichnet. Die Position, an der eine Streifenlinie gezeichnet wird, wird auch von den IntervalOffset Eigenschaften und IntervalOffsetType der Streifenlinie beeinflusst.

Strip-Linien werden immer einem Axis Objekt zugeordnet. Sie können sowohl zur Entwurfs- als auch zur Laufzeit hinzugefügt werden.

Um eine horizontale oder vertikale Linie hinzuzufügen, um einen Schwellenwert anzuzeigen, legen Sie die StripWidth Eigenschaft auf den Wert 0,0 fest. Dies führt dazu, dass eine Linie gezeichnet wird. Sie können die BorderColorEigenschaften und BorderDashStyleBorderWidth für die Farbe, breite und den Stil der Linie verwenden. Wenn die StripWidth Eigenschaft auf 0,0 festgelegt ist, werden keine Diagrammhintergrundeigenschaften (Back*) verwendet.

Verwenden Sie die Text Eigenschaft der Stripzeile, um Text einer Stripzeile zuzuordnen. Die Platzierung und Ausrichtung dieses Texts kann durch die TextAlignment -Eigenschaft gesteuert werden.

Wenn mehrere Streifenlinien für dieselbe Achse definiert werden, ist es möglich, dass sich die Streifenlinien überlappen. Die Z-Reihenfolge von StripLine Objekten wird durch ihre Reihenfolge des Vorkommens im StripLinesCollection -Objekt bestimmt. Dies bedeutet, dass das erste Vorkommen zuerst gezeichnet wird; das zweite Vorkommen wird an zweiter Gezeichnet usw.

Streifenlinien werden für die folgenden Diagrammtypen nicht unterstützt: Kreis, Ring, Trichter, Pyramid, Kagi, ThreeLineBreak, PointAndFigure, Polar und Radar.

Konstruktoren

Eigenschaften

Methoden

Gilt für: