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)