AxisScaleBreakStyle Класс

Определение

Пространство имен:

System.Web.UI.DataVisualization.Charting

Сборка:

System.Web.DataVisualization.dll

Представляет разрыв шкалы на оси Y диаграммы.

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, которые чаще всего используются для повторного распределения точек данных в ряде на диаграмме. Эта функция повышает удобочитаемость при наличии больших различий между высокими и низкими значениями данных в одном ряду. Разрывы шкалы не отображаются для различий между данными в нескольких рядах.

По умолчанию разрывы шкалы отключены. Можно включить разрывы шкалы на оси Y, задав Enabled свойству значение true . Чтобы изменить объем вертикального пространства разрыва шкалы, можно указать Spacing значение. Вычисляется в процентах от шкалы по оси Y.

Для рисования разрыва шкалы необходимо иметь достаточное разделение между диапазонами точек данных в одном ряду. По умолчанию, разрыв шкалы можно добавить только в случае, когда зазор между диапазонами составляет не менее 25% диаграммы. Если включить разрыв шкалы, но он не отображается, даже если между диапазонами данных имеется достаточное расстояние, можно задать CollapsibleSpaceThreshold для свойства значение меньше 25.

Диаграммы поддерживают до пяти разрывов шкалы на диаграмму; Однако диаграмма может стать нечитаемой, если отображается более одного разрыва шкалы. Если диапазонов больше двух, возможно, для вывода этих данных лучше подойдет другой метод. Используйте MaxNumberOfBreaks свойство, чтобы уменьшить количество разрывов шкалы, которые могут быть отображены на диаграмме.

При использовании разрыва шкалы Метки оси Y могут быть смещены. Чтобы отключить смещение метки, присвойте IsStaggered свойству значение false .

Разрывы шкалы не поддерживаются при выполнении следующих условий.

• Используются круговые, кольцевые, воронки, пирамидальные, радиальные или любые типы диаграмм с накоплением.

• Разрешены настраиваемые интервалы для меток, делений или линий сетки.

• Для оси задано минимальное или максимальное значение.

• Используются пользовательские метки.

• Указана логарифмическая ось Y.

• Используются представления осей на оси Y, которые включают прокрутку и масштаб.

• используются трехмерные диаграммы.

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

AxisScaleBreakStyle()

Инициализирует новый экземпляр класса AxisScaleBreakStyle.

Свойства

BreakLineStyle	Получает или задает стиль линии разрыва, которая будет использоваться для рисования разрыва шкалы.
CollapsibleSpaceThreshold	Получает или задает порог пространства диаграммы, при котором начинается рисование разрывов шкалы.
Enabled	Получает или задает флаг, указывающий, включены ли разрывы шкалы.
LineColor	Получает или задает цвет линии разрыва шкалы.
LineDashStyle	Получает или задает стиль линии разрыва шкалы.
LineWidth	Получает или задает толщину линии разрыва шкалы.
MaxNumberOfBreaks	Получает или задает максимальное число разрывов шкалы, отображаемых на диаграмме.
Spacing	Получает или задает величину интервала между линиями разрыва шкалы. Величина интервала представлена в виде процента от оси Y.
StartFromZero	Получает или задает значение перечисления StartFromZero, указывающее, должен ли разрыв шкала начинаться с нуля.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)