StripLine Klasse

Definition

Namespace:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Stellt die Bereichsstreifen in einem Diagramm dar.

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

StripLine()

Initialisiert eine neue Instanz der StripLine-Klasse.

Eigenschaften

BackColor	Ruft die Hintergrundfarbe des Bereichsstreifens ab oder legt diese fest.
BackGradientStyle	Ruft die Art des Farbverlaufs des Bereichsstreifens ab oder legt diese fest.
BackHatchStyle	Ruft die Schraffurart des Bereichsstreifens ab oder legt diese fest.
BackImage	Ruft das Hintergrundbild des Bereichsstreifens ab oder legt dieses fest.
BackImageAlignment	Ruft die Hintergrundbildausrichtung ab oder legt diese fest.
BackImageTransparentColor	Ruft die Farbe für das Hintergrundbild eines Bereichsstreifens ab, das als transparent implementiert wird, oder legt diese fest.
BackImageWrapMode	Ruft den Zeichnungsmodus für das Hintergrundbild des Bereichsstreifens ab oder legt diesen fest.
BackSecondaryColor	Ruft die sekundäre Farbe des Bereichsstreifenhintergrunds ab oder legt diese fest.
BorderColor	Ruft die Rahmenfarbe eines Bereichsstreifens ab oder legt diese fest.
BorderDashStyle	Ruft die Rahmenart des Bereichsstreifens ab oder legt diese fest.
BorderWidth	Ruft die Rahmenbreite des Bereichsstreifens ab oder legt diese fest.
Font	Ruft die für den Bereichsstreifentext verwendete Schriftart ab oder legt diese fest.
ForeColor	Ruft die Farbe des Bereichsstreifentexts ab oder legt diese fest.
Interval	Ruft das Intervall für einen Bereichsstreifen ab oder legt dieses fest und bestimmt, ob der Bereichsstreifen einmal oder mehrmals gezeichnet wird.
IntervalOffset	Ruft den Offset von Rasterlinien, Teilstrichen, Bereichsstreifen und Achsenbezeichnungen ab oder legt diesen fest.
IntervalOffsetType	Ruft den Intervalloffsettyp des Bereichsstreifens ab oder legt diesen fest.
IntervalType	Ruft den Intervalltyp eines StripLine-Objekts ab oder legt diesen fest.
MapAreaAttributes	Ruft die Zuordnungsbereichsattribute des Bereichsstreifens ab oder legt diese fest.
Name	Ruft den Namen des Bereichsstreifens ab.
PostBackValue	Ruft den Postbackwert ab, der in einem Click-Ereignis verarbeitet werden kann, oder legt diesen fest.
StripWidth	Ruft die Breite eines Bereichsstreifens ab oder legt diese fest.
StripWidthType	Ruft die Maßeinheit für die StripWidth-Eigenschaft ab oder legt diese fest.
Tag	Ruft ein Objekt ab, das dem Diagrammelement zugeordnet ist, oder legt dieses fest. (Geerbt von ChartElement)
Text	Ruft den Text für den Bereichsstreifen ab oder legt diesen fest.
TextAlignment	Ruft die Textausrichtung des Bereichsstreifens ab oder legt diese fest.
TextLineAlignment	Ruft die Textzeilenausrichtung von Bereichsstreifentext ab oder legt diese fest.
TextOrientation	Ruft die Textausrichtung ab oder legt diese fest.
ToolTip	Ruft die QuickInfo eines Bereichsstreifens ab oder legt diese fest.
Url	Ruft die Ziel-URL oder den Ankerpunkt des Bereichsstreifens ab oder legt diese(n) fest.

Methoden

Dispose()	Gibt die von der ChartElement verwendeten Ressourcen frei. (Geerbt von ChartElement)
Dispose(Boolean)	Gibt die von StripLine verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.
Equals(Object)	Bestimmt, ob das angegebene Object und das aktuelle ChartElement gleich sind. (Geerbt von ChartElement)
GetHashCode()	Gibt eine Hashfunktion für einen bestimmten Typ zurück. (Geerbt von ChartElement)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Object-Objekt darstellt. (Geerbt von ChartElement)