次の方法で共有


StripLine クラス

定義

グラフ上の背景の縞模様を表します。

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
継承
StripLine
実装

次のコード例は、ストリップ ラインの 3 つのアプリケーションを示しています。 最初に、水平ストリップラインは定期的に追加されます。 2 つ目は、週末のデータ ポイントを強調表示するために垂直ストリップラインが追加されます。 最後に、グラフの最初の系列のデータ ポイントの平均を示すために、非定期的なストリップ ラインが追加されます。

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

注釈

ストリップ線 (ストリップ) は、グラフの背景を通常またはユーザー設定の間隔で網掛けする水平または垂直の範囲です。 ストリップ ラインを使用すると、次のことが可能になります。

  • グラフ上の個々の値を調べるために見やすくする。

  • グラフの読み取り時にデータ ポイントを分離します。

  • 週末のデータ ポイントを識別するために、一定の間隔で発生する日付を強調表示します。

  • 特定のキー範囲のデータを強調表示します。

  • 特定の定数値にしきい値行を追加します。

1 つの StripLine オブジェクトは、一定の間隔で 1 回描画することも、繰り返し描画することもできます。 このアクションは、 プロパティによって Interval 制御されます。 プロパティに -1 の値が割り当てられる Interval と、1 つのストリップ ラインが描画されます。 プロパティに 0 以外の値が割り当てられると、指定した Interval 間隔ごとにストリップ ラインが繰り返し描画されます。 ストリップ ラインが描画される位置は、ストリップ ラインの プロパティと IntervalOffsetType プロパティの影響も受IntervalOffsetけます。

ストリップラインは常にオブジェクトに Axis 関連付けられます。 これらは、デザイン時と実行時の両方で追加できます。

水平線または垂直線を追加してしきい値を表示するには、 プロパティを StripWidth 0.0 の値に設定します。 これにより、線が描画されます。 線の色、BorderColor幅、スタイルBorderWidthには、 プロパティBorderDashStyleと プロパティを使用できます。 プロパティが 0.0 に設定されている場合、グラフのStripWidth背景プロパティ (Back*) は使用されません。

テキストを Text ストリップラインに関連付けるには、ストリップラインの プロパティを使用します。 このテキストの配置と向きは、 プロパティによって TextAlignment 制御できます。

同じ軸に対して複数のストリップラインが定義されている場合、ストリップラインが重複する可能性があります。 オブジェクトの StripLine Z オーダーは、オブジェクト内で StripLinesCollection 発生する順序によって決まります。 これは、最初の出現箇所が最初に描画されることを意味します。2 番目の出現箇所は 2 番目に描画され、次のように描画されます。

ストリップ ラインは、円グラフ、ドーナツ グラフ、じょうごグラフ、ピラミッド グラフ、Kagi グラフ、ThreeLineBreak グラフ、PointAndFigure グラフ、Polar グラフ、レーダー グラフではサポートされていません。

コンストラクター

StripLine()

StripLine クラスの新しいインスタンスを初期化します。

プロパティ

BackColor

背景の縞模様の背景色を取得または設定します。

BackGradientStyle

背景の縞模様のグラデーション スタイルを取得または設定します。

BackHatchStyle

背景の縞模様のハッチング スタイルを取得または設定します。

BackImage

背景の縞模様の背景イメージを取得または設定します。

BackImageAlignment

背景イメージの配置を取得または設定します。

BackImageTransparentColor

透明色として実装される背景の縞模様の背景イメージの色を取得または設定します。

BackImageWrapMode

背景の縞模様の背景イメージの描画モードを取得または設定します。

BackSecondaryColor

背景の縞模様の背景の 2 番目の色を取得または設定します。

BorderColor

背景の縞模様の境界線の色を取得または設定します。

BorderDashStyle

背景の縞模様の境界線スタイルを取得または設定します。

BorderWidth

背景の縞模様の境界線の幅を取得または設定します。

Font

背景の縞模様のテキストに使用されるフォントを取得または設定します。

ForeColor

背景の縞模様のテキストの色を取得または設定します。

Interval

背景の縞模様の間隔を取得または設定します。また、背景の縞模様を 1 回だけ描画するか、連続的に描画するかを決定します。

IntervalOffset

グリッド線、目盛り、背景の縞模様、および軸ラベルのオフセットを取得または設定します。

IntervalOffsetType

背景の縞模様の間隔のオフセットの種類を取得または設定します。

IntervalType

StripLine オブジェクトの間隔の種類を取得または設定します。

MapAreaAttributes

背景の縞模様のマップ領域属性を取得または設定します。

Name

背景の縞模様の名前を取得します。

PostBackValue

Click イベントで処理できるポストバック値を取得または設定します。

StripWidth

背景の縞模様の幅を取得または設定します。

StripWidthType

StripWidth プロパティの単位を取得または設定します。

Tag

このグラフ要素に関連付けられているオブジェクトを取得または設定します。

(継承元 ChartElement)
Text

背景の縞模様のテキストを取得または設定します。

TextAlignment

背景の縞模様のテキストの配置を取得または設定します。

TextLineAlignment

背景の縞模様のテキストのテキスト行の配置を取得または設定します。

TextOrientation

テキストの方向を取得または設定します。

ToolTip

背景の縞模様のツールヒントを取得または設定します。

Url

背景の縞模様の参照先 URL またはアンカー ポイントを取得または設定します。

メソッド

Dispose()

ChartElement で使用したリソースを解放します。

(継承元 ChartElement)
Dispose(Boolean)

StripLine によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。

Equals(Object)

指定した Object が現在の ChartElement と等しいかどうかを示します。

(継承元 ChartElement)
GetHashCode()

特定の型のハッシュ関数を返します。

(継承元 ChartElement)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
ToString()

現在の Object を表す文字列を返します。

(継承元 ChartElement)

適用対象