Freigeben über


StripLine Klasse

Definition

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
StripLine
Implementiert

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)

Gilt für: