StripLine Třída

Definice

Obor názvů:: System.Web.UI.DataVisualization.Charting

Sestavení:: System.Web.DataVisualization.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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 řádků. Nejprve se v pravidelných intervalech přidají vodorovné čáry pruhu. Za druhé, svislé pruhové čáry se přidají ke zvýraznění datových bodů víkendu. Nakonec se přidá neopakovaná čára pruhu, která označuje průměr 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 nebo pruhy jsou vodorovné nebo svislé oblasti, které stínují pozadí grafu v pravidelných nebo vlastních intervalech. Pomocí pruhových čar můžete:

Vylepšení čitelnosti 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 k identifikaci datových bodů víkendu.
Zvýrazněte konkrétní rozsah klíčových dat.
Přidejte prahovou čáru na určitou konstantní hodnotu.

Jeden StripLine objekt může být nakreslen jednou nebo opakovaně pro daný interval. Tato akce je řízena Interval vlastností. Pokud je vlastnost Interval přiřazena hodnota -1, bude vykreslena jedna čára pruhu. Pokud je vlastnost Interval přiřazena nenulová hodnota, bude čára pruhu opakovaně nakreslena v každém daném intervalu. Umístění, kde je vykreslena čára pruhu, je ovlivněna také vlastnostmi IntervalOffset IntervalOffsetType čáry pruhu.

Čáry pruhu 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. Můžete použít BorderColor BorderDashStyle a BorderWidth vlastnosti pro 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 řádku pruhu. Umístění a orientaci tohoto textu může být řízeno TextAlignment vlastností.

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

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

Konstruktory

Name	Description
StripLine()	Inicializuje novou instanci StripLine třídy.

Vlastnosti

Name	Description
BackColor	Získá nebo nastaví barvu pozadí čáry pruhu.
BackGradientStyle	Získá nebo nastaví styl přechodu čáry pruhu.
BackHatchStyle	Získá nebo nastaví styl šrafování čá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 pruhového obrázku pozadí pozadí, 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 pruhového textu čáry.
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í odsazení čar mřížky, značek, pruhových čar a popisků os.
IntervalOffsetType	Získá nebo nastaví typ posunu intervalu čáry pruhu.
IntervalType	Získá nebo nastaví typ intervalu objektu StripLine .
MapAreaAttributes	Získá nebo nastaví atributy oblasti mapy řádku pruhu.
Name	Získá název řádku pruhu.
PostBackValue	Získá nebo nastaví postback hodnotu, kterou lze zpracovat v Click události.
StripWidth	Získá nebo nastaví šířku čáry pruhu.
StripWidthType	Získá nebo nastaví měrnou jednotku StripWidth vlastnosti.
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 čáru pruhu.
TextAlignment	Získá nebo nastaví zarovnání textu čáry pruhu.
TextLineAlignment	Získá nebo nastaví zarovnání řádku textu řádku pruhu.
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 ukotvení bodu řádku pruhu.

Metody

Name	Description
Dispose()	Uvolní prostředky používané nástrojem ChartElement. (Zděděno od ChartElement)
Dispose(Boolean)	Uvolní nespravované prostředky používané StripLine a volitelně uvolní spravované prostředky.
Equals(Object)	Určuje, zda je zadaná Object hodnota rovna aktuálnímu ChartElement. (Zděděno od ChartElement)
GetHashCode()	Vrátí funkci hash pro určitý typ. (Zděděno od ChartElement)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální Object. (Zděděno od ChartElement)

Platí pro

Váš názor

Byla tato stránka užitečná?