StripLine Třída

Definice

Obor názvů:

System.Web.UI.DataVisualization.Charting

Sestavení:

System.Web.DataVisualization.dll

Představuje pruhové čáry v grafu.

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

Dědičnost

Object

ChartElement

StripLine

Implementuje

IChartMapArea

Příklady

Následující příklad kódu ukazuje tři aplikace pruhových čar. Nejprve se v opakovaných intervalech přidají vodorovné čáry pruhů. Za druhé se přidají svislé pruhové čáry, které zvýrazní víkendové datové body. Nakonec se přidá neopakující pruhová čára, která označuje střední hodnoty datových bodů v první řadě grafu.

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

Poznámky

Pruhové čáry neboli pruhy jsou vodorovné nebo svislé rozsahy, které stínují pozadí grafu v pravidelných nebo vlastních intervalech. Pruhové čáry můžete použít k:

• Zlepšit čitelnost pro vyhledávání jednotlivých hodnot v grafu.

• Při čtení grafu oddělte datové body.

• Zvýrazněte data, která se vyskytují v pravidelných intervalech, například kvůli identifikaci datových bodů o víkendu.

• Zvýrazněte konkrétní oblast klíčových dat.

• Přidejte čáru prahové hodnoty na konkrétní konstantní hodnotu.

Jeden StripLine objekt lze v daném intervalu vykreslit jednou nebo opakovaně. Tato akce je řízena Interval vlastností. Když je k vlastnosti přiřazena Interval hodnota -1, bude vykreslena jedna čára pruhu. Pokud je k vlastnosti přiřazena Interval nenulová hodnota, bude čára pruhu opakovaně vykreslena v každém daném intervalu. Umístění, kde je nakreslená čára pruhu, je také ovlivněno vlastnostmi IntervalOffset a IntervalOffsetType čáry pruhu.

Pruhové čáry jsou vždy přidruženy k objektu Axis . Je možné je přidat v době návrhu i v době běhu.

Pokud chcete přidat vodorovnou nebo svislou čáru pro zobrazení prahové hodnoty, nastavte StripWidth vlastnost na hodnotu 0,0. Výsledkem bude vykreslení čáry. Vlastnosti a BorderDashStyleBorderWidth můžete použít BorderColorpro barvu, šířku a styl čáry. Pokud je vlastnost nastavená StripWidth na hodnotu 0.0, nejsou použity žádné vlastnosti pozadí grafu (Back*).

Text Pomocí vlastnosti řádku pruhu přidružte text k čáře pruhu. Umístění a orientaci tohoto textu lze řídit pomocí TextAlignment vlastnosti .

Pokud je pro stejnou osu definováno více čar pruhů, je možné, že se pruhové čáry překrývají. Pořadí StripLine Z objektů je určeno jejich pořadím výskytu v objektu StripLinesCollection . To znamená, že první výskyt je vykreslen jako první; druhý výskyt je nakreslený jako druhý atd.

Pruhové čáry nejsou podporovány pro následující typy grafů: Výsečový, Prstencový, Trychtýřový, Pyramidový, Kagi, ThreeLineBreak, PointAndFigure, Polar a Radar.

Konstruktory

StripLine()

Inicializuje novou instanci StripLine třídy.

Vlastnosti

BackColor	Získá nebo nastaví barvu pozadí čáry pruhu.
BackGradientStyle	Získá nebo nastaví styl přechodu čáry pruhu.
BackHatchStyle	Získá nebo nastaví šrafování stylu čáry pruhu.
BackImage	Získá nebo nastaví obrázek pozadí čáry pruhu.
BackImageAlignment	Získá nebo nastaví zarovnání obrázku na pozadí.
BackImageTransparentColor	Získá nebo nastaví barvu pruhu čáry pozadí obrázku, který bude implementován jako průhledný.
BackImageWrapMode	Získá nebo nastaví režim kreslení obrázku pozadí čáry pruhu.
BackSecondaryColor	Získá nebo nastaví sekundární barvu pozadí čáry pruhu.
BorderColor	Získá nebo nastaví barvu ohraničení čáry pruhu.
BorderDashStyle	Získá nebo nastaví styl ohraničení čáry pruhu.
BorderWidth	Získá nebo nastaví šířku ohraničení čáry pruhu.
Font	Získá nebo nastaví písmo použité pro text řádku pruhu.
ForeColor	Získá nebo nastaví barvu textu čáry pruhu.
Interval	Získá nebo nastaví interval pro čáru pruhu a určuje, zda je čára pruhu nakreslena jednou nebo opakovaně.
IntervalOffset	Získá nebo nastaví posun čar mřížky, značky, pruhové čáry a popisky osy.
IntervalOffsetType	Získá nebo nastaví typ posunu intervalu čáry.
IntervalType	Získá nebo nastaví typ intervalu objektu StripLine .
MapAreaAttributes	Získá nebo nastaví atributy mapové oblasti čáry.
Name	Získá název řádku pruhu.
PostBackValue	Získá nebo nastaví hodnotu postback, která může být zpracována v Click události.
StripWidth	Získá nebo nastaví šířku čáry pruhu.
StripWidthType	Získá nebo nastaví měrnou jednotku StripWidth pro vlastnost.
Tag	Získá nebo nastaví objekt přidružený k tomuto prvku grafu. (Zděděno od ChartElement)
Text	Získá nebo nastaví text pro řádek pruhu.
TextAlignment	Získá nebo nastaví zarovnání textu řádku pruhu.
TextLineAlignment	Získá nebo nastaví zarovnání řádku textu pruhové čáry textu.
TextOrientation	Získá nebo nastaví orientaci textu.
ToolTip	Získá nebo nastaví popis čáry pruhu.
Url	Získá nebo nastaví cílovou adresu URL nebo bod ukotvení řádku pruhu.

Metody

Dispose()	Uvolní prostředky používané nástrojem ChartElement. (Zděděno od ChartElement)
Dispose(Boolean)	Uvolní nespravované prostředky používané StripLine nástrojem a volitelně uvolní spravované prostředky.
Equals(Object)	Určuje, zda se zadaná Object hodnota rovná aktuální ChartElementhodnotě . (Zděděno od ChartElement)
GetHashCode()	Vrátí hashovací funkci pro konkrétní typ. (Zděděno od ChartElement)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální Objecthodnotu . (Zděděno od ChartElement)