StripLine Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.DataVisualization.Charting

Assembly:: System.Web.DataVisualization.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta le strisce in un grafico.

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

Ereditarietà: Object

ChartElement
StripLine

Implementazioni: IChartMapArea

Esempio

Nell'esempio di codice seguente vengono illustrate tre applicazioni di strip lines. Prima di tutto, le strisce orizzontali vengono aggiunte a intervalli ricorrenti. In secondo luogo, le strisce verticali vengono aggiunte per evidenziare i punti dati del fine settimana. Infine, viene aggiunta una striscia non ricorrente per indicare la media dei punti dati nella prima serie del grafico.

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

Commenti

Le strisce, o le strisce, sono intervalli orizzontali o verticali che ombreggiato lo sfondo di un grafico in intervalli regolari o personalizzati. È possibile utilizzare le strisce per:

Migliorare la leggibilità per la ricerca di singoli valori nel grafico.
Separare i punti dati durante la lettura del grafico.
Evidenziare le date che si verificano a intervalli regolari, ad esempio per identificare i punti dati del fine settimana.
Evidenziare un intervallo di dati chiave specifico.
Aggiungere una riga di soglia in corrispondenza di un valore costante specifico.

Un singolo StripLine oggetto può essere disegnato una volta o ripetutamente per un determinato intervallo. Questa azione è controllata dalla Interval proprietà . Quando alla proprietà viene assegnato un valore pari a Interval -1, verrà disegnata una striscia. Quando alla proprietà viene assegnato un valore diverso da Interval zero, una striscia verrà tracciata ripetutamente a ogni intervallo specificato. La posizione in cui viene tracciata una striscia è interessata anche dalle IntervalOffset proprietà e IntervalOffsetType della striscia.

Le strisce sono sempre associate a un Axis oggetto . Possono essere aggiunti sia in fase di progettazione che in fase di esecuzione.

Per aggiungere una linea orizzontale o verticale per visualizzare una soglia, impostare la StripWidth proprietà su un valore pari a 0,0. In questo modo verrà tracciata una linea. È possibile utilizzare le BorderColorproprietà , BorderDashStyle e BorderWidth per il colore, la larghezza e lo stile della linea. Non vengono utilizzate proprietà di sfondo del grafico (Back*) quando la StripWidth proprietà è impostata su 0,0.

Utilizzare la Text proprietà della striscia per associare il testo a una striscia. Il posizionamento e l'orientamento TextAlignment di questo testo possono essere controllati dalla proprietà .

Quando vengono definite più strisce per lo stesso asse, è possibile che le strisce si sovrappongano. L'ordine Z degli StripLine oggetti è determinato dall'ordine di occorrenza nell'oggetto StripLinesCollection . Ciò significa che la prima occorrenza viene disegnata per prima; la seconda occorrenza viene disegnata secondo e così via.

Le strisce non sono supportate per i tipi di grafico seguenti: Torta, Anello, Imbuto, Piramide, Kagi, ThreeLineBreak, PointAndFigure, Polar e Radar.

Costruttori

StripLine()

Inizializza una nuova istanza della classe StripLine.

Proprietà

BackColor	Ottiene o imposta il colore di sfondo della striscia.
BackGradientStyle	Ottiene o imposta lo stile della sfumatura della striscia.
BackHatchStyle	Ottiene o imposta lo stile del tratteggio della striscia.
BackImage	Ottiene o imposta l'immagine di sfondo della striscia.
BackImageAlignment	Ottiene o imposta l'allineamento dell'immagine di sfondo.
BackImageTransparentColor	Ottiene o imposta il colore dell'immagine di sfondo di una striscia che verrà implementato come trasparente.
BackImageWrapMode	Ottiene o imposta la modalità di disegno dell'immagine di sfondo della striscia.
BackSecondaryColor	Ottiene o imposta il colore secondario dello sfondo della striscia.
BorderColor	Ottiene o imposta il colore del bordo di una striscia.
BorderDashStyle	Ottiene o imposta lo stile del bordo della striscia.
BorderWidth	Ottiene o imposta lo spessore del bordo della striscia.
Font	Ottiene o imposta il tipo di carattere utilizzato per il testo della striscia.
ForeColor	Ottiene o imposta il colore del testo della striscia.
Interval	Ottiene o imposta l'intervallo per una striscia e determina se viene disegnata una volta o ripetutamente.
IntervalOffset	Ottiene o imposta l'offset relativo a linee della griglia, segni di graduazione, strisce ed etichette di asse.
IntervalOffsetType	Ottiene o imposta l'offset dell'intervallo della striscia.
IntervalType	Ottiene o imposta il tipo di intervallo di un oggetto StripLine.
MapAreaAttributes	Ottiene o imposta gli attributi dell'area della mappa della striscia.
Name	Ottiene il nome della striscia.
PostBackValue	Ottiene o imposta il valore di postback che può essere elaborato in un evento Click.
StripWidth	Ottiene o imposta lo spessore di una striscia.
StripWidthType	Ottiene o imposta l'unità di misura per la proprietà StripWidth.
Tag	Ottiene o imposta un oggetto associato all'elemento del grafico. (Ereditato da ChartElement)
Text	Ottiene o imposta il testo della striscia.
TextAlignment	Ottiene o imposta l'allineamento del testo della striscia.
TextLineAlignment	Ottiene o imposta l'allineamento della riga di testo del testo della striscia.
TextOrientation	Ottiene o imposta l'orientamento del testo.
ToolTip	Ottiene o imposta la descrizione comando di una striscia.
Url	Ottiene o imposta l'URL di destinazione o il punto di ancoraggio della striscia.

Metodi

Dispose()	Rilascia le risorse usate da ChartElement. (Ereditato da ChartElement)
Dispose(Boolean)	Rilascia le risorse non gestite usate da StripLine e, facoltativamente, le risorse gestite.
Equals(Object)	Determina se l'oggetto Object specificato è uguale all'oggetto ChartElement corrente. (Ereditato da ChartElement)
GetHashCode()	Restituisce una funzione hash per un tipo specifico. (Ereditato da ChartElement)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto Object corrente. (Ereditato da ChartElement)

Si applica a