StripLine StripLine StripLine StripLine Class

Определение

Представляет полосковые линии диаграммы.Represents the strip lines on a chart.

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
Наследование
Реализации

Примеры

В следующем примере кода показаны три приложения полосковых линий.The following code example demonstrates three applications of strip lines. Во первых, горизонтальные полосковые линии добавляются через повторяющиеся интервалы.First, horizontal strip lines are added at recurring intervals. Во вторых, вертикальные полосковые линии добавляются для выделения точек данных выходных дней.Second, vertical strip lines are added to highlight weekend data points. Наконец, добавляется неповторяющаяся полосковая линия для обозначения среднего значения точек данных в первом ряду диаграммы.Lastly, a non-recurring strip line is added to denote the mean of the data points in the first series of the chart.

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

Комментарии

Полосковые линии (или полосы) — это горизонтальные или вертикальные диапазоны, которые закрашены фон диаграммы обычными или пользовательскими интервалами.Strip lines, or strips, are horizontal or vertical ranges that shade the background of a chart in regular or custom intervals. Полосковые линии можно использовать для:You can use strip lines to:

  • Улучшение удобочитаемости для поиска отдельных значений на диаграмме.Improve readability for looking up individual values on the chart.

  • Разделяйте точки данных при чтении диаграммы.Separate data points when reading the chart.

  • Выделяйте даты, которые выполняются с регулярными интервалами, например, для обозначения точек данных выходных дней.Highlight dates that occur at regular intervals, for example, to identify weekend data points.

  • Выделение определенного диапазона ключей данных.Highlight a specific key range of data.

  • Добавьте линию порога с указанным постоянным значением.Add a threshold line at a specific constant value.

Один StripLine объект может либо отображаться один или несколько раз для заданного интервала.A single StripLine object can either be drawn once, or repeatedly, for a given interval. Это действие управляется Interval свойством.This action is controlled by the Interval property. Если Interval свойству присвоено значение-1, будет выведена одна полосковая линия.When a value of -1 is assigned to the Interval property, one strip line will be drawn. Если Interval свойству присвоено ненулевое значение, полосковая линия будет нарисована повторно в каждом заданном интервале.When a non-zero value is assigned to the Interval property, a strip line will be drawn repeatedly at each given interval. Расположение полосковой линии также зависит IntervalOffset от свойств и IntervalOffsetType полосковой линии.The location where a strip line is drawn is also affected by the IntervalOffset and IntervalOffsetType properties of the strip line.

Полосковые линии всегда связаны с Axis объектом.Strip lines are always associated with an Axis object. Их можно добавить как во время разработки, так и во время выполнения.They can be added at both design time and run time.

Чтобы добавить горизонтальную или вертикальную линию для вывода порогового значения, StripWidth задайте для свойства значение 0,0.To add a horizontal or vertical line to display a threshold, set the StripWidth property to a value of 0.0. Это приведет к прорисовке линии.This will result in a line being drawn. Можно использовать BorderColorсвойства, BorderDashStyle и BorderWidth для цвета, ширины и стиля линии.You can use the BorderColor, BorderDashStyle and BorderWidth properties for the color, width and style of the line. Свойства фона диаграммы (Back*) не используются, StripWidth если свойство имеет значение 0,0.No chart background properties (Back*) are used when the StripWidth property is set to 0.0.

Text Используйте свойство полосковой линии, чтобы связать текст с полосковой линией.Use the Text property of the strip line to associate text with a strip line. Размещение и ориентация этого текста можно контролировать с помощью TextAlignment свойства.The placement and orientation of this text can be controlled by the TextAlignment property.

Если для одной и той же оси определено несколько полосковых линий, то возможно, что полосковые линии будут перекрываться.When multiple strip lines are defined for the same axis, it is possible that the strip lines will overlap. Z-порядок StripLine объектов определяется порядком их появления StripLinesCollection в объекте.The Z-order of StripLine objects is determined by their order of occurrence in the StripLinesCollection object. Это означает, что первое вхождение рисуется первыми; второе вхождение рисуется вторым и т. д.This means that the first occurrence is drawn first; the second occurrence is drawn second, and so on.

Полосковые линии не поддерживаются для следующих типов диаграмм: Круговые, кольцевые, воронки, пирамидальные, "каги", ThreeLineBreak, крестики, полярные и лепестковые.Strip lines are not supported for the following chart types: Pie, Doughnut, Funnel, Pyramid, Kagi, ThreeLineBreak, PointAndFigure, Polar and Radar.

Конструкторы

StripLine() StripLine() StripLine() StripLine()

Инициализирует новый экземпляр класса StripLine.Initializes a new instance of the StripLine class.

Свойства

BackColor BackColor BackColor BackColor

Получает или задает цвет фона полосковой линии.Gets or sets the background color of the strip line.

BackGradientStyle BackGradientStyle BackGradientStyle BackGradientStyle

Получает или задает стиль градиента полосковой линии.Gets or sets the gradient style of the strip line.

BackHatchStyle BackHatchStyle BackHatchStyle BackHatchStyle

