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