Aracılığıyla paylaş


StripLine Sınıf

Tanım

Grafikteki şerit çizgilerini temsil eder.

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
Devralma
StripLine
Uygulamalar

Örnekler

Aşağıdaki kod örneğinde üç şerit çizgisi uygulaması gösterilmektedir. İlk olarak, yatay şerit çizgileri yinelenen aralıklarla eklenir. İkinci olarak, hafta sonu veri noktalarını vurgulamak için dikey şerit çizgileri eklenir. Son olarak, grafiğin ilk serisindeki veri noktalarının ortalamasını belirtmek için yinelenmeyen bir şerit çizgisi eklenir.

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

Açıklamalar

Şerit çizgileri veya şeritler, bir grafiğin arka planını normal veya özel aralıklarla gölgeleyen yatay veya dikey aralıklardır. Şerit çizgilerini kullanarak:

  • Grafikte tek tek değerleri aramak için okunabilirliği geliştirin.

  • Grafiği okurken veri noktalarını ayırın.

  • Hafta sonu veri noktalarını belirlemek için düzenli aralıklarla gerçekleşen tarihleri vurgulayın.

  • Belirli bir veri aralığını vurgulayın.

  • Belirli bir sabit değere eşik çizgisi ekleyin.

Tek StripLine bir nesne belirli bir aralık için bir kez veya art arda çizilebilir. Bu eylem özelliği tarafından denetlenmektedir Interval . Özelliğe -1 değeri atandığında Interval , bir şerit çizgisi çizilir. Özelliğine Interval sıfır olmayan bir değer atandığında, verilen her aralıkta art arda bir şerit çizgisi çizilir. Şerit çizgisinin çizildiği konum, şerit çizgisinin IntervalOffset ve IntervalOffsetType özelliklerinden de etkilenir.

Şerit çizgileri her zaman bir Axis nesneyle ilişkilendirilir. Bunlar hem tasarım zamanında hem de çalışma zamanında eklenebilir.

Eşiği görüntülemek üzere yatay veya dikey çizgi eklemek için özelliğini 0,0 değerine ayarlayın StripWidth . Bu, bir çizginin çizildiğine neden olur. Çizginin BorderColorrengi, genişliği ve BorderWidth stili için ve BorderDashStyle özelliklerini kullanabilirsiniz. Özellik 0,0 olarak ayarlandığında grafik arka plan özellikleri (Back*) kullanılmaz StripWidth .

Text Metni şerit çizgisiyle ilişkilendirmek için şerit çizgisinin özelliğini kullanın. Bu metnin yerleşimi ve yönü özelliği tarafından TextAlignment denetlenebilir.

Aynı eksen için birden çok şerit çizgisi tanımlandığında, şerit çizgilerinin çakışması mümkündür. Nesnelerin Z sırası StripLine , nesnedeki oluşum sırasına StripLinesCollection göre belirlenir. Bu, ilk oluşumun önce çizildiği anlamına gelir; ikinci oluşum ikinci olarak çizilir ve bu şekilde devam edilir.

Şerit çizgileri şu grafik türleri için desteklenmez: Pasta, Halka, Huni, Piramit, Kagi, ThreeLineBreak, PointAndFigure, Polar ve Radar.

Oluşturucular

StripLine()

StripLine sınıfının yeni bir örneğini başlatır.

Özellikler

BackColor

Şerit çizgisinin arka plan rengini alır veya ayarlar.

BackGradientStyle

Şerit çizgisinin gradyan stilini alır veya ayarlar.

BackHatchStyle

Şerit çizgisinin tarama stilini alır veya ayarlar.

BackImage

Şerit çizgisinin arka plan görüntüsünü alır veya ayarlar.

BackImageAlignment

Arka plan görüntüsü hizalamasını alır veya ayarlar.

BackImageTransparentColor

Saydam olarak uygulanacak şerit çizgisi arka plan görüntüsünün rengini alır veya ayarlar.

BackImageWrapMode

Şerit çizgisinin arka plan görüntüsünün çizim modunu alır veya ayarlar.

BackSecondaryColor

Şerit çizgisi arka planının ikincil rengini alır veya ayarlar.

BorderColor

Şerit çizgisinin kenarlık rengini alır veya ayarlar.

BorderDashStyle

Şerit çizgisinin kenarlık stilini alır veya ayarlar.

BorderWidth

Şerit çizgisinin kenarlık genişliğini alır veya ayarlar.

Font

Şerit çizgi metni için kullanılan yazı tipini alır veya ayarlar.

ForeColor

Şerit çizgi metninin rengini alır veya ayarlar.

Interval

Şerit çizgisinin aralığını alır veya ayarlar ve şerit çizgisinin bir kez mi yoksa tekrar tekrar mı çizileceğini belirler.

IntervalOffset

Kılavuz çizgilerinin, değer çizgilerinin, şerit çizgilerinin ve eksen etiketlerinin uzaklığını alır veya ayarlar.

IntervalOffsetType

Şerit çizgisinin aralık uzaklık türünü alır veya ayarlar.

IntervalType

Bir StripLine nesnenin aralık türünü alır veya ayarlar.

MapAreaAttributes

Şerit çizgisinin harita alanı özniteliklerini alır veya ayarlar.

Name

Şerit çizgisinin adını alır.

PostBackValue

Bir Click olayda işlenebilen geri gönderme değerini alır veya ayarlar.

StripWidth

Şerit çizgisinin genişliğini alır veya ayarlar.

StripWidthType

Özelliğin ölçü StripWidth birimini alır veya ayarlar.

Tag

Bu grafik öğesiyle ilişkilendirilmiş bir nesneyi alır veya ayarlar.

(Devralındığı yer: ChartElement)
Text

Şerit çizgisinin metnini alır veya ayarlar.

TextAlignment

Şerit çizgisinin metin hizalamasını alır veya ayarlar.

TextLineAlignment

Şerit çizgi metninin metin çizgisi hizalamasını alır veya ayarlar.

TextOrientation

Metin yönlendirmesini alır veya ayarlar.

ToolTip

Şerit çizgisinin araç ipucu'nu alır veya ayarlar.

Url

Şerit çizgisinin hedef URL'sini veya bağlantı noktasını alır veya ayarlar.

Yöntemler

Dispose()

tarafından ChartElementkullanılan kaynakları serbest bırakır.

(Devralındığı yer: ChartElement)
Dispose(Boolean)

StripLine tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.

Equals(Object)

Belirtilen Object öğesinin geçerli ChartElementöğesine eşit olup olmadığını belirler.

(Devralındığı yer: ChartElement)
GetHashCode()

Belirli bir tür için bir karma işlevi döndürür.

(Devralındığı yer: ChartElement)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli Objectöğesini temsil eden bir dize döndürür.

(Devralındığı yer: ChartElement)

Şunlara uygulanır