次の方法で共有


AxisScaleBreakStyle クラス

定義

グラフの Y 軸のスケール区切りを表します。

public ref class AxisScaleBreakStyle
public class AxisScaleBreakStyle
type AxisScaleBreakStyle = class
Public Class AxisScaleBreakStyle
継承
AxisScaleBreakStyle

次のコード例は、 Chart コントロールがデザインサーフェイスに追加された後にスケール区切りを有効にし、カスタマイズする方法を示しています。

Imports System.Web.UI.DataVisualization.Charting  

Private Function AddChartData()   

    chart1.Series("Default").Points.Add(New DataPoint(1, 2))   
    chart1.Series("Default").Points.Add(New DataPoint(2, 4))   
    chart1.Series("Default").Points.Add(New DataPoint(3, 400000))   
    chart1.Series("Default").Points.Add(New DataPoint(4, 3))   

End Sub  

Private Function AddScaleBreaks()  

   ' Enable scale breaks.  
   chart1.ChartAreas("Default").AxisY.ScaleBreakStyle.Enabled = True   

   ' Show scale break if more than 25% of the chart is empty space.       
   chart1.ChartAreas("Default").AxisY.ScaleBreakStyle.CollapsibleSpaceThreshold = 25   

   ' Set the line width of the scale break.      
   chart1.ChartAreas("Default").AxisY.ScaleBreakStyle.LineWidth = 2   

   ' Set the color of the scale break.   
   chart1.ChartAreas("Default").AxisY.ScaleBreakStyle.LineColor = Color.Red   

   ' If all data points are significantly far from zero, the chart will calculate the scale minimum value.   
   chart1.ChartAreas("Default").AxisY.ScaleBreakStyle.StartFromZero = StartFromZero.Auto  

   ' Set the spacing gap between the lines of the scale break (as a percentage of the Y-axis).  
   chart1.ChartAreas["Default"].AxisY.ScaleBreakStyle.Spacing = 2;  

End Function  
using System.Web.UI.DataVisualization.Charting  

private void AddChartData()  
{  
   chart1.Series["Series1"].Points.Add(new DataPoint(1, 2));  
   chart1.Series["Series1"].Points.Add(new DataPoint(2, 4));  
   chart1.Series["Series1"].Points.Add(new DataPoint(3, 400000));  
   chart1.Series["Series1"].Points.Add(new DataPoint(4, 3));  
}  

private void AddScaleBreaks()  
{  
   // Enable scale breaks.  
   chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.Enabled = true;  

   // Show scale break if more than 25% of the chart is empty space.  
   chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.CollapsibleSpaceThreshold = 25;  

   // Set the line width of the scale break.  
   chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.LineWidth = 2;  

   // Set the color of the scale break.  
   chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.LineColor = Color.Red;  

   // If all data points are significantly far from zero, the chart will calculate the scale minimum value.  
   chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.StartFromZero = StartFromZero.Auto;  

   // Set the spacing gap between the lines of the scale break (as a percentage of the Y-axis).  
    chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.Spacing = 2;  
}  

注釈

スケール区切りは、グラフ上の系列のデータポイントを再分布するために最も頻繁に使用される Y 軸上の意図的な不連続性です。 この機能により、1つの系列のデータの上限値と下限値の間に大きな違いがある場合に、読みやすさが向上します。 複数の系列のデータの違いについては、スケール区切りは描画されません。

既定では、スケール区切りは無効になっています。 Y 軸のスケール区切りを有効にするには、 Enabled プロパティをに設定し true ます。 スケール区切りの垂直方向の間隔を変更するには、値を指定し Spacing ます。 この値は、Y 軸のスケールに対する比率として計算されます。

スケール区切りを描画するには、1つの系列のデータポイントの範囲を十分に分離する必要があります。 既定では、スケール区切りを追加できるのは、データ範囲間の距離がグラフ全体の 25% 以上である場合のみです。 スケール区切りを有効にしても表示されない場合は、データ範囲間に十分な距離があるにもかかわらず、プロパティを25未満の CollapsibleSpaceThreshold 値に設定できます。

グラフごとに最大5つのスケール区切りをサポートします。ただし、複数のスケール区切りを表示すると、グラフが読みにくくなることがあります。 データ範囲が 3 つ以上ある場合は、別の方法でデータを表示することを検討してください。 MaxNumberOfBreaksグラフに表示できるスケール区切りの数を減らすには、プロパティを使用します。

スケール区切りを使用すると、Y 軸のラベルがオフセットになることがあります。 ラベルのオフセットを無効にするには、プロパティをに設定し IsStaggered false ます。

スケール区切りは、次のいずれかの条件ではサポートされていません。

  • 円グラフ、ドーナツグラフ、じょうごグラフ、ピラミッドグラフ、放射状グラフ、または積み上げグラフの種類が使用されます。

  • ラベル、目盛り、またはグリッド線のカスタム間隔が有効になります。

  • 軸の最小値または最大値が設定されます。

  • カスタムラベルが使用されます。

  • 対数 Y 軸が指定されています。

  • スクロールとズームを含む Y 軸の軸ビューが使用されます。

  • 3-d グラフが使用されます。

コンストラクター

AxisScaleBreakStyle()

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

プロパティ

BreakLineStyle

スケール区切りを描画するために使用される区切り線のスタイルを取得または設定します。

CollapsibleSpaceThreshold

スケール区切りが描画されるグラフ上の空間のしきい値を取得または設定します。

Enabled

スケール区切りが有効かどうかを示すフラグを取得または設定します。

LineColor

スケール区切り線の色を取得または設定します。

LineDashStyle

スケール区切り線のスタイルを取得または設定します。

LineWidth

スケール区切り線の幅を取得または設定します。

MaxNumberOfBreaks

グラフに表示されるスケール区切りの最大数を取得または設定します。

Spacing

スケール区切りの線間の間隔を取得または設定します。 間隔は Y 軸の割合として表されます。

StartFromZero

スケール区切りを 0 から開始するかどうかを示す StartFromZero 列挙値を取得または設定します。

メソッド

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

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

(継承元 Object)
MemberwiseClone()

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

(継承元 Object)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)

適用対象