Bagikan melalui


StripLine Kelas

Definisi

Mewakili garis strip pada bagan.

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
Warisan
StripLine
Penerapan

Contoh

Contoh kode berikut menunjukkan tiga aplikasi garis strip. Pertama, garis garis horizontal ditambahkan pada interval berulang. Kedua, garis strip vertikal ditambahkan untuk menyoroti titik data akhir pekan. Terakhir, garis strip yang tidak berulang ditambahkan untuk menunjukkan rata-rata titik data dalam seri pertama bagan.

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

Keterangan

Garis garis, atau garis, adalah rentang horizontal atau vertikal yang menaungi latar belakang bagan dalam interval reguler atau kustom. Anda dapat menggunakan garis strip untuk:

  • Meningkatkan keterbacaan untuk mencari nilai individual pada bagan.

  • Pisahkan titik data saat membaca bagan.

  • Sorot tanggal yang terjadi secara berkala, misalnya, untuk mengidentifikasi titik data akhir pekan.

  • Sorot rentang kunci data tertentu.

  • Tambahkan baris ambang pada nilai konstanta tertentu.

Satu StripLine objek dapat digambar sekali, atau berulang kali, untuk interval tertentu. Tindakan ini dikendalikan oleh Interval properti . Ketika nilai -1 ditetapkan ke Interval properti , satu garis strip akan digambar. Saat nilai bukan nol ditetapkan ke Interval properti , garis strip akan digambar berulang kali pada setiap interval yang diberikan. Lokasi di mana garis strip digambar juga dipengaruhi oleh IntervalOffset properti dan IntervalOffsetType garis strip.

Garis garis selalu dikaitkan dengan Axis objek. Mereka dapat ditambahkan pada waktu desain dan durasi.

Untuk menambahkan garis horizontal atau vertikal untuk menampilkan ambang batas, atur StripWidth properti ke nilai 0,0. Ini akan mengakibatkan garis digambar. Anda dapat menggunakan BorderColorproperti , BorderDashStyle dan BorderWidth untuk warna, lebar, dan gaya garis. Tidak ada properti latar belakang bagan (Back*) yang digunakan saat StripWidth properti diatur ke 0,0.

Text Gunakan properti garis strip untuk mengaitkan teks dengan garis strip. Penempatan dan orientasi teks ini dapat dikontrol oleh TextAlignment properti .

Ketika beberapa garis strip didefinisikan untuk sumbu yang sama, ada kemungkinan bahwa garis strip akan tumpang tindih. Urutan StripLine Z objek ditentukan oleh urutan kemunculannya dalam StripLinesCollection objek . Ini berarti bahwa kejadian pertama digambar terlebih dahulu; kejadian kedua digambar kedua, dan sebagainya.

Garis garis tidak didukung untuk jenis bagan berikut: Pai, Donat, Corong, Piramida, Kagi, ThreeLineBreak, PointAndFigure, Polar dan Radar.

Konstruktor

StripLine()

Menginisialisasi instans baru kelas StripLine.

Properti

BackColor

Mendapatkan atau mengatur warna latar belakang garis strip.

BackGradientStyle

Mendapatkan atau mengatur gaya gradien garis strip.

BackHatchStyle

Mendapatkan atau mengatur gaya penetasan garis strip.

BackImage

Mendapatkan atau mengatur gambar latar belakang garis strip.

BackImageAlignment

Mendapatkan atau mengatur perataan gambar latar belakang.

BackImageTransparentColor

Mendapatkan atau mengatur warna gambar latar belakang garis strip yang akan diimplementasikan sebagai transparan.

BackImageWrapMode

Mendapatkan atau mengatur mode menggambar gambar latar belakang garis strip.

BackSecondaryColor

Mendapatkan atau mengatur warna sekunder dari latar belakang garis strip.

BorderColor

Mendapatkan atau mengatur warna batas garis garis.

BorderDashStyle

Mendapatkan atau mengatur gaya batas garis garis.

BorderWidth

Mendapatkan atau mengatur lebar batas garis strip.

Font

Mendapatkan atau mengatur font yang digunakan untuk teks baris strip.

ForeColor

Mendapatkan atau mengatur warna teks garis strip.

Interval

Mendapatkan atau mengatur interval untuk garis strip, dan menentukan apakah garis strip digambar sekali atau berulang kali.

IntervalOffset

Mendapatkan atau mengatur offset garis kisi, tanda centang, garis strip, dan label sumbu.

IntervalOffsetType

Mendapatkan atau mengatur jenis offset interval dari garis strip.

IntervalType

Mendapatkan atau mengatur jenis StripLine interval objek.

MapAreaAttributes

Mendapatkan atau mengatur atribut area peta dari garis strip.

Name

Mendapatkan nama garis strip.

PostBackValue

Mendapatkan atau mengatur nilai postback yang dapat diproses pada suatu Click peristiwa.

StripWidth

Mendapatkan atau mengatur lebar garis strip.

StripWidthType

Mendapatkan atau mengatur satuan pengukuran untuk StripWidth properti .

Tag

Mendapatkan atau mengatur objek yang terkait dengan elemen bagan ini.

(Diperoleh dari ChartElement)
Text

Mendapatkan atau mengatur teks untuk garis strip.

TextAlignment

Mendapatkan atau mengatur perataan teks garis.

TextLineAlignment

Mendapatkan atau mengatur perataan baris teks teks garis garis.

TextOrientation

Mendapatkan atau mengatur orientasi teks.

ToolTip

Mendapatkan atau mengatur tipsalat garis strip.

Url

Mendapatkan atau mengatur URL tujuan atau titik jangkar garis.

Metode

Dispose()

Merilis sumber daya yang digunakan oleh ChartElement.

(Diperoleh dari ChartElement)
Dispose(Boolean)

Merilis sumber daya tidak terkelola yang digunakan oleh StripLine dan secara opsional merilis sumber daya terkelola.

Equals(Object)

Menentukan apakah yang ditentukan Object sama dengan saat ini ChartElement.

(Diperoleh dari ChartElement)
GetHashCode()

Mengembalikan fungsi hash untuk jenis tertentu.

(Diperoleh dari ChartElement)
GetType()

Mendapatkan dari instans Type saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari saat ini Object.

(Diperoleh dari Object)
ToString()

Mengembalikan string yang mewakili saat ini Object.

(Diperoleh dari ChartElement)

Berlaku untuk