AxisScaleBreakStyle クラス

定義

public ref class AxisScaleBreakStyle

public class AxisScaleBreakStyle

type AxisScaleBreakStyle = class

Public Class AxisScaleBreakStyle

継承

Object

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 グラフが使用されます。

コンストラクター

プロパティ

メソッド

適用対象