StripLine クラス

リファレンス

定義

名前空間:: System.Web.UI.DataVisualization.Charting

アセンブリ:: System.Web.DataVisualization.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

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

継承: Object

ChartElement
StripLine

実装: IChartMapArea

例

次のコード例は、ストリップラインの 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)

適用対象

StripLine クラス

定義

例

注釈

コンストラクター

プロパティ

メソッド

適用対象

フィードバック

その他のリソース