Получает или задает стиль штриховки полосковой линии.Gets or sets the hatching style of the strip line.

BackImage BackImage BackImage BackImage

Получает или задает фоновое изображение полосковой линии.Gets or sets the background image of the strip line.

BackImageAlignment BackImageAlignment BackImageAlignment BackImageAlignment

Получает или задает тип выравнивания фонового изображения.Gets or sets the background image alignment.

BackImageTransparentColor BackImageTransparentColor BackImageTransparentColor BackImageTransparentColor

Получает или задает цвет фонового изображения полосковой линии, который будет заменен прозрачным.Gets or sets the color of a strip line background image that will be implemented as transparent.

BackImageWrapMode BackImageWrapMode BackImageWrapMode BackImageWrapMode

Получает или задает режим рисования для фонового изображения полосковой линии.Gets or sets the drawing mode of the background image of the strip line.

BackSecondaryColor BackSecondaryColor BackSecondaryColor BackSecondaryColor

Получает или задает вторичный цвет фона полосковой линии.Gets or sets the secondary color of the strip line background.

BorderColor BorderColor BorderColor BorderColor

Получает или задает цвет границы полосковой линии.Gets or sets the border color of a strip line.

BorderDashStyle BorderDashStyle BorderDashStyle BorderDashStyle

Получает или задает стиль границы полосковой линии.Gets or sets the border style of the strip line.

BorderWidth BorderWidth BorderWidth BorderWidth

Получает или задает ширину границы полосковой линии.Gets or sets the border width of the strip line.

Font Font Font Font

Получает или задает шрифт, используемый для текста полосковой линии.Gets or sets the font used for the strip line text.

ForeColor ForeColor ForeColor ForeColor

Получает или задает цвет текста полосковой линии.Gets or sets the color of the strip line text.

Interval Interval Interval Interval

Получает или задает интервал для полосковой линии и определяет, выводится ли полосковая линия один раз или несколько.Gets or sets the interval for a strip line, and determines if the strip line is drawn once or repeatedly.

IntervalOffset IntervalOffset IntervalOffset IntervalOffset

Получает или задает смещение линий сетки, делений, полосковых линий и подписей осей.Gets or sets the offset of grid lines, tick marks, strip lines and axis labels.

IntervalOffsetType IntervalOffsetType IntervalOffsetType IntervalOffsetType

Получает или задает тип смещения интервала полосковой линии.Gets or sets the interval offset type of the strip line.

IntervalType IntervalType IntervalType IntervalType

Получает или задает тип интервала объекта StripLine.Gets or sets the interval type of a StripLine object.

MapAreaAttributes MapAreaAttributes MapAreaAttributes MapAreaAttributes

Получает или задает атрибуты области карты полосковой линии.Gets or sets the map area attributes of the strip line.

Name Name Name Name

Получает имя полосковой линии.Gets the name of the strip line.

PostBackValue PostBackValue PostBackValue PostBackValue

Получает или задает значение обратной передачи, которое можно обработать при возникновении события Click.Gets or sets the postback value that can be processed on a Click event.

StripWidth StripWidth StripWidth StripWidth

Получает или задает ширину полосковой линии.Gets or sets the width of a strip line.

StripWidthType StripWidthType StripWidthType StripWidthType

Получает или задает единицу измерения свойства StripWidth.Gets or sets the unit of measurement for the StripWidth property.

Tag Tag Tag Tag

Получает или задает объект, связанный с данным элементом диаграммы.Gets or sets an object associated with this chart element.

(Inherited from ChartElement)
Text Text Text Text

Получает или задает текст полосковой линии.Gets or sets the text for the strip line.

TextAlignment TextAlignment TextAlignment TextAlignment

Получает или задает тип выравнивания текста полосковой линии.Gets or sets the text alignment of the strip line.

TextLineAlignment TextLineAlignment TextLineAlignment TextLineAlignment

Получает или задает тип выравнивания строки текста полосковой линии.Gets or sets the text line alignment of strip line text.

TextOrientation TextOrientation TextOrientation TextOrientation

Возвращает или задает ориентацию текста.Gets or sets the text orientation.

ToolTip ToolTip ToolTip ToolTip

Получает или задает подсказку полосковой линии.Gets or sets the tooltip of a strip line.

Url Url Url Url

Получает или задает URL-адрес назначения или точку привязки полосковой линии.Gets or sets the destination URL or anchor point of the strip line.

Методы

Dispose() Dispose() Dispose() Dispose()

Освобождает ресурсы, используемые объектом ChartElement.Releases the resources used by the ChartElement.

(Inherited from ChartElement)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом StripLine, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the StripLine and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли указанный объект Object текущему объекту ChartElement.Determines whether the specified Object is equal to the current ChartElement.

(Inherited from ChartElement)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Возвращает хэш-функцию для определенного типа.Returns a hash function for a particular type.

(Inherited from ChartElement)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, которая представляет текущий объект Object.Returns a string that represents the current Object.

(Inherited from ChartElement)

Применяется к