StripLine Classe

Référence

Définition

Espace de noms:: System.Web.UI.DataVisualization.Charting

Assembly:: System.Web.DataVisualization.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente les franges d'un graphique.

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

Héritage: Object

ChartElement
StripLine

Implémente: IChartMapArea

Exemples

L’exemple de code suivant illustre trois applications de lignes de bande. Tout d’abord, des lignes de bandes horizontales sont ajoutées à intervalles périodiques. Deuxièmement, des lignes de bandes verticales sont ajoutées pour mettre en évidence les points de données du week-end. Enfin, une ligne de bande non périodique est ajoutée pour désigner la moyenne des points de données de la première série du graphique.

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

Remarques

Les lignes de bandes, ou bandes, sont des plages horizontales ou verticales qui ombragent l’arrière-plan d’un graphique à intervalles réguliers ou personnalisés. Vous pouvez utiliser des bandes pour obtenir les résultats suivants :

Améliorer la lisibilité des valeurs individuelles sur le graphique.
Séparer les points de données lors de la lecture du graphique.
Mettez en surbrillance les dates qui se produisent à intervalles réguliers, par exemple, pour identifier les points de données du week-end.
Mettez en surbrillance une plage clé spécifique de données.
Ajoutez une ligne de seuil à une valeur constante spécifique.

Un objet unique StripLine peut être dessiné une fois ou plusieurs fois pour un intervalle donné. Cette action est contrôlée par la Interval propriété . Lorsqu’une valeur de -1 est affectée à la Interval propriété, une ligne de bande est dessinée. Lorsqu’une valeur autre que zéro est affectée à la Interval propriété, une ligne de bande est dessinée à plusieurs reprises à chaque intervalle donné. L’emplacement où une ligne de bande est dessinée est également affecté par les IntervalOffset propriétés et IntervalOffsetType de la ligne de bande.

Les lignes de bande sont toujours associées à un Axis objet. Ils peuvent être ajoutés au moment de la conception et au moment de l’exécution.

Pour ajouter une ligne horizontale ou verticale afin d’afficher un seuil, définissez la StripWidth propriété sur une valeur de 0,0. Une ligne est alors tracée. Vous pouvez utiliser les BorderColorpropriétés et BorderDashStyle pour BorderWidth la couleur, la largeur et le style de la ligne. Aucune propriété d’arrière-plan de graphique (Back*) n’est utilisée lorsque la StripWidth propriété est définie sur 0,0.

Utilisez la Text propriété de la ligne de bande pour associer du texte à une ligne de bande. La position et l’orientation de ce texte peuvent être contrôlées par la TextAlignment propriété .

Lorsque plusieurs lignes de bandes sont définies pour le même axe, il est possible que les lignes de bande se chevauchent. L’ordre Z des StripLine objets est déterminé par leur ordre d’occurrence dans l’objet StripLinesCollection . Cela signifie que la première occurrence est dessinée en premier ; la deuxième occurrence est dessinée en second, et ainsi de suite.

Les lignes de bandes ne sont pas prises en charge pour les types de graphiques suivants : Pie, Doughnut, Entonnoir, Pyramide, Kagi, ThreeLineBreak, PointAndFigure, Polar et Radar.

Constructeurs

StripLine()

Initialise une nouvelle instance de la classe StripLine.

Propriétés

BackColor	Obtient ou définit la couleur d'arrière-plan des franges.
BackGradientStyle	Obtient ou définit le style de dégradé de la frange.
BackHatchStyle	Obtient ou définit le style de hachurage de la frange.
BackImage	Obtient ou définit l'image d'arrière-plan de la frange.
BackImageAlignment	Obtient ou définit l'alignement de l'image d'arrière-plan.
BackImageTransparentColor	Obtient ou définit la couleur d'une image d'arrière-plan de frange qui sera implémentée comme transparente.
BackImageWrapMode	Obtient ou définit le mode dessin de l'image d'arrière-plan de la frange.
BackSecondaryColor	Obtient ou définit la couleur secondaire de l'arrière-plan de la frange.
BorderColor	Obtient ou définit la couleur de bordure d'une frange.
BorderDashStyle	Obtient ou définit le style de bordure de la frange.
BorderWidth	Obtient ou définit l'épaisseur de la bordure de la frange.
Font	Obtient ou définit la police utilisée pour le texte de la frange.
ForeColor	Obtient ou définit la couleur du texte de la frange.
Interval	Obtient ou définit l'intervalle d'une frange et détermine si celle-ci est dessinée une ou plusieurs fois.
IntervalOffset	Obtient ou définit le décalage du quadrillage, des graduations, des franges et des étiquettes d'axe.
IntervalOffsetType	Obtient ou définit le type de décalage de l'intervalle de la frange.
IntervalType	Obtient ou définit le type d'intervalle d'un objet StripLine.
MapAreaAttributes	Obtient ou définit les attributs de zone réactive de la frange.
Name	Obtient le nom de la frange.
PostBackValue	Obtient ou définit la valeur de publication (postback) qui peut être traitée sur un événement Click.
StripWidth	Obtient ou définit la largeur d'une frange.
StripWidthType	Obtient ou définit l'unité de mesure de la propriété StripWidth.
Tag	Obtient ou définit un objet associé à cet élément de graphique. (Hérité de ChartElement)
Text	Obtient ou définit le texte de la frange.
TextAlignment	Obtient ou définit l'alignement du texte de la frange.
TextLineAlignment	Obtient ou définit l'alignement des lignes du texte de la frange.
TextOrientation	Obtient ou définit l'orientation de texte.
ToolTip	Obtient ou définit l'info-bulle d'une frange.
Url	Obtient ou définit l'URL de destination ou le point d'ancrage de la frange.

Méthodes

Dispose()	Libère les ressources utilisées par le ChartElement. (Hérité de ChartElement)
Dispose(Boolean)	Libère les ressources non managées utilisées par StripLine et libère éventuellement les ressources managées.
Equals(Object)	Détermine si l'objet Object spécifié est égal à l'objet ChartElement actuel. (Hérité de ChartElement)
GetHashCode()	Retourne une fonction de hachage pour un type particulier. (Hérité de ChartElement)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente le Object actuel. (Hérité de ChartElement)

S’applique